Documentation ¶
Overview ¶
Package uniuri generates random strings good for use in URIs to identify unique objects.
Example usage:
s := util.UniUriNew() // s is now "apHCJBl7L1OmC57n"
A standard string created by New() is 16 bytes in length and consists of Latin upper and lowercase letters, and numbers (from the set of 62 allowed characters), which means that it has ~95 bits of entropy. To get more entropy, 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 to read from it.
Index ¶
- Constants
- Variables
- func BlockHandler() gin.HandlerFunc
- func Cipher(text string) string
- func CmdlineHandler() gin.HandlerFunc
- func Decipher(cryptoText string) []byte
- func GenerateSalt()
- func GoroutineHandler() gin.HandlerFunc
- func HeapHandler() gin.HandlerFunc
- func IndexHandler() gin.HandlerFunc
- func MutexHandler() gin.HandlerFunc
- func ProfileHandler() gin.HandlerFunc
- func SymbolHandler() gin.HandlerFunc
- func ThreadCreateHandler() gin.HandlerFunc
- func TraceHandler() gin.HandlerFunc
- func UniqueNew() string
- func UniqueNewLen(length int) string
- func UniqueNewLenChars(length int, chars []byte) string
- func Wrap(router *gin.Engine)
- func WrapGroup(router *gin.RouterGroup)
- type MongoDBConfig
- type Pagination
- type QueryParser
- func (p *QueryParser) Contains(fields []string, query bson.M) bson.M
- func (p *QueryParser) Endswith(fields []string, query bson.M) bson.M
- func (p *QueryParser) Eq(fields []string, query bson.M) bson.M
- func (p *QueryParser) Exact(fields []string, query bson.M) bson.M
- func (p *QueryParser) Gt(fields []string, query bson.M) bson.M
- func (p *QueryParser) Gte(fields []string, query bson.M) bson.M
- func (p *QueryParser) IContains(s []string, query bson.M) bson.M
- func (p *QueryParser) IEndswith(s []string, query bson.M) bson.M
- func (p *QueryParser) IExact(s []string, query bson.M) bson.M
- func (p *QueryParser) IStartswith(s []string, query bson.M) bson.M
- func (p *QueryParser) In(fields []string, query bson.M) bson.M
- func (p *QueryParser) IsNull(fields []string, query bson.M) bson.M
- func (p *QueryParser) Lookups(fields []string, query bson.M) bson.M
- func (p *QueryParser) Lt(fields []string, query bson.M) bson.M
- func (p *QueryParser) Lte(fields []string, query bson.M) bson.M
- func (p *QueryParser) Match(s []string, query bson.M) bson.M
- func (p *QueryParser) Ne(fields []string, query bson.M) bson.M
- func (p *QueryParser) OrderBy() string
- func (p *QueryParser) Startswith(fields []string, query bson.M) bson.M
- type RedisConfig
Constants ¶
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 )
Variables ¶
var ( DefaultLimit = int(10) MinLimit = int(1) MaxLimit = int(500) LimitParam = "page_size" DefaultPage = int(1) PageParam = "page" )
var Config *configType
var InteractiveSetup bool
var ( // OrderParam is the key of the url // order parameter OrderParam = "order_by" )
var Secrets bool
var StdChars = []byte("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789")
StdChars is a set of standard characters allowed in uniuri string.
var Version = "0.5.6"
Version is the current Tensor Version This must update with the VERSION file in the SCM root directory
var Wrapper = Wrap
Wrapper make sure we are backward compatible
Functions ¶
func BlockHandler ¶ added in v0.4.0
func BlockHandler() gin.HandlerFunc
BlockHandler will pass the call from /debug/pprof/block to pprof
func CmdlineHandler ¶ added in v0.4.0
func CmdlineHandler() gin.HandlerFunc
CmdlineHandler will pass the call from /debug/pprof/cmdline to pprof
func GenerateSalt ¶ added in v0.0.12
func GenerateSalt()
func GoroutineHandler ¶ added in v0.4.0
func GoroutineHandler() gin.HandlerFunc
GoroutineHandler will pass the call from /debug/pprof/goroutine to pprof
func HeapHandler ¶ added in v0.4.0
func HeapHandler() gin.HandlerFunc
HeapHandler will pass the call from /debug/pprof/heap to pprof
func IndexHandler ¶ added in v0.4.0
func IndexHandler() gin.HandlerFunc
IndexHandler will pass the call from /debug/pprof to pprof
func MutexHandler ¶ added in v0.5.2
func MutexHandler() gin.HandlerFunc
MutexHandler will pass the call from /debug/pprof/mutex to pprof
func ProfileHandler ¶ added in v0.4.0
func ProfileHandler() gin.HandlerFunc
ProfileHandler will pass the call from /debug/pprof/profile to pprof
func SymbolHandler ¶ added in v0.4.0
func SymbolHandler() gin.HandlerFunc
SymbolHandler will pass the call from /debug/pprof/symbol to pprof
func ThreadCreateHandler ¶ added in v0.4.0
func ThreadCreateHandler() gin.HandlerFunc
ThreadCreateHandler will pass the call from /debug/pprof/threadcreate to pprof
func TraceHandler ¶ added in v0.4.0
func TraceHandler() gin.HandlerFunc
TraceHandler will pass the call from /debug/pprof/trace to pprof
func UniqueNew ¶ added in v0.0.5
func UniqueNew() string
New returns a new random string of the standard length, consisting of standard characters.
func UniqueNewLen ¶ added in v0.0.5
NewLen returns a new random string of the provided length, consisting of standard characters.
func UniqueNewLenChars ¶ added in v0.0.5
NewLenChars returns a new random string of the provided length, consisting of the provided byte slice of allowed characters (maximum 256).
Types ¶
type MongoDBConfig ¶
type Pagination ¶
type Pagination struct {
// contains filtered or unexported fields
}
func NewPagination ¶
func NewPagination(c *gin.Context, n int) *Pagination
func (*Pagination) HasPage ¶
func (p *Pagination) HasPage() bool
func (*Pagination) Limit ¶
func (p *Pagination) Limit() int
func (*Pagination) NextPage ¶
func (p *Pagination) NextPage() interface{}
func (*Pagination) Offset ¶
func (p *Pagination) Offset() int
func (*Pagination) Page ¶
func (p *Pagination) Page() int
func (*Pagination) PreviousPage ¶
func (p *Pagination) PreviousPage() interface{}
type QueryParser ¶
QueryParser used to store the context and gin request form
func NewQueryParser ¶
func NewQueryParser(c *gin.Context) QueryParser
NewQueryParser initialize a new QueryParser
func (*QueryParser) Contains ¶ added in v0.0.4
Contains adds regex to mgo query to check a field contain a value accepting fields must pass to fields parameter
func (*QueryParser) Endswith ¶ added in v0.0.4
Endswith adds regex to mgo query to check a field endswith a value accepting fields must pass to fields parameter
func (*QueryParser) Eq ¶ added in v0.0.4
Eq check the given field or related object is equel to given value
func (*QueryParser) Exact ¶ added in v0.0.4
Exact adds regex to mgo query to check a field is an exact match accepting fields must pass to fields parameter
func (*QueryParser) Gt ¶ added in v0.0.4
Gt adds $gt to mgo query to check a field greater than the comparison value accepting fields must pass to fields parameter
func (*QueryParser) Gte ¶ added in v0.0.4
Gte adds $gte to mgo query to check a field greater or equal to the comparison value accepting fields must pass to fields parameter
func (*QueryParser) IContains ¶
IContains adds regex to mgo query to check a field contain a value this is the case insensitive version of contains accepting fields must pass to fields parameter
func (*QueryParser) IEndswith ¶ added in v0.0.4
IEndswith adds regex to mgo query to check a field endswith a value this is the case insensitive version of endswith accepting fields must pass to fields parameter
func (*QueryParser) IExact ¶ added in v0.0.4
IExact adds regex to mgo query to check a field is an exact match this is the case insensitive version of Exact accepting fields must pass to fields parameter
func (*QueryParser) IStartswith ¶ added in v0.0.4
IStartswith adds regex to mgo query to check a field startswith a value this is the case insensitive version of startswith accepting fields must pass to fields parameter
func (*QueryParser) In ¶ added in v0.0.4
In Check the given field's value is present in the list provide accepting fields must pass to fields parameter
func (*QueryParser) Lt ¶ added in v0.0.4
Lt adds $lt to mgo query to check a field less than the comparison value accepting fields must pass to fields parameter
func (*QueryParser) Lte ¶ added in v0.0.4
Lte adds $lte to mgo query to check a field less than or equal to the comparison value accepting fields must pass to fields parameter
func (*QueryParser) Ne ¶ added in v0.0.4
Ne check the given field or related object is not equal to given value
func (*QueryParser) OrderBy ¶
func (p *QueryParser) OrderBy() string
OrderBy appends order_by clause to mongodb query
func (*QueryParser) Startswith ¶ added in v0.0.4
Startswith adds regex to mgo query to check a field startswith a value accepting fields must pass to fields parameter
type RedisConfig ¶ added in v0.2.0
type RedisConfig struct {
Host string `yaml:"host"`
}