util

package
v0.6.9 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Mar 8, 2026 License: MIT Imports: 48 Imported by: 1

Documentation

Overview

Code generated from files in client/src/svg. See https://projectforge.dev for details. DO NOT EDIT.

Index

Constants

View Source 
const (
	BoolTrue  = "true"
	BoolFalse = "false"
)
View Source 
const (
	AppKey     = "admini"
	AppName    = "Admini"
	AppSummary = "Use Admini to explore and manage your data as fast and easily as possible"
	AppPort    = 14000
	AppCmd     = AppKey
	AppContact = "Kyle U "
	AppURL     = "https://admini.dev"
	AppSource  = "https://github.com/kyleu/admini"
	AppLegal   = `Built by Kyle U, all rights reserved`

	KeyOK       = "ok"
	KeySuccess  = "success"
	KeyError    = "error"
	KeyDebug    = "debug"
	KeyStart    = "start"
	KeyRandom   = "random"
	KeyUnknown  = "unknown"
	KeyEllipsis = "…"

	KeyCSV  = "csv"
	KeyJSON = "json"
	KeyTOML = "toml"
	KeyXML  = "xml"
	KeyYAML = "yaml"

	ExtJSON     = ".json"
	ExtMarkdown = ".md"

	DatabaseMySQL      = "mysql"
	DatabasePostgreSQL = "postgres"
	DatabaseSQLite     = "sqlite"
	DatabaseSQLServer  = "sqlserver"
)
View Source 
const KeyMap = "map"
View Source 
const UUIDRegex = `[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}`

Variables

View Source 
var (
	DEBUG     = false
	ConfigDir = "."
)
View Source 
var EmptyStruct = struct{}{}
View Source 
var HTTPDefaultClient = http.DefaultClient
View Source 
var SVGIconKeys = []string{"android", "app", "apple", "archive", "backward", "bell", "bolt", "bookmark", "calendar", "camera", "cart", "check", "clock", "code", "cog", "comment", "compass", "database", "desktop", "dna", "dot", "down", "download", "edit", "error", "export", "external", "eye", "file", "file-text", "filter", "fingerprint", "fire", "flag", "folder", "folder-open", "forward", "gift", "github", "graph", "grid", "handle", "happy", "hashtag", "heart", "image", "import", "info", "left", "link", "linux", "list", "location", "lock", "mail", "mail-open", "medal", "meh", "microphone", "minus", "mobile", "pencil", "play", "plus", "poo", "print", "profile", "question", "refresh", "reply", "right", "robot", "sad", "searchbox", "server", "settings", "share", "social", "sort", "star", "struct", "tag", "thumbs-down", "thumbs-up", "times", "tools", "trash", "trophy", "unlock", "up", "upload", "users", "warning", "windows", "world", "wrench"}
View Source 
var SVGLibrary = map[string]string{
	"android":     ``,
	"app":         ``,
	"apple":       ``,
	"archive":     ``,
	"backward":    ``,
	"bell":        ``,
	"bolt":        ``,
	"bookmark":    ``,
	"calendar":    ``,
	"camera":      ``,
	"cart":        ``,
	"check":       ``,
	"clock":       ``,
	"code":        ``,
	"cog":         ``,
	"comment":     ``,
	"compass":     ``,
	"database":    ``,
	"desktop":     ``,
	"dna":         ``,
	"dot":         ``,
	"down":        ``,
	"download":    ``,
	"edit":        ``,
	"error":       ``,
	"export":      ``,
	"external":    ``,
	"eye":         ``,
	"file":        ``,
	"file-text":   ``,
	"filter":      ``,
	"fingerprint": ``,
	"fire":        ``,
	"flag":        ``,
	"folder":      ``,
	"folder-open": ``,
	"forward":     ``,
	"gift":        ``,
	"github":      ``,
	"graph":       ``,
	"grid":        ``,
	"handle":      ``,
	"happy":       ``,
	"hashtag":     ``,
	"heart":       ``,
	"image":       ``,
	"import":      ``,
	"info":        ``,
	"left":        ``,
	"link":        ``,
	"linux":       ``,
	"list":        ``,
	"location":    ``,
	"lock":        ``,
	"mail":        ``,
	"mail-open":   ``,
	"medal":       ``,
	"meh":         ``,
	"microphone":  ``,
	"minus":       ``,
	"mobile":      ``,
	"pencil":      ``,
	"play":        ``,
	"plus":        ``,
	"poo":         ``,
	"print":       ``,
	"profile":     ``,
	"question":    ``,
	"refresh":     ``,
	"reply":       ``,
	"right":       ``,
	"robot":       ``,
	"sad":         ``,
	"search":      ``,
	"searchbox":   ``,
	"server":      ``,
	"settings":    ``,
	"share":       ``,
	"social":      ``,
	"sort":        ``,
	"star":        ``,
	"struct":      ``,
	"tag":         ``,
	"thumbs-down": ``,
	"thumbs-up":   ``,
	"times":       ``,
	"tools":       ``,
	"trash":       ``,
	"trophy":      ``,
	"unlock":      ``,
	"up":          ``,
	"upload":      ``,
	"users":       ``,
	"warning":     ``,
	"windows":     ``,
	"world":       ``,
	"wrench":      ``,
}
View Source 
var StringDefaultLinebreak = func() string {
	if runtime.GOOS == "windows" {
		return winLB
	}
	return saneLB
}()
View Source 
var UUIDDefault = uuid.UUID{}

Functions

func Acronym added in v0.6.8 

func Acronym(s string) string

func ArrayCopy added in v0.5.12 

func ArrayCopy[S ~[]T, T any](x S) S

func ArrayDereference added in v0.2.12 

func ArrayDereference[T any](x []*T) []T

func ArrayFindDuplicates added in v0.6.1 

func ArrayFindDuplicates[T comparable](items []T) []T

func ArrayFirstN added in v0.2.12 

func ArrayFirstN[S ~[]T, T any](items S, n int) S

func ArrayFlatten added in v0.2.12 

func ArrayFlatten[S ~[]T, T any](arrs ...S) S

func ArrayFromAny added in v0.2.3 

func ArrayFromAny[T any](dest any) ([]T, error)

func ArrayFromAnyOK added in v0.6.6 

func ArrayFromAnyOK[T any](dest any) []T

func ArrayLastN added in v0.2.12 

func ArrayLastN[S ~[]T, T any](items S, n int) S

func ArrayLimit added in v0.4.13 

func ArrayLimit[S ~[]T, T any](x S, limit int) (S, int)

func ArrayRemoveDuplicates added in v0.2.4 

func ArrayRemoveDuplicates[T comparable](x []T) []T

func ArrayRemoveEmpty added in v0.4.30 

func ArrayRemoveEmpty[T comparable](x []T) []T

func ArrayRemoveNil added in v0.2.12 

func ArrayRemoveNil[T any](x []*T) []*T

func ArrayReplaceOrAdd added in v0.4.36 

func ArrayReplaceOrAdd[S ~[]T, T any](a S, fn func(el T) bool, x T) S

func ArraySorted added in v0.2.12 

func ArraySorted[T cmp.Ordered](x []T) []T

func ArraySplit added in v0.4.10 

func ArraySplit[S ~[]T, T any](xs S, fn func(T) bool) (S, S)

func ArrayTest added in v0.4.4 

func ArrayTest(dest any) bool

func ArrayToAnyArray added in v0.6.6 

func ArrayToAnyArray[T any](x []T) []any

func ArrayToStringArray added in v0.3.9 

func ArrayToStringArray[T any](a []T) []string

func ArrayTransform added in v0.3.8 

func ArrayTransform[T any, U any](x []T, f func(T) U) []U

func AsyncCollect added in v0.2.1 

func AsyncCollect[T any, R any](items []T, f func(x T) (R, error), loggers ...Logger) ([]R, []error)

func AsyncCollectMap added in v0.2.12 

func AsyncCollectMap[T any, K comparable, R any](items []T, k func(x T) K, f func(x T) (R, error), loggers ...Logger) (map[K]R, map[K]error)

func AsyncRateLimit added in v0.2.11 

func AsyncRateLimit[T any, R any](key string, items []T, f func(x T) (R, error), maxConcurrent int, timeout time.Duration, loggers ...Logger) ([]R, []error)

func ByteSizeIEC added in v0.2.14 

func ByteSizeIEC(b int64) string

func ByteSizeSI added in v0.2.14 

func ByteSizeSI(b int64) string

func Cast added in v0.5.2 

func Cast[T any](v any) (T, error)

func CastOK added in v0.5.2 

func CastOK[T any](v any, loggers ...Logger) T

func Choose added in v0.4.0 

func Choose[T any](b bool, ifTrue T, ifFalse T) T

func ConfigureAcronym added in v0.4.10 

func ConfigureAcronym(key, val string)

func CountryFlag added in v0.2.11 

func CountryFlag(code string) string

func CycleJSON 

func CycleJSON(src any, tgt any) error

func CycleXML added in v0.4.0 

func CycleXML(src any, tgt any) error

func DebugBuildInfo added in v0.2.18 

func DebugBuildInfo() *debug.BuildInfo

func DebugMemStats added in v0.2.18 

func DebugMemStats() *runtime.MemStats

func DebugStartCPUProfile added in v0.2.18 

func DebugStartCPUProfile() error

func DebugTakeHeapProfile added in v0.2.18 

func DebugTakeHeapProfile() error

func DecodeBytes added in v0.5.23 

func DecodeBytes(s string) ([]byte, error)

func DecodeUTF8 added in v0.4.40 

func DecodeUTF8(input []byte) (string, error)

func DecryptBytes added in v0.5.23 

func DecryptBytes(key []byte, b []byte, logger Logger) ([]byte, error)

func DecryptMessage 

func DecryptMessage(key []byte, message string, logger Logger) (string, error)

func DefaultIfNil added in v0.2.12 

func DefaultIfNil[T any](ptr *T, d T) T

func DefaultValue added in v0.4.10 

func DefaultValue[T any]() T

func EncodeBytes added in v0.5.23 

func EncodeBytes(b []byte) string

func EncryptBytes added in v0.5.23 

func EncryptBytes(key []byte, b []byte, logger Logger) ([]byte, error)

func EncryptMessage 

func EncryptMessage(key []byte, message string, logger Logger) (string, error)

func ErrorMerge added in v0.2.5 

func ErrorMerge(errs ...error) error

func Filename added in v0.3.8 

func Filename(s string) string

func FormatMilliseconds added in v0.6.3 

func FormatMilliseconds(x float64, includeFraction bool) string

func FormatSeconds added in v0.4.4 

func FormatSeconds(x float64) string

func FormatSecondsFull added in v0.4.4 

func FormatSecondsFull(x float64) string

func FromJSON 

func FromJSON(msg []byte, tgt any) error

func FromJSONAny added in v0.4.0 

func FromJSONAny(msg []byte) (any, error)

func FromJSONAnyOK added in v0.4.26 

func FromJSONAnyOK(msg []byte) any

func FromJSONBytesArray added in v0.6.6 

func FromJSONBytesArray[T any](vs ...jsontext.Value) ([]T, error)

func FromJSONBytesMap added in v0.6.6 

func FromJSONBytesMap[T any](m map[string]jsontext.Value) (map[string]T, error)

func FromJSONObj added in v0.4.4 

func FromJSONObj[T any](msg []byte) (T, error)

func FromJSONReader 

func FromJSONReader(r io.Reader, tgt any, opts ...json.Options) error

func FromJSONStrict 

func FromJSONStrict(msg []byte, tgt any) error

func FromJSONString added in v0.2.27 

func FromJSONString(msg []byte) (string, error)

func FromTOML added in v0.4.4 

func FromTOML(msg []byte, tgt any) error

func FromTOMLAny added in v0.4.4 

func FromTOMLAny(msg []byte) (any, error)

func FromTOMLReader added in v0.4.4 

func FromTOMLReader(r io.Reader, tgt any) error

func FromTOMLStrict added in v0.4.4 

func FromTOMLStrict(msg []byte, tgt any) error

func FromTOMLString added in v0.4.4 

func FromTOMLString(msg []byte) (string, error)

func FromXML added in v0.4.0 

func FromXML(msg []byte, tgt any) error

func FromXMLAny added in v0.4.0 

func FromXMLAny(msg []byte) (any, error)

func FromXMLReader added in v0.4.0 

func FromXMLReader(r io.Reader, tgt any) error

func FromXMLStrict added in v0.4.0 

func FromXMLStrict(msg []byte, tgt any) error

func FromXMLString added in v0.4.0 

func FromXMLString(msg []byte) (string, error)

func GetEnv added in v0.1.42 

func GetEnv(name string, defaultValue ...string) string

func GetEnvBool added in v0.2.1 

func GetEnvBool(name string, defaultValue bool) bool

func GetEnvBoolAny added in v0.6.8 

func GetEnvBoolAny(defaultValue bool, names ...string) bool

func GetEnvDuration added in v0.2.5 

func GetEnvDuration(name string, defaultValue time.Duration) time.Duration

func GetEnvInt added in v0.2.5 

func GetEnvInt(name string, defaultValue int) int

func HashFNV32 

func HashFNV32(s string) uint32

func HashFNV128UUID added in v0.3.10 

func HashFNV128UUID(s string) uuid.UUID

func HashSHA256 

func HashSHA256(s string) string

HashSHA256 returns a Base64-encoded string representing the SHA-256 hash of the argument.

func InitAcronyms added in v0.3.8 

func InitAcronyms(extras ...string) error

func IsNil added in v0.6.6 

func IsNil(x any) bool

func JSONToMap 

func JSONToMap(i any) map[string]any

func JoinLines added in v0.6.8 

func JoinLines(ss []string, delim string, maxLen int) []string

func JoinLinesFull added in v0.6.8 

func JoinLinesFull(ss []string, delim string, maxLen int, prefix string, indent string, suffix string) string

func LengthAny added in v0.2.3 

func LengthAny(dest any) int

func MapClone added in v0.6.6 

func MapClone[K comparable, V any](m map[K]V) map[K]V

func MapError added in v0.3.9 

func MapError[T any, U any](xa []T, f func(el T, idx int) (U, error)) ([]U, error)

func MapGetOrElse added in v0.4.8 

func MapGetOrElse[K comparable, V any](mp map[K]V, k K, dflt V) V

func MapKeys added in v0.5.0 

func MapKeys[K comparable, V any](m map[K]V) []K

func MapKeysSorted added in v0.5.0 

func MapKeysSorted[K cmp.Ordered, V any](m map[K]V) []K

func MapUpdateKeys added in v0.6.6 

func MapUpdateKeys[K cmp.Ordered, V any, NK cmp.Ordered](m map[K]V, fn func(k K, v V) NK) map[NK]V

func MapUpdateValues added in v0.6.6 

func MapUpdateValues[K comparable, V any, NV any](m map[K]V, fn func(k K, v V) (NV, error)) (map[K]NV, error)

func MarkdownTable added in v0.4.0 

func MarkdownTable(header []string, rows [][]string, linebreak string) (string, error)

func MarkdownTableParse added in v0.4.0 

func MarkdownTableParse(md string) ([]string, [][]string)

func MicrosToMillis 

func MicrosToMillis(i int) string

func MillisToString added in v0.6.3 

func MillisToString(i int) string

func OrDefault added in v0.4.10 

func OrDefault[T comparable](x T, dflt T) T

func ParseArray added in v0.4.8 

func ParseArray(r any, path string, allowEmpty bool, coerce bool) ([]any, error)

func ParseArrayFloat added in v0.4.8 

func ParseArrayFloat(r any, path string, allowEmpty bool) ([]float64, error)

func ParseArrayInt added in v0.4.8 

func ParseArrayInt(r any, path string, allowEmpty bool) ([]int, error)

func ParseArrayString added in v0.4.8 

func ParseArrayString(r any, path string, allowEmpty bool) ([]string, error)

func ParseBool added in v0.4.8 

func ParseBool(r any, path string, allowEmpty bool) (bool, error)

func ParseBoolSimple added in v0.4.40 

func ParseBoolSimple(r any) bool

func ParseFloat added in v0.4.8 

func ParseFloat(r any, path string, allowEmpty bool) (float64, error)

func ParseFloatSimple added in v0.4.40 

func ParseFloatSimple(r any) float64

func ParseInt added in v0.4.8 

func ParseInt(r any, path string, allowEmpty bool) (int, error)

func ParseInt16 added in v0.4.34 

func ParseInt16(r any, path string, allowEmpty bool) (int16, error)

func ParseInt16Simple added in v0.4.40 

func ParseInt16Simple(r any) int16

func ParseInt32 added in v0.4.34 

func ParseInt32(r any, path string, allowEmpty bool) (int32, error)

func ParseInt32Simple added in v0.4.40 

func ParseInt32Simple(r any) int32

func ParseInt64 added in v0.4.33 

func ParseInt64(r any, path string, allowEmpty bool) (int64, error)

func ParseInt64Simple added in v0.4.40 

func ParseInt64Simple(r any) int64

func ParseIntSimple added in v0.4.40 

func ParseIntSimple(r any) int

func ParseJSON added in v0.4.25 

func ParseJSON(r any, path string, allowEmpty bool) (any, error)

func ParseJSONSimple added in v0.4.40 

func ParseJSONSimple(r any) any

func ParseString added in v0.4.8 

func ParseString(r any, path string, allowEmpty bool) (string, error)

func ParseStringSimple added in v0.4.40 

func ParseStringSimple(r any) string

func ParseTime added in v0.4.8 

func ParseTime(r any, path string, allowEmpty bool) (*time.Time, error)

func ParseTimeSimple added in v0.4.40 

func ParseTimeSimple(r any) *time.Time

func ParseUUID added in v0.4.8 

func ParseUUID(r any, path string, allowEmpty bool) (*uuid.UUID, error)

func ParseUUIDSimple added in v0.4.40 

func ParseUUIDSimple(r any) *uuid.UUID

func Percent added in v0.5.21 

func Percent(f float64) string

func RandomBool 

func RandomBool() bool

func RandomBytes 

func RandomBytes(size int) []byte

func RandomDate 

func RandomDate() time.Time

func RandomElement added in v0.4.12 

func RandomElement[T any](slice []T) T

func RandomElements added in v0.3.10 

func RandomElements[T any](slice []T, idx int) []T

func RandomFloat added in v0.2.9 

func RandomFloat(maxExclusive int) float64

func RandomID added in v0.6.6 

func RandomID() string

func RandomIcon added in v0.4.4 

func RandomIcon() string

func RandomInt 

func RandomInt(maxExclusive int) int

func RandomInt16 added in v0.4.34 

func RandomInt16(maxExclusive int16) int16

func RandomInt32 added in v0.4.34 

func RandomInt32(maxExclusive int32) int32

func RandomInt64 added in v0.4.33 

func RandomInt64(maxExclusive int64) int64

func RandomString 

func RandomString(length int) string

func RandomURL added in v0.4.4 

func RandomURL() *url.URL

func ReplaceEnvVars 

func ReplaceEnvVars(s string, logger Logger) string

func RunProcess 

func RunProcess(cmd string, path string, in io.Reader, out io.Writer, er io.Writer, env ...string) (int, error)

func RunProcessSimple 

func RunProcessSimple(cmd string, path string) (int, string, error)

func StartProcess added in v0.2.12 

func StartProcess(cmd string, path string, in io.Reader, out io.Writer, er io.Writer, env ...string) (*exec.Cmd, error)

func StringArrayFromAny added in v0.4.0 

func StringArrayFromAny(a []any, maxLength int) []string

func StringArrayMaxLength 

func StringArrayMaxLength(a []string) int

func StringArrayOxfordComma 

func StringArrayOxfordComma(names []string, separator string) string

func StringArrayQuoted 

func StringArrayQuoted(a []string) []string

func StringCut added in v0.6.6 

func StringCut(s string, sep byte, cutc bool) (string, string)

func StringCutLast added in v0.6.6 

func StringCutLast(s string, sep byte, cutc bool) (string, string)

func StringDetectLinebreak added in v0.2.12 

func StringDetectLinebreak(s string) string

func StringFilePath added in v0.5.16 

func StringFilePath(elems ...string) string

func StringForms 

func StringForms(s string) (string, string)

func StringJoin added in v0.5.15 

func StringJoin(elems []string, delim string) string

func StringNullable added in v0.4.0 

func StringNullable(s fmt.Stringer) string

func StringPad 

func StringPad(s string, size int) string

func StringPadLeft added in v0.2.12 

func StringPadLeft(s string, size int, chr rune) string

func StringPadRight added in v0.2.12 

func StringPadRight(s string, size int, chr rune) string

func StringPath added in v0.5.16 

func StringPath(elems ...string) string

func StringPlural 

func StringPlural(count int, s string) string

func StringRepeat 

func StringRepeat(s string, n int) string

func StringReplaceBetween added in v0.2.12 

func StringReplaceBetween(s string, l string, r string, replacement string) (string, error)

func StringSplitAndTrim 

func StringSplitAndTrim(s string, delim string) []string

func StringSplitLastOnly added in v0.2.12 

func StringSplitLastOnly(s string, sep byte, cutc bool) string

func StringSplitLines added in v0.2.12 

func StringSplitLines(s string) []string

func StringSplitLinesIndented added in v0.3.1 

func StringSplitLinesIndented(s string, indent int, indentFirstLine bool, includeEmptyLines bool) []string

func StringSplitPath added in v0.2.12 

func StringSplitPath(s string) (string, string)

func StringSplitPathAndTrim added in v0.2.12 

func StringSplitPathAndTrim(s string) []string

func StringSubstringBetween added in v0.2.12 

func StringSubstringBetween(s string, l string, r string) string

func StringToCamel 

func StringToCamel(s string, extraAcronyms ...string) string

func StringToInitials added in v0.6.0 

func StringToInitials(s string, extraAcronyms ...string) string

func StringToKebab added in v0.5.24 

func StringToKebab(s string, extraAcronyms ...string) string

func StringToPlural 

func StringToPlural(s string) string

func StringToProper added in v0.5.1 

func StringToProper(s string, extraAcronyms ...string) string

func StringToSingular 

func StringToSingular(s string) string

func StringToSnake added in v0.2.5 

func StringToSnake(s string, extraAcronyms ...string) string

func StringToTitle 

func StringToTitle(s string, extraAcronyms ...string) string

func StringTruncate 

func StringTruncate(s string, mx int) string

func TimeCurrent added in v0.2.12 

func TimeCurrent() time.Time

func TimeCurrentMillis 

func TimeCurrentMillis() int64

func TimeCurrentNanos added in v0.2.12 

func TimeCurrentNanos() int64

func TimeCurrentP added in v0.2.12 

func TimeCurrentP() *time.Time

func TimeCurrentUnix added in v0.2.12 

func TimeCurrentUnix() int64

func TimeFromFull 

func TimeFromFull(s string) (*time.Time, error)

func TimeFromFullMS added in v0.4.0 

func TimeFromFullMS(s string) (*time.Time, error)

func TimeFromHTML 

func TimeFromHTML(s string) (*time.Time, error)

func TimeFromJS 

func TimeFromJS(s string) (*time.Time, error)

func TimeFromMillis added in v0.6.3 

func TimeFromMillis(ms int) (*time.Time, error)

func TimeFromRFC3339 added in v0.4.0 

func TimeFromRFC3339(s string) (*time.Time, error)

func TimeFromString 

func TimeFromString(s string) (*time.Time, error)

func TimeFromStringFmt 

func TimeFromStringFmt(s string, format string) (*time.Time, error)

func TimeFromStringSimple added in v0.3.10 

func TimeFromStringSimple(s string) *time.Time

func TimeFromVerbose added in v0.2.12 

func TimeFromVerbose(s string) (*time.Time, error)

func TimeFromYMD 

func TimeFromYMD(s string) (*time.Time, error)

func TimeMax added in v0.4.8 

func TimeMax(ts ...*time.Time) *time.Time

func TimeMin added in v0.4.8 

func TimeMin(ts ...*time.Time) *time.Time

func TimePlusDays added in v0.5.6 

func TimePlusDays(t *time.Time, days int) *time.Time

func TimeRelative 

func TimeRelative(t *time.Time) string

func TimeRounded added in v0.5.22 

func TimeRounded(t time.Time, d time.Duration) time.Time

func TimeRoundedP added in v0.5.24 

func TimeRoundedP(t *time.Time, d time.Duration) *time.Time

func TimeToDateString added in v0.5.6 

func TimeToDateString(d *time.Time) string

func TimeToFull 

func TimeToFull(d *time.Time) string

func TimeToFullMS added in v0.4.0 

func TimeToFullMS(d *time.Time) string

func TimeToHTML 

func TimeToHTML(d *time.Time) string

func TimeToHours added in v0.4.0 

func TimeToHours(d *time.Time) string

func TimeToJS 

func TimeToJS(d *time.Time) string

func TimeToJSFull added in v0.4.4 

func TimeToJSFull(d *time.Time) string

func TimeToMap added in v0.2.11 

func TimeToMap(t time.Time) map[string]any

func TimeToRFC3339 added in v0.4.0 

func TimeToRFC3339(d *time.Time) string

func TimeToString 

func TimeToString(d *time.Time, fmt string) string

func TimeToVerbose added in v0.2.12 

func TimeToVerbose(d *time.Time) string

func TimeToYMD 

func TimeToYMD(d *time.Time) string

func TimeToday added in v0.2.12 

func TimeToday() *time.Time

func TimeTruncate added in v0.2.12 

func TimeTruncate(t *time.Time) *time.Time

func ToCSV added in v0.4.0 

func ToCSV(data any) ([]string, [][]string, error)

func ToCSVBytes added in v0.4.0 

func ToCSVBytes(data any) ([]byte, error)

func ToJSON 

func ToJSON(x any) string

func ToJSONBytes 

func ToJSONBytes(x any, indent bool) []byte

func ToJSONCompact 

func ToJSONCompact(x any) string

func ToTOML added in v0.4.4 

func ToTOML(x any) string

func ToTOMLBytes added in v0.4.4 

func ToTOMLBytes(x any) []byte

func ToXML added in v0.4.0 

func ToXML(x any) (string, error)

func ToXMLBytes added in v0.4.0 

func ToXMLBytes(x any, indent bool) ([]byte, error)

func ToXMLCompact added in v0.4.0 

func ToXMLCompact(x any) (string, error)

func UUID 

func UUID() uuid.UUID

func UUIDFromString 

func UUIDFromString(s string) *uuid.UUID

func UUIDFromStringOK added in v0.2.12 

func UUIDFromStringOK(s string) uuid.UUID

func UUIDP 

func UUIDP() *uuid.UUID

func UUIDString added in v0.2.12 

func UUIDString(u *uuid.UUID) string

func UUIDV7 added in v0.4.19 

func UUIDV7() uuid.UUID

func UUIDV7P added in v0.4.19 

func UUIDV7P() *uuid.UUID

func ValueMapGet added in v0.4.10 

func ValueMapGet[T any](m ValueMap, pth string) (T, error)

Types

type DebugInfo 

type DebugInfo struct {
	ServerTags  *OrderedMap[string]
	AppTags     *OrderedMap[string]
	RuntimeTags *OrderedMap[string]
	Mods        []*debug.Module
}

func DebugGetInfo added in v0.2.18 

func DebugGetInfo(version string, started time.Time) *DebugInfo

type Diff 

type Diff struct {
	Path string `json:"path"`
	Old  string `json:"o,omitzero"`
	New  string `json:"n"`
}

func NewDiff 

func NewDiff(p string, o string, n string) *Diff

func (Diff) String 

func (d Diff) String() string

func (Diff) StringVerbose added in v0.2.11 

func (d Diff) StringVerbose() string

type Diffable added in v0.5.24 

type Diffable interface {
	Diff(other any, path []string, ignored ...string) Diffs
}

type Diffs 

type Diffs []*Diff

func DiffObjects 

func DiffObjects(l any, r any, path ...string) Diffs

func DiffObjectsIgnoring 

func DiffObjectsIgnoring(l any, r any, ignored []string, path ...string) Diffs

func RandomDiffs 

func RandomDiffs(size int) Diffs

func (Diffs) Sorted added in v0.4.4 

func (d Diffs) Sorted() Diffs

func (Diffs) String 

func (d Diffs) String() string

func (Diffs) StringVerbose added in v0.2.11 

func (d Diffs) StringVerbose() string

func (Diffs) Without added in v0.5.23 

func (d Diffs) Without(paths ...string) Diffs

type DiffsSet added in v0.3.10 

type DiffsSet map[string]Diffs

func (DiffsSet) Keys added in v0.4.26 

func (d DiffsSet) Keys() []string

type ErrorDetail 

type ErrorDetail struct {
	Type       string            `json:"type" xml:"type"`
	Message    string            `json:"message" xml:"message"`
	Stack      []ErrorFrame      `json:"stack,omitempty" xml:"stack,omitempty"`
	StackTrace errors.StackTrace `json:"-" xml:"-"`
	Cause      *ErrorDetail      `json:"cause,omitzero" xml:"cause,omitempty"`
}

func GetErrorDetail 

func GetErrorDetail(e error, includeStack bool) *ErrorDetail

type ErrorFrame 

type ErrorFrame struct {
	Key string `json:"key" xml:"key"`
	Loc string `json:"loc" xml:"loc"`
}

func TraceDetail 

func TraceDetail(trace errors.StackTrace) []ErrorFrame

type FieldDesc added in v0.3.0 

type FieldDesc struct {
	Key         string   `json:"key"`
	Title       string   `json:"title"`
	Description string   `json:"description,omitzero"`
	Type        string   `json:"type,omitzero"`
	Default     string   `json:"default,omitzero"`
	Choices     []string `json:"choices,omitempty"`
}

func (*FieldDesc) DefaultBool added in v0.5.23 

func (d *FieldDesc) DefaultBool() bool

func (*FieldDesc) DefaultFloat added in v0.5.23 

func (d *FieldDesc) DefaultFloat() float64

func (*FieldDesc) DefaultInt added in v0.5.23 

func (d *FieldDesc) DefaultInt() int

func (*FieldDesc) Parse added in v0.4.4 

func (d *FieldDesc) Parse(q any) (any, error)

func (*FieldDesc) TitleSafe added in v0.5.8 

func (d *FieldDesc) TitleSafe() string

type FieldDescResults added in v0.4.19 

type FieldDescResults struct {
	FieldDescs FieldDescs `json:"fieldDescs"`
	Values     ValueMap   `json:"values"`
	Missing    []string   `json:"missing,omitempty"`
}

func FieldDescsCollect added in v0.4.19 

func FieldDescsCollect(r *http.Request, args FieldDescs) *FieldDescResults

func FieldDescsCollectMap added in v0.4.36 

func FieldDescsCollectMap(m ValueMap, args FieldDescs) *FieldDescResults

func (*FieldDescResults) HasMissing added in v0.4.19 

func (a *FieldDescResults) HasMissing() bool

type FieldDescs added in v0.3.0 

type FieldDescs []*FieldDesc

func (FieldDescs) Get added in v0.4.4 

func (d FieldDescs) Get(key string) *FieldDesc

func (FieldDescs) Keys added in v0.4.0 

func (d FieldDescs) Keys() []string

type HTTPRequest added in v0.4.10 

type HTTPRequest struct {
	*http.Request
	// contains filtered or unexported fields
}

func NewHTTPGet added in v0.4.32 

func NewHTTPGet(ctx context.Context, url string) *HTTPRequest

func NewHTTPPost added in v0.4.32 

func NewHTTPPost(ctx context.Context, url string, body io.Reader) *HTTPRequest

func NewHTTPRequest added in v0.4.10 

func NewHTTPRequest(ctx context.Context, method string, url string, bodies ...io.Reader) *HTTPRequest

func (*HTTPRequest) Run added in v0.4.15 

func (r *HTTPRequest) Run() (*http.Response, error)

func (*HTTPRequest) RunSimple added in v0.4.10 

func (r *HTTPRequest) RunSimple() (int, http.Header, []byte, error)

func (*HTTPRequest) WithClient added in v0.4.10 

func (r *HTTPRequest) WithClient(c *http.Client) *HTTPRequest

func (*HTTPRequest) WithHeader added in v0.4.10 

func (r *HTTPRequest) WithHeader(k string, v string) *HTTPRequest

type KeyTypeDesc added in v0.1.42 

type KeyTypeDesc struct {
	Key         string `json:"key"`
	Type        string `json:"type"`
	Description string `json:"description"`
}

func (*KeyTypeDesc) Array added in v0.1.42 

func (k *KeyTypeDesc) Array(key string) []string

func (*KeyTypeDesc) Matches added in v0.4.4 

func (k *KeyTypeDesc) Matches(x *KeyTypeDesc) bool

func (*KeyTypeDesc) String added in v0.4.24 

func (k *KeyTypeDesc) String() string

type KeyTypeDescs added in v0.1.42 

type KeyTypeDescs []*KeyTypeDesc

func (KeyTypeDescs) Array added in v0.1.42 

func (k KeyTypeDescs) Array(key string) [][]string

func (KeyTypeDescs) Sort added in v0.1.42 

func (k KeyTypeDescs) Sort() KeyTypeDescs

func (KeyTypeDescs) Strings added in v0.4.24 

func (k KeyTypeDescs) Strings() []string

type KeyVal added in v0.2.12 

type KeyVal[T any] struct {
	Key string `json:"key" db:"key"`
	Val T      `json:"val" db:"val"`
}

func (KeyVal[T]) String added in v0.2.12 

func (k KeyVal[T]) String() string

type KeyVals added in v0.2.12 

type KeyVals[T any] []*KeyVal[T]

func (KeyVals[T]) String added in v0.2.12 

func (k KeyVals[T]) String() string

func (KeyVals[T]) ToMap added in v0.2.12 

func (k KeyVals[T]) ToMap() map[string]T

func (KeyVals[T]) Values added in v0.2.12 

func (k KeyVals[T]) Values() []T

type Logger added in v0.2.4 

type Logger = *zap.SugaredLogger
var RootLogger Logger

type MergeSet added in v0.5.23 

type MergeSet[K cmp.Ordered, T Mergeable[K, T]] struct {
	Map map[K]T
}

func NewMergeSet added in v0.5.23 

func NewMergeSet[K cmp.Ordered, T Mergeable[K, T]](capacity ...int) *MergeSet[K, T]

func (*MergeSet[K, T]) Clone added in v0.5.23 

func (m *MergeSet[K, T]) Clone() *MergeSet[K, T]

func (*MergeSet[K, T]) Contains added in v0.5.23 

func (m *MergeSet[K, T]) Contains(x T) bool

func (*MergeSet[K, T]) Entries added in v0.5.23 

func (m *MergeSet[K, T]) Entries() []T

func (*MergeSet[K, T]) Length added in v0.6.0 

func (m *MergeSet[K, T]) Length() int

func (*MergeSet[K, T]) MarshalJSON added in v0.5.23 

func (m *MergeSet[K, T]) MarshalJSON() ([]byte, error)

func (MergeSet[K, T]) MarshalXML added in v0.5.23 

func (m MergeSet[K, T]) MarshalXML(e *xml.Encoder, start xml.StartElement) error

func (*MergeSet[K, T]) MarshalYAML added in v0.5.23 

func (m *MergeSet[K, T]) MarshalYAML() (any, error)

func (*MergeSet[K, T]) Merge added in v0.6.0 

func (m *MergeSet[K, T]) Merge(other *MergeSet[K, T]) (*MergeSet[K, T], error)

func (*MergeSet[K, T]) Remove added in v0.5.23 

func (m *MergeSet[K, T]) Remove(x T)

func (*MergeSet[K, T]) Set added in v0.5.23 

func (m *MergeSet[K, T]) Set(v T) error

func (*MergeSet[K, T]) UnmarshalJSON added in v0.5.23 

func (m *MergeSet[K, T]) UnmarshalJSON(b []byte) error

type Mergeable added in v0.5.23 

type Mergeable[K cmp.Ordered, T any] interface {
	Key() K
	Merge(other T) (T, error)
}

type NilBool added in v0.4.0 

type NilBool struct {
	sql.NullBool
}

func (NilBool) MarshalJSON added in v0.4.0 

func (n NilBool) MarshalJSON() ([]byte, error)

func (*NilBool) UnmarshalJSON added in v0.4.0 

func (n *NilBool) UnmarshalJSON(data []byte) error

type NilFloat64 added in v0.4.0 

type NilFloat64 struct {
	sql.NullFloat64
}

func (NilFloat64) MarshalJSON added in v0.4.0 

func (n NilFloat64) MarshalJSON() ([]byte, error)

func (*NilFloat64) UnmarshalJSON added in v0.4.0 

func (n *NilFloat64) UnmarshalJSON(data []byte) error

type NilInt32 added in v0.4.0 

type NilInt32 struct {
	sql.NullInt32
}

func (NilInt32) MarshalJSON added in v0.4.0 

func (n NilInt32) MarshalJSON() ([]byte, error)

func (*NilInt32) UnmarshalJSON added in v0.4.0 

func (n *NilInt32) UnmarshalJSON(data []byte) error

type NilInt64 added in v0.4.0 

type NilInt64 struct {
	sql.NullInt64
}

func (NilInt64) MarshalJSON added in v0.4.0 

func (n NilInt64) MarshalJSON() ([]byte, error)

func (*NilInt64) UnmarshalJSON added in v0.4.0 

func (n *NilInt64) UnmarshalJSON(data []byte) error

type NilJSON added in v0.4.26 

type NilJSON struct {
	sql.Null[jsontext.Value]
}

func (NilJSON) MarshalJSON added in v0.4.26 

func (n NilJSON) MarshalJSON() ([]byte, error)

func (*NilJSON) UnmarshalJSON added in v0.4.26 

func (n *NilJSON) UnmarshalJSON(data []byte) error

type NilString added in v0.4.0 

type NilString struct {
	sql.NullString
}

func (NilString) MarshalJSON added in v0.4.0 

func (n NilString) MarshalJSON() ([]byte, error)

func (*NilString) UnmarshalJSON added in v0.4.0 

func (n *NilString) UnmarshalJSON(data []byte) error

type NilTime added in v0.4.0 

type NilTime struct {
	sql.NullTime
}

func (NilTime) MarshalJSON added in v0.4.0 

func (n NilTime) MarshalJSON() ([]byte, error)

func (*NilTime) UnmarshalJSON added in v0.4.0 

func (n *NilTime) UnmarshalJSON(data []byte) error

type Node added in v0.4.0 

type Node[T any] struct {
	Name     string   `json:"name"`
	Children Nodes[T] `json:"children,omitempty"`
	Tags     []string `json:"tags,omitempty"`
}

func (*Node[T]) Flatten added in v0.4.0 

func (n *Node[T]) Flatten(curr string) []string

func (*Node[T]) Get added in v0.4.0 

func (n *Node[T]) Get(pth ...string) *Node[T]

type Nodes added in v0.4.0 

type Nodes[T any] []*Node[T]

func (Nodes[T]) Flatten added in v0.4.0 

func (n Nodes[T]) Flatten(curr string) []string

func (Nodes[T]) Get added in v0.4.0 

func (n Nodes[T]) Get(pth ...string) *Node[T]

func (Nodes[T]) Merge added in v0.4.0 

func (n Nodes[T]) Merge(x Nodes[T]) Nodes[T]

func (Nodes[T]) Sort added in v0.4.0 

func (n Nodes[T]) Sort() Nodes[T]

type OrderedMap 

type OrderedMap[V any] struct {
	Lexical bool
	Order   []string
	Map     map[string]V
}

func FromJSONOrderedMap added in v0.4.40 

func FromJSONOrderedMap[V any](msg []byte) (*OrderedMap[V], error)

func NewOMap added in v0.4.4 

func NewOMap[V any]() *OrderedMap[V]

func NewOrderedMap 

func NewOrderedMap[V any](lexical bool, capacity int, pairs ...*OrderedPair[V]) *OrderedMap[V]

func OrderedMapFromMap added in v0.5.24 

func OrderedMapFromMap[V any](m map[string]V, lexical bool) *OrderedMap[V]

func ParseOrderedMap added in v0.4.40 

func ParseOrderedMap(r any, path string, allowEmpty bool) (*OrderedMap[any], error)

func ParseOrderedMapSimple added in v0.4.40 

func ParseOrderedMapSimple(r any) *OrderedMap[any]

func (*OrderedMap[V]) Clear added in v0.4.40 

func (o *OrderedMap[V]) Clear()

func (*OrderedMap[V]) Clone added in v0.4.25 

func (o *OrderedMap[V]) Clone() *OrderedMap[V]

func (*OrderedMap[V]) Empty added in v0.6.6 

func (o *OrderedMap[V]) Empty() bool

func (*OrderedMap[V]) Get 

func (o *OrderedMap[V]) Get(k string) (V, bool)

func (*OrderedMap[V]) GetSimple 

func (o *OrderedMap[V]) GetSimple(k string) V

func (*OrderedMap[V]) HasKey added in v0.4.4 

func (o *OrderedMap[V]) HasKey(k string) bool

func (*OrderedMap[V]) IndexOf added in v0.4.4 

func (o *OrderedMap[V]) IndexOf(k string) int

func (*OrderedMap[V]) Keys added in v0.6.6 

func (o *OrderedMap[V]) Keys() []string

func (*OrderedMap[V]) Length added in v0.6.6 

func (o *OrderedMap[V]) Length() int

func (OrderedMap[V]) MarshalJSON 

func (o OrderedMap[V]) MarshalJSON() ([]byte, error)

func (OrderedMap[V]) MarshalXML 

func (o OrderedMap[V]) MarshalXML(e *xml.Encoder, start xml.StartElement) error

func (OrderedMap[V]) MarshalYAML 

func (o OrderedMap[V]) MarshalYAML() (any, error)

func (*OrderedMap[V]) Merge added in v0.6.6 

func (o *OrderedMap[V]) Merge(defs *OrderedMap[V]) *OrderedMap[V]

func (*OrderedMap[V]) Pairs added in v0.4.4 

func (o *OrderedMap[V]) Pairs() []*OrderedPair[V]

func (*OrderedMap[V]) Remove added in v0.4.4 

func (o *OrderedMap[V]) Remove(k string)

func (*OrderedMap[V]) Set added in v0.4.4 

func (o *OrderedMap[V]) Set(k string, v V)

func (*OrderedMap[V]) SetAll added in v0.6.6 

func (o *OrderedMap[V]) SetAll(m map[string]V)

func (*OrderedMap[V]) ToMap added in v0.5.24 

func (o *OrderedMap[V]) ToMap() ValueMap

func (*OrderedMap[V]) ToOrderedMap added in v0.5.24 

func (o *OrderedMap[V]) ToOrderedMap() *OrderedMap[V]

func (*OrderedMap[V]) ToOrderedMapAny added in v0.6.6 

func (o *OrderedMap[V]) ToOrderedMapAny() *OrderedMap[any]

func (*OrderedMap[V]) UnmarshalJSON 

func (o *OrderedMap[V]) UnmarshalJSON(data []byte) error

type OrderedMaps added in v0.4.37 

type OrderedMaps[V any] []*OrderedMap[V]

type OrderedPair added in v0.4.4 

type OrderedPair[V any] struct {
	K string `json:"k"`
	V V      `json:"v"`
}

func NewOrderedPair added in v0.4.37 

func NewOrderedPair[V any](k string, v V) *OrderedPair[V]

type OrderedPairs added in v0.4.37 

type OrderedPairs[V any] []*OrderedPair[V]

type Pkg 

type Pkg []string

func NewPkgSplit added in v0.6.6 

func NewPkgSplit(s string, delim string) Pkg

func (Pkg) Drop 

func (p Pkg) Drop(n int) Pkg

func (Pkg) Equals 

func (p Pkg) Equals(other Pkg) bool

func (Pkg) Last 

func (p Pkg) Last() string

func (Pkg) Push 

func (p Pkg) Push(name string) Pkg

func (Pkg) Quoted 

func (p Pkg) Quoted(quote string) string

func (Pkg) Shift 

func (p Pkg) Shift() Pkg

func (Pkg) StartsWith 

func (p Pkg) StartsWith(t Pkg) bool

func (Pkg) String 

func (p Pkg) String() string

func (Pkg) StringWith 

func (p Pkg) StringWith(extra ...string) string

func (Pkg) ToPath 

func (p Pkg) ToPath(extra ...string) string

func (Pkg) Trim 

func (p Pkg) Trim(src Pkg) Pkg

func (Pkg) With 

func (p Pkg) With(key string) Pkg

type Progress added in v0.4.8 

type Progress struct {
	Key       string `json:"key,omitzero"`
	Total     int    `json:"total,omitzero"`
	Completed int    `json:"completed,omitzero"`
	// contains filtered or unexported fields
}

func NewProgress added in v0.4.8 

func NewProgress(key string, total int, fns ...func(p *Progress, delta int)) *Progress

func (*Progress) Increment added in v0.4.8 

func (p *Progress) Increment(i int, logger Logger)

func (*Progress) String added in v0.4.8 

func (p *Progress) String() string

type Set added in v0.4.27 

type Set[T cmp.Ordered] struct {
	Map map[T]struct{}
}

func NewSet added in v0.4.27 

func NewSet[T cmp.Ordered](capacity ...int) *Set[T]

func (*Set[T]) Clone added in v0.4.27 

func (s *Set[T]) Clone() *Set[T]

func (*Set[T]) Contains added in v0.4.27 

func (s *Set[T]) Contains(x T) bool

func (*Set[T]) Entries added in v0.4.27 

func (s *Set[T]) Entries() []T

func (Set[T]) MarshalJSON added in v0.4.27 

func (s Set[T]) MarshalJSON() ([]byte, error)

func (Set[T]) MarshalXML added in v0.4.27 

func (s Set[T]) MarshalXML(e *xml.Encoder, start xml.StartElement) error

func (Set[T]) MarshalYAML added in v0.4.27 

func (s Set[T]) MarshalYAML() (any, error)

func (*Set[T]) Remove added in v0.4.27 

func (s *Set[T]) Remove(x T)

func (*Set[T]) Set added in v0.4.27 

func (s *Set[T]) Set(v T)

func (*Set[T]) UnmarshalJSON added in v0.4.27 

func (s *Set[T]) UnmarshalJSON(b []byte) error

type Str added in v0.6.6 

type Str string

func (Str) Append added in v0.6.6 

func (s Str) Append(strs ...string) Str

func (Str) Contains added in v0.6.6 

func (s Str) Contains(x string) bool

func (Str) ContainsAny added in v0.6.6 

func (s Str) ContainsAny(x string) bool

func (Str) ContainsRune added in v0.6.6 

func (s Str) ContainsRune(chr rune) bool

func (Str) Cut added in v0.6.6 

func (s Str) Cut(sep byte, cutc bool) (Str, Str)

func (Str) CutLast added in v0.6.6 

func (s Str) CutLast(sep byte, cutc bool) (Str, Str)

func (Str) DetectLinebreak added in v0.6.6 

func (s Str) DetectLinebreak() string

func (Str) Empty added in v0.6.6 

func (s Str) Empty() bool

func (Str) Equal added in v0.6.6 

func (s Str) Equal(x string) bool

func (Str) EqualFold added in v0.6.6 

func (s Str) EqualFold(x string) bool

func (Str) FilePath added in v0.6.6 

func (s Str) FilePath(elems ...string) Str

func (Str) HasPrefix added in v0.6.6 

func (s Str) HasPrefix(prefix string) bool

func (Str) HasSuffix added in v0.6.6 

func (s Str) HasSuffix(suffix string) bool

func (Str) Index added in v0.6.6 

func (s Str) Index(substring string) int

func (Str) Join added in v0.6.6 

func (s Str) Join(elems Strings, delim string) Str

func (Str) JoinStrings added in v0.6.6 

func (s Str) JoinStrings(elems []string, delim string) Str

func (Str) Length added in v0.6.6 

func (s Str) Length() int

func (Str) OrDefault added in v0.6.6 

func (s Str) OrDefault(dflt string) Str

func (Str) Pad added in v0.6.6 

func (s Str) Pad(size int) Str

func (Str) PadLeft added in v0.6.6 

func (s Str) PadLeft(size int, chr rune) Str

func (Str) PadRight added in v0.6.6 

func (s Str) PadRight(size int, chr rune) Str

func (Str) ParseInt added in v0.6.6 

func (s Str) ParseInt() (int, bool)

func (Str) ParseUUID added in v0.6.6 

func (s Str) ParseUUID() *uuid.UUID

func (Str) Path added in v0.6.6 

func (s Str) Path(elems ...string) Str

func (Str) Repeat added in v0.6.6 

func (s Str) Repeat(n int) Str

func (Str) Replace added in v0.6.6 

func (s Str) Replace(old string, nw string, n int) Str

func (Str) ReplaceAll added in v0.6.6 

func (s Str) ReplaceAll(old string, nw string) Str

func (Str) ReplaceBetween added in v0.6.6 

func (s Str) ReplaceBetween(left string, right string, replacement string) (Str, error)

func (Str) Split added in v0.6.6 

func (s Str) Split(delim string) Strings

func (Str) SplitAndTrim added in v0.6.6 

func (s Str) SplitAndTrim(delim string) Strings

func (Str) SplitLastOnly added in v0.6.6 

func (s Str) SplitLastOnly(sep byte, cutc bool) Str

func (Str) SplitLines added in v0.6.6 

func (s Str) SplitLines() Strings

func (Str) SplitLinesIndented added in v0.6.6 

func (s Str) SplitLinesIndented(indent int, indentFirstLine bool, includeEmptyLines bool) Strings

func (Str) SplitPath added in v0.6.6 

func (s Str) SplitPath() (string, string)

func (Str) SplitPathAndTrim added in v0.6.6 

func (s Str) SplitPathAndTrim() Strings

func (Str) String added in v0.6.6 

func (s Str) String() string

func (Str) Substring added in v0.6.6 

func (s Str) Substring(start int, end int) Str

func (Str) SubstringBetween added in v0.6.6 

func (s Str) SubstringBetween(left string, right string) Str

func (Str) ToCamel added in v0.6.6 

func (s Str) ToCamel() Str

func (Str) ToKebab added in v0.6.6 

func (s Str) ToKebab() Str

func (Str) ToLower added in v0.6.6 

func (s Str) ToLower() Str

func (Str) ToProper added in v0.6.6 

func (s Str) ToProper() Str

func (Str) ToSnake added in v0.6.6 

func (s Str) ToSnake() Str

func (Str) ToUpper added in v0.6.6 

func (s Str) ToUpper() Str

func (Str) TrimPrefix added in v0.6.6 

func (s Str) TrimPrefix(prefix string) Str

func (Str) TrimSpace added in v0.6.6 

func (s Str) TrimSpace() Str

func (Str) TrimSuffix added in v0.6.6 

func (s Str) TrimSuffix(suffix string) Str

func (Str) Truncate added in v0.6.6 

func (s Str) Truncate(mx int) Str

func (Str) With added in v0.6.6 

func (s Str) With(elems ...Str) Strings

func (Str) WithPrefix added in v0.6.6 

func (s Str) WithPrefix(prefixes ...Str) Str

func (Str) WithStrings added in v0.6.6 

func (s Str) WithStrings(elems ...string) Strings

func (Str) WithSuffix added in v0.6.6 

func (s Str) WithSuffix(suffixes ...Str) Str

type StringSlice added in v0.4.0 

type StringSlice struct {
	Slice []string
}

func NewStringSlice added in v0.4.0 

func NewStringSlice(a ...string) *StringSlice

func NewStringSliceWithSize added in v0.6.6 

func NewStringSliceWithSize(size int) *StringSlice

func (*StringSlice) Empty added in v0.4.0 

func (s *StringSlice) Empty() bool

func (*StringSlice) Join added in v0.4.0 

func (s *StringSlice) Join(x string) string

func (*StringSlice) JoinCommas added in v0.6.6 

func (s *StringSlice) JoinCommas() string

func (*StringSlice) JoinSimple added in v0.6.6 

func (s *StringSlice) JoinSimple() string

func (*StringSlice) JoinSpace added in v0.6.6 

func (s *StringSlice) JoinSpace() string

func (*StringSlice) Length added in v0.6.6 

func (s *StringSlice) Length() int

func (*StringSlice) MarshalJSON added in v0.6.6 

func (s *StringSlice) MarshalJSON() ([]byte, error)

func (*StringSlice) Push added in v0.4.0 

func (s *StringSlice) Push(strs ...string)

func (*StringSlice) PushUnique added in v0.5.22 

func (s *StringSlice) PushUnique(strs ...string)

func (*StringSlice) Pushf added in v0.4.0 

func (s *StringSlice) Pushf(msg string, args ...any)

func (*StringSlice) PushfUnlessNil added in v0.6.1 

func (s *StringSlice) PushfUnlessNil(msg string, args ...any)

func (*StringSlice) SliceSafe added in v0.6.0 

func (s *StringSlice) SliceSafe() []string

func (*StringSlice) Sort added in v0.4.0 

func (s *StringSlice) Sort()

func (*StringSlice) String added in v0.4.4 

func (s *StringSlice) String() string

func (*StringSlice) TotalLength added in v0.5.22 

func (s *StringSlice) TotalLength() int

func (*StringSlice) UnmarshalJSON added in v0.6.6 

func (s *StringSlice) UnmarshalJSON(data []byte) error

type Strings added in v0.6.6 

type Strings []Str

func Strs added in v0.6.6 

func Strs(strs ...string) Strings

func (Strings) Empty added in v0.6.6 

func (s Strings) Empty() bool

func (Strings) Join added in v0.6.6 

func (s Strings) Join(delim string) Str

func (Strings) Strings added in v0.6.6 

func (s Strings) Strings() []string

func (Strings) With added in v0.6.6 

func (s Strings) With(elems ...Str) Strings

func (Strings) WithPrefix added in v0.6.6 

func (s Strings) WithPrefix(prefixes ...Str) Strings

func (Strings) WithSuffix added in v0.6.6 

func (s Strings) WithSuffix(suffixes ...Str) Strings

type Timer added in v0.1.43 

type Timer struct {
	Started   int64 `json:"started"`
	Completed int64 `json:"complete"`
}

func TimerStart 

func TimerStart() *Timer

func (*Timer) Elapsed added in v0.1.43 

func (t *Timer) Elapsed() int

func (*Timer) End added in v0.1.43 

func (t *Timer) End() int

func (*Timer) EndString added in v0.1.43 

func (t *Timer) EndString() string

func (*Timer) String added in v0.1.43 

func (t *Timer) String() string

type ToMap added in v0.4.37 

type ToMap interface {
	ToMap() ValueMap
}

type ToMaps added in v0.4.37 

type ToMaps interface {
	ToMaps() []ValueMap
}

type ToOrderedMap added in v0.4.37 

type ToOrderedMap[T any] interface {
	ToOrderedMap() *OrderedMap[T]
}

type ToOrderedMapAny added in v0.6.6 

type ToOrderedMapAny interface {
	ToOrderedMapAny() *OrderedMap[any]
}

type ToOrderedMaps added in v0.4.37 

type ToOrderedMaps[T any] interface {
	ToOrderedMaps() OrderedMaps[T]
}

type Tree added in v0.4.0 

type Tree[T any] struct {
	Nodes  Nodes[T] `json:"nodes,omitempty"`
	Config ValueMap `json:"config,omitzero"`
}

func (Tree[T]) Flatten added in v0.4.0 

func (t Tree[T]) Flatten() []string

func (Tree[T]) Merge added in v0.4.0 

func (t Tree[T]) Merge(x *Tree[T]) *Tree[T]

type ValueMap 

type ValueMap map[string]any

func FromJSONMap added in v0.2.27 

func FromJSONMap(msg []byte) (ValueMap, error)

func FromTOMLMap added in v0.4.4 

func FromTOMLMap(msg []byte) (ValueMap, error)

func FromXMLMap added in v0.4.0 

func FromXMLMap(msg []byte) (ValueMap, error)

func ParseArrayMap added in v0.4.8 

func ParseArrayMap(r any, path string, allowEmpty bool) ([]ValueMap, error)

func ParseMap added in v0.4.8 

func ParseMap(r any, path string, allowEmpty bool) (ValueMap, error)

func ParseMapSimple added in v0.4.40 

func ParseMapSimple(r any) ValueMap

func RandomValueMap 

func RandomValueMap(keys int) ValueMap

func ValueMapFor 

func ValueMapFor(kvs ...any) ValueMap

func ValueMapFrom added in v0.4.33 

func ValueMapFrom(m map[string]any) ValueMap

func ValueMapFromAny added in v0.5.24 

func ValueMapFromAny(x any) (ValueMap, error)

func ValueMapFromAnyOK added in v0.5.24 

func ValueMapFromAnyOK(x any) ValueMap

func (ValueMap) Add 

func (m ValueMap) Add(kvs ...any)

func (ValueMap) AsChanges 

func (m ValueMap) AsChanges() (ValueMap, error)

func (ValueMap) AsMap added in v0.4.31 

func (m ValueMap) AsMap(simplify bool) map[string]any

func (ValueMap) Clone 

func (m ValueMap) Clone() ValueMap

func (ValueMap) Empty added in v0.6.6 

func (m ValueMap) Empty() bool

func (ValueMap) Filter added in v0.2.12 

func (m ValueMap) Filter(keys []string) ValueMap

func (ValueMap) GetArray 

func (m ValueMap) GetArray(key string, allowEmpty bool) ([]any, error)

func (ValueMap) GetArrayOpt added in v0.3.9 

func (m ValueMap) GetArrayOpt(key string) []any

func (ValueMap) GetArrayOr added in v0.5.23 

func (m ValueMap) GetArrayOr(key string, dflt []any, allowEmpty bool) []any

func (ValueMap) GetBool 

func (m ValueMap) GetBool(key string, allowEmpty bool) (bool, error)

func (ValueMap) GetBoolOpt added in v0.2.4 

func (m ValueMap) GetBoolOpt(key string) bool

func (ValueMap) GetBoolOr added in v0.5.23 

func (m ValueMap) GetBoolOr(key string, dflt bool, allowEmpty bool) bool

func (ValueMap) GetFloat 

func (m ValueMap) GetFloat(key string, allowEmpty bool) (float64, error)

func (ValueMap) GetFloatArray added in v0.3.9 

func (m ValueMap) GetFloatArray(key string, allowEmpty bool) ([]float64, error)

func (ValueMap) GetFloatArrayOpt added in v0.5.23 

func (m ValueMap) GetFloatArrayOpt(key string) []float64

func (ValueMap) GetFloatArrayOr added in v0.5.23 

func (m ValueMap) GetFloatArrayOr(key string, dflt []float64, allowEmpty bool) []float64

func (ValueMap) GetFloatOpt added in v0.3.9 

func (m ValueMap) GetFloatOpt(key string) float64

func (ValueMap) GetFloatOr added in v0.5.23 

func (m ValueMap) GetFloatOr(key string, dflt float64, allowEmpty bool) float64

func (ValueMap) GetInt 

func (m ValueMap) GetInt(key string, allowEmpty bool) (int, error)

func (ValueMap) GetInt64 

func (m ValueMap) GetInt64(key string, allowEmpty bool) (int64, error)

func (ValueMap) GetInt64Opt added in v0.5.23 

func (m ValueMap) GetInt64Opt(key string) int64

func (ValueMap) GetInt64Or added in v0.5.23 

func (m ValueMap) GetInt64Or(key string, dflt int64, allowEmpty bool) int64

func (ValueMap) GetIntArray added in v0.3.9 

func (m ValueMap) GetIntArray(key string, allowEmpty bool) ([]int, error)

func (ValueMap) GetIntArrayOpt added in v0.5.23 

func (m ValueMap) GetIntArrayOpt(key string) []int

func (ValueMap) GetIntArrayOr added in v0.5.23 

func (m ValueMap) GetIntArrayOr(key string, dflt []int, allowEmpty bool) []int

func (ValueMap) GetIntOpt added in v0.2.11 

func (m ValueMap) GetIntOpt(key string) int

func (ValueMap) GetIntOr added in v0.5.23 

func (m ValueMap) GetIntOr(key string, dflt int, allowEmpty bool) int

func (ValueMap) GetMap 

func (m ValueMap) GetMap(key string, allowEmpty bool) (ValueMap, error)

func (ValueMap) GetMapArray added in v0.3.9 

func (m ValueMap) GetMapArray(key string, allowEmpty bool) ([]ValueMap, error)

func (ValueMap) GetMapArrayOpt added in v0.5.23 

func (m ValueMap) GetMapArrayOpt(key string) []ValueMap

func (ValueMap) GetMapArrayOr added in v0.5.23 

func (m ValueMap) GetMapArrayOr(key string, dflt []ValueMap, allowEmpty bool) []ValueMap

func (ValueMap) GetMapOpt added in v0.3.9 

func (m ValueMap) GetMapOpt(key string) ValueMap

func (ValueMap) GetMapOr added in v0.5.23 

func (m ValueMap) GetMapOr(key string, dflt ValueMap, allowEmpty bool) ValueMap

func (ValueMap) GetPath 

func (m ValueMap) GetPath(path string, allowMissing bool) (any, error)

func (ValueMap) GetRequired 

func (m ValueMap) GetRequired(k string) (any, error)

func (ValueMap) GetRichString added in v0.6.6 

func (m ValueMap) GetRichString(key string, allowEmpty bool) (Str, error)

func (ValueMap) GetRichStringOpt added in v0.6.6 

func (m ValueMap) GetRichStringOpt(key string) Str

func (ValueMap) GetString 

func (m ValueMap) GetString(key string, allowEmpty bool) (string, error)

func (ValueMap) GetStringArray 

func (m ValueMap) GetStringArray(key string, allowEmpty bool) ([]string, error)

func (ValueMap) GetStringArrayOpt added in v0.3.9 

func (m ValueMap) GetStringArrayOpt(key string) []string

func (ValueMap) GetStringArrayOr added in v0.5.23 

func (m ValueMap) GetStringArrayOr(key string, dflt []string, allowEmpty bool) []string

func (ValueMap) GetStringOpt 

func (m ValueMap) GetStringOpt(key string) string

func (ValueMap) GetStringOr added in v0.4.41 

func (m ValueMap) GetStringOr(key string, dflt string, allowEmpty bool) string

func (ValueMap) GetStringPtr added in v0.2.12 

func (m ValueMap) GetStringPtr(key string) *string

func (ValueMap) GetTime 

func (m ValueMap) GetTime(key string, allowEmpty bool) (*time.Time, error)

func (ValueMap) GetTimeOpt added in v0.3.9 

func (m ValueMap) GetTimeOpt(key string) time.Time

func (ValueMap) GetTimeOr added in v0.5.23 

func (m ValueMap) GetTimeOr(key string, dflt *time.Time, allowEmpty bool) *time.Time

func (ValueMap) GetType 

func (m ValueMap) GetType(key string, ret any) error

func (ValueMap) GetUUID 

func (m ValueMap) GetUUID(key string, allowEmpty bool) (*uuid.UUID, error)

func (ValueMap) GetUUIDOpt added in v0.3.9 

func (m ValueMap) GetUUIDOpt(key string) uuid.UUID

func (ValueMap) GetUUIDOr added in v0.5.23 

func (m ValueMap) GetUUIDOr(key string, dflt *uuid.UUID, allowEmpty bool) *uuid.UUID

func (ValueMap) HasKey added in v0.3.10 

func (m ValueMap) HasKey(key string) bool

func (ValueMap) JSON added in v0.4.9 

func (m ValueMap) JSON() string

func (ValueMap) Keys 

func (m ValueMap) Keys() []string

func (ValueMap) KeysAndValues 

func (m ValueMap) KeysAndValues() ([]string, []any)

func (ValueMap) Length added in v0.6.6 

func (m ValueMap) Length() int

func (ValueMap) MarshalXML 

func (m ValueMap) MarshalXML(e *xml.Encoder, _ xml.StartElement) error

func (ValueMap) Merge 

func (m ValueMap) Merge(args ...ValueMap) ValueMap

func (ValueMap) Overwrite added in v0.2.12 

func (m ValueMap) Overwrite(sourceMap ValueMap) ValueMap

func (ValueMap) ParseArray 

func (m ValueMap) ParseArray(path string, allowMissing bool, allowEmpty bool, coerce bool) ([]any, error)

func (ValueMap) ParseArrayFloat added in v0.3.9 

func (m ValueMap) ParseArrayFloat(path string, allowMissing bool, allowEmpty bool) ([]float64, error)

func (ValueMap) ParseArrayInt added in v0.2.5 

func (m ValueMap) ParseArrayInt(path string, allowMissing bool, allowEmpty bool) ([]int, error)

func (ValueMap) ParseArrayMap added in v0.3.9 

func (m ValueMap) ParseArrayMap(path string, allowMissing bool, allowEmpty bool) ([]ValueMap, error)

func (ValueMap) ParseArrayString added in v0.2.5 

func (m ValueMap) ParseArrayString(path string, allowMissing bool, allowEmpty bool) ([]string, error)

func (ValueMap) ParseBool 

func (m ValueMap) ParseBool(path string, allowMissing bool, allowEmpty bool) (bool, error)

func (ValueMap) ParseFloat 

func (m ValueMap) ParseFloat(path string, allowMissing bool, allowEmpty bool) (float64, error)

func (ValueMap) ParseInt 

func (m ValueMap) ParseInt(path string, allowMissing bool, allowEmpty bool) (int, error)

func (ValueMap) ParseInt16 added in v0.4.34 

func (m ValueMap) ParseInt16(path string, allowMissing bool, allowEmpty bool) (int16, error)

func (ValueMap) ParseInt32 added in v0.4.34 

func (m ValueMap) ParseInt32(path string, allowMissing bool, allowEmpty bool) (int32, error)

func (ValueMap) ParseInt64 added in v0.4.33 

func (m ValueMap) ParseInt64(path string, allowMissing bool, allowEmpty bool) (int64, error)

func (ValueMap) ParseJSON added in v0.4.25 

func (m ValueMap) ParseJSON(path string, allowMissing bool, allowEmpty bool) (any, error)

func (ValueMap) ParseMap 

func (m ValueMap) ParseMap(path string, allowMissing bool, allowEmpty bool) (ValueMap, error)

func (ValueMap) ParseString 

func (m ValueMap) ParseString(path string, allowMissing bool, allowEmpty bool) (string, error)

func (ValueMap) ParseTime 

func (m ValueMap) ParseTime(path string, allowMissing bool, allowEmpty bool) (*time.Time, error)

func (ValueMap) ParseUUID 

func (m ValueMap) ParseUUID(path string, allowMissing bool, allowEmpty bool) (*uuid.UUID, error)

func (ValueMap) ReplaceEnvVars added in v0.5.20 

func (m ValueMap) ReplaceEnvVars(logger Logger) ValueMap

func (ValueMap) SetPath 

func (m ValueMap) SetPath(path string, val any) error

func (ValueMap) String added in v0.4.0 

func (m ValueMap) String() string

func (ValueMap) ToMap added in v0.5.24 

func (m ValueMap) ToMap() ValueMap

func (ValueMap) ToOrderedMap added in v0.5.24 

func (m ValueMap) ToOrderedMap() *OrderedMap[any]

func (ValueMap) ToQueryString 

func (m ValueMap) ToQueryString() string

func (ValueMap) ToStringMap added in v0.2.20 

func (m ValueMap) ToStringMap() map[string]string

func (ValueMap) With added in v0.4.31 

func (m ValueMap) With(k string, v any) ValueMap

func (ValueMap) WithoutKeys added in v0.4.1 

func (m ValueMap) WithoutKeys(keys ...string) ValueMap

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.