rndstr

README

Simple random string generator

This allows generating random strings very easily.

	fmt.Printf("Random string: %s\n", rndstr.Simple(16, rndstr.Alnum))

	// or to generate a secure string, using crypto/rand
	secureStr := rndstr.SimpleReader(16, rndstr.Alnum, rand.Reader)

Documentation

Index

• Constants
• func Simple(l int, rng string) string
• func SimpleFastReader(l int, rng string, src io.Reader) (string, error)
• func SimpleReader(l int, rng string, src io.Reader) (string, error)

Constants

const (
	Alpha    = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"
	Alnum    = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
	Code     = "ABCDEFGHJKLMNPRSTUVWXYZ23456789"
	Password = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789&~#([-|_^@)]{}$*,?;.:/!<>"
)

Functions

func Simple

func Simple(l int, rng string) string

Simple is a simple generator using a given len and range. Example use: rndstr.Simple(10, rndstr.Alnum)

func SimpleFastReader

func SimpleFastReader(l int, rng string, src io.Reader) (string, error)

SimpleFastReader can be used with a random source, such as crypto/rand

Unsafe for secure operations but fast.

Usage: rndstr.SimpleFastReader(10, rndstr.Alnum, rand.Reader)

func SimpleReader

func SimpleReader(l int, rng string, src io.Reader) (string, error)

SimpleReader can be used with a random source, such as crypto/rand

This is fairly slow and will consume at least 4 bytes of random input per generated character. This is however secure and follows best practices in random number generation.

Usage: rndstr.SimpleReader(10, rndstr.Alnum, rand.Reader)