testrand

Documentation

Overview

Package testrand implements generating random base types for testing.

Index

• func BucketName() string
• func Bytes(size memory.Size) []byte
• func BytesInt(size int) []byte
• func Float64n(n int64) float64
• func Int63n(n int64) int64
• func Intn(n int) int
• func Key() storj.Key
• func Metadata() map[string]string
• func NodeID() storj.NodeID
• func Nonce() storj.Nonce
• func Path() string
• func PieceID() storj.PieceID
• func RandAlphaNumeric(length int) []byte
• func RandNumeric(length int) []byte
• func Read(data []byte)
• func Reader() io.Reader
• func SegmentID(size int) storj.SegmentID
• func SerialNumber() storj.SerialNumber
• func StreamID(size int) storj.StreamID
• func URLPath() string
• func URLPathNonFolder() string
• func UUID() uuid.UUID

Functions

func BucketName

func BucketName() string

BucketName creates a random bucket name mostly confirming to the restrictions of S3: https://docs.aws.amazon.com/AmazonS3/latest/dev/BucketRestrictions.html

NOTE: This may not generate values that cover all valid values (for Storj or S3). This is a best effort to cover most cases we believe our design requires and will need to be revisited when a more explicit design spec is created.

func Bytes

func Bytes(size memory.Size) []byte

Bytes generates size amount of random data.

func BytesInt

func BytesInt(size int) []byte

BytesInt generates size amount of random data.

func Float64n

func Float64n(n int64) float64

Float64n returns floating point pseudo-random number in [-n,0] || [0,n] based on the sign of the input.

func Int63n

func Int63n(n int64) int64

Int63n returns, as an int64, a non-negative pseudo-random number in [0,n) from the default Source. It panics if n <= 0.

func Intn

func Intn(n int) int

Intn returns, as an int, a non-negative pseudo-random number in [0,n) from the default Source. It panics if n <= 0.

func Key

func Key() storj.Key

Key creates a random test key.

func Metadata

func Metadata() map[string]string

Metadata creates random metadata mostly conforming to the restrictions of S3: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#object-metadata

NOTE: This may not generate values that cover all valid values (for Storj or S3). This is a best effort to cover most cases we believe our design requires and will need to be revisited when a more explicit design spec is created.

func NodeID

func NodeID() storj.NodeID

NodeID creates a random node id.

func Nonce

func Nonce() storj.Nonce

Nonce creates a random test nonce.

func Path

func Path() string

Path creates a random path that Storj should support.

func PieceID

func PieceID() storj.PieceID

PieceID creates a random piece id.

func RandAlphaNumeric

func RandAlphaNumeric(length int) []byte

RandAlphaNumeric creates a random byte slice of given length composed of ASCII numbers and letters.

func RandNumeric

func RandNumeric(length int) []byte

RandNumeric creates a random byte slice of given length composed of ASCII numbers.

func Read

func Read(data []byte)

Read reads pseudo-random data into data.

func Reader

func Reader() io.Reader

Reader creates a new random data reader.

func SegmentID

func SegmentID(size int) storj.SegmentID

SegmentID creates a random segment ID.

func SerialNumber

func SerialNumber() storj.SerialNumber

SerialNumber creates a random serial number.

func StreamID

func StreamID(size int) storj.StreamID

StreamID creates a random stream ID.

func URLPath

func URLPath() string

URLPath creates a clean random url path.

func URLPathNonFolder

func URLPathNonFolder() string

URLPathNonFolder creates a clean random url path that is not a folder.

func UUID

func UUID() uuid.UUID

UUID creates a random uuid.