randomex

README

randomex

randomex implements a couple of random string generation functions used mostly for testing and is a repackage of the only useful part of a package I did back when learning golang, now with added module support.

Additional functionality might be added later.

installation

go get "github.com/vedranvuk/randomex"

Documentation

Index

• Constants
• func Rand(length int) string
• func String(lo, up, nums, special bool, length int) string
• func StringLower() string
• func StringLowers(length int) string
• func StringNum() string
• func StringNums(length int) string
• func StringOf(length int, funcs ...func() string) string
• func StringSet(set string) string
• func StringSpecial() string
• func StringSpecials(length int) string
• func StringUpper() string
• func StringUppers(length int) string

Constants

const (

	// PasswordSet is a common special character set used in passwords.
	// < and > may cause issues on some systems.
	PasswordSet = " !\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~"
)

Functions

func Rand

func Rand(length int) string

Rand is a shorthand for Random which includes all characters.

func String

func String(lo, up, nums, special bool, length int) string

String returns a random string of "length". If "lo" includes lowercase letters. If "up" includes uppercase letters. If "num" includes numbers. If "special" includes password special characters.

func StringLower

func StringLower() string

StringLower returns a string containing a random lowercase letter.

func StringLowers

func StringLowers(length int) string

StringLowers returns a string of random lowercase letters of "length".

func StringNum

func StringNum() string

StringNum returns a string containing a single digit random number.

func StringNums

func StringNums(length int) string

StringNums returns a string of random numbers of "length".

func StringOf

func StringOf(length int, funcs ...func() string) string

StringOf takes any number of functins returning a string and calls them randomly until resulting string is of specified length.

func StringSet

func StringSet(set string) string

StringSet returns a single random character from the specified set.

func StringSpecial

func StringSpecial() string

StringSpecial returns a string containing a random password special character.

func StringSpecials

func StringSpecials(length int) string

StringSpecials returns a string of random special characters of "length".

func StringUpper

func StringUpper() string

StringUpper returns a string containing a random uppercase letter.

func StringUppers

func StringUppers(length int) string

StringUppers returns a string of random uppercase letters of "length".