Repository files navigation

import"github.com/dchest/uniuri"

Package uniuri generates random strings good for use in URIs to identifyunique objects.

Example usage:

s:=uniuri.New()// s is now "apHCJBl7L1OmC57n"

A standard string created by New() is 16 bytes in length and consists ofLatin upper and lowercase letters, and numbers (from the set of 62 allowedcharacters), which means that it has ~95 bits of entropy. To get moreentropy, you can use NewLen(UUIDLen), which returns 20-byte string, giving~119 bits of entropy, or any other desired length.

Functions read from crypto/rand random source, and panic if they fail toread from it.

const (// StdLen is a standard length of uniuri string to achive ~95 bits of entropy.StdLen=16// UUIDLen is a length of uniuri string to achive ~119 bits of entropy, closest// to what can be losslessly converted to UUIDv4 (122 bits).UUIDLen=20)

varStdChars= []byte("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789")

StdChars is a set of standard characters allowed in uniuri string.

funcNew()string

New returns a new random string of the standard length, consisting ofstandard characters.

funcNewLen(lengthint)string

NewLen returns a new random string of the provided length, consisting ofstandard characters.

funcNewLenChars(lengthint,chars []byte)string

NewLenChars returns a new random string of the provided length, consistingof the provided byte slice of allowed characters (maximum 256).

Written in 2011-2014 by Dmitry Chestnykh

The author(s) have dedicated all copyright and related andneighboring rights to this software to the public domainworldwide. Distributed without any warranty.http://creativecommons.org/publicdomain/zero/1.0/