util

package

v1.5.24 Latest Latest Go to latest Published: Nov 3, 2024 License: MIT Imports: 45 Imported by: 3

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/kyleu/projectforge

Links

Open Source Insights

Documentation ¶

Overview ¶

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

Index ¶

Constants
Variables
func ArrayDereference[T any](x []*T) []T
func ArrayFirstN[V any](items []V, n int) []V
func ArrayFlatten[T any](arrs ...[]T) []T
func ArrayFromAny[T any](dest any) []T
func ArrayLastN[V any](items []V, n int) []V
func ArrayLimit[T any](x []T, limit int) ([]T, int)
func ArrayRemoveDuplicates[T comparable](x []T) []T
func ArrayRemoveEmpty[T comparable](x []T) []T
func ArrayRemoveNil[T any](x []*T) []*T
func ArraySorted[T cmp.Ordered](x []T) []T
func ArraySplit[T any](xs []T, fn func(T) bool) ([]T, []T)
func ArrayTest(dest any) bool
func ArrayToStringArray[T any](a []T) []string
func ArrayTransform[T any, U any](x []T, f func(T) U) []U
func AsyncCollect[T any, R any](items []T, f func(x T) (R, error), loggers ...Logger) ([]R, []error)
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[T any, R any](key string, items []T, f func(x T) (R, error), maxConcurrent int, ...) ([]R, []error)
func ByteSizeIEC(b int64) string
func ByteSizeSI(b int64) string
func Choose[T any](b bool, ifTrue T, ifFalse T) T
func ConfigureAcronym(key, val string)
func CountryFlag(code string) string
func CycleJSON(src any, tgt any) error
func CycleXML(src any, tgt any) error
func DebugBuildInfo() *debug.BuildInfo
func DebugMemStats() *runtime.MemStats
func DebugStartCPUProfile() error
func DebugTakeHeapProfile() error
func DecryptMessage(key []byte, message string, logger Logger) (string, error)
func DefaultIfNil[T any](ptr *T, d T) T
func DefaultValue[T any]() T
func EncryptMessage(key []byte, message string, logger Logger) (string, error)
func ErrorMerge(errs ...error) error
func Filename(s string) string
func FormatSeconds(x float64) string
func FormatSecondsFull(x float64) string
func FromJSON(msg json.RawMessage, tgt any) error
func FromJSONAny(msg json.RawMessage) (any, error)
func FromJSONAnyOK(msg json.RawMessage) any
func FromJSONObj[T any](msg json.RawMessage) (T, error)
func FromJSONReader(r io.Reader, tgt any) error
func FromJSONStrict(msg json.RawMessage, tgt any) error
func FromJSONString(msg json.RawMessage) (string, error)
func FromTOML(msg []byte, tgt any) error
func FromTOMLAny(msg []byte) (any, error)
func FromTOMLReader(r io.Reader, tgt any) error
func FromTOMLStrict(msg []byte, tgt any) error
func FromTOMLString(msg []byte) (string, error)
func FromXML(msg []byte, tgt any) error
func FromXMLAny(msg []byte) (any, error)
func FromXMLReader(r io.Reader, tgt any) error
func FromXMLStrict(msg []byte, tgt any) error
func FromXMLString(msg []byte) (string, error)
func GetEnv(name string, defaultValue ...string) string
func GetEnvBool(name string, defaultValue bool) bool
func GetEnvDuration(name string, defaultValue time.Duration) time.Duration
func GetEnvInt(name string, defaultValue int) int
func HashFNV128UUID(s string) uuid.UUID
func HashFNV32(s string) uint32
func HashSHA256(s string) string
func InitAcronyms(extras ...string) error
func JSONToMap(i any) map[string]any
func JoinLines(ss []string, delim string, maxLen int) []string
func JoinLinesFull(ss []string, delim string, maxLen int, prefix string, indent string, ...) string
func LengthAny(dest any) int
func MapError[T any, U any](xa []T, f func(el T, idx int) (U, error)) ([]U, error)
func MapGetOrElse[K comparable, V any](mp map[K]V, k K, dflt V) V
func MarkdownTable(header []string, rows [][]string, linebreak string) (string, error)
func MarkdownTableParse(md string) ([]string, [][]string)
func MicrosToMillis(i int) string
func OrDefault[T comparable](x T, dflt T) T
func ParseArray(r any, path string, allowEmpty bool, coerce bool) ([]any, error)
func ParseArrayFloat(r any, path string, allowEmpty bool) ([]float64, error)
func ParseArrayInt(r any, path string, allowEmpty bool) ([]int, error)
func ParseArrayString(r any, path string, allowEmpty bool) ([]string, error)
func ParseBool(r any, path string, allowEmpty bool) (bool, error)
func ParseFloat(r any, path string, allowEmpty bool) (float64, error)
func ParseInt(r any, path string, allowEmpty bool) (int, error)
func ParseInt64(r any, path string, allowEmpty bool) (int64, error)
func ParseJSON(r any, path string, allowEmpty bool) (any, error)
func ParseString(r any, path string, allowEmpty bool) (string, error)
func ParseTime(r any, path string, allowEmpty bool) (*time.Time, error)
func ParseUUID(r any, path string, allowEmpty bool) (*uuid.UUID, error)
func RandomBool() bool
func RandomBytes(size int) []byte
func RandomDate() time.Time
func RandomElement[T any](slice []T) T
func RandomElements[T any](slice []T, idx int) []T
func RandomFloat(maxExclusive int) float64
func RandomIcon() string
func RandomInt(maxExclusive int) int
func RandomInt64(maxExclusive int64) int64
func RandomString(length int) string
func RandomURL() *url.URL
func ReplaceEnvVars(s string, logger Logger) string
func RunProcess(cmd string, path string, in io.Reader, out io.Writer, er io.Writer, ...) (int, error)
func RunProcessSimple(cmd string, path string) (int, string, error)
func StartProcess(cmd string, path string, in io.Reader, out io.Writer, er io.Writer, ...) (*exec.Cmd, error)
func StringArrayFromAny(a []any, maxLength int) []string
func StringArrayMaxLength(a []string) int
func StringArrayOxfordComma(names []string, separator string) string
func StringArrayQuoted(a []string) []string
func StringDetectLinebreak(s string) string
func StringForms(s string) (string, string)
func StringNullable(s fmt.Stringer) string
func StringPad(s string, size int) string
func StringPadLeft(s string, size int, chr rune) string
func StringPadRight(s string, size int, chr rune) string
func StringPlural(count int, s string) string
func StringRepeat(s string, n int) string
func StringReplaceBetween(s string, l string, r string, replacement string) (string, error)
func StringSplit(s string, sep byte, cutc bool) (string, string)
func StringSplitAndTrim(s string, delim string) []string
func StringSplitLast(s string, sep byte, cutc bool) (string, string)
func StringSplitLastOnly(s string, sep byte, cutc bool) string
func StringSplitLines(s string) []string
func StringSplitLinesIndented(s string, indent int, indentFirstLine bool, includeEmptyLines bool) []string
func StringSplitPath(s string) (string, string)
func StringSplitPathAndTrim(s string) []string
func StringSubstringBetween(s string, l string, r string) string
func StringToCamel(s string, extraAcronyms ...string) string
func StringToLowerCamel(s string, extraAcronyms ...string) string
func StringToPlural(s string) string
func StringToSingular(s string) string
func StringToSnake(s string, extraAcronyms ...string) string
func StringToTitle(s string, extraAcronyms ...string) string
func StringTruncate(s string, mx int) string
func TimeCurrent() time.Time
func TimeCurrentMillis() int64
func TimeCurrentNanos() int64
func TimeCurrentP() *time.Time
func TimeCurrentUnix() int64
func TimeFromFull(s string) (*time.Time, error)
func TimeFromFullMS(s string) (*time.Time, error)
func TimeFromHTML(s string) (*time.Time, error)
func TimeFromJS(s string) (*time.Time, error)
func TimeFromRFC3339(s string) (*time.Time, error)
func TimeFromString(s string) (*time.Time, error)
func TimeFromStringFmt(s string, fmt string) (*time.Time, error)
func TimeFromStringSimple(s string) *time.Time
func TimeFromVerbose(s string) (*time.Time, error)
func TimeFromYMD(s string) (*time.Time, error)
func TimeMax(ts ...*time.Time) *time.Time
func TimeMin(ts ...*time.Time) *time.Time
func TimeRelative(t *time.Time) string
func TimeToFull(d *time.Time) string
func TimeToFullMS(d *time.Time) string
func TimeToHTML(d *time.Time) string
func TimeToHours(d *time.Time) string
func TimeToJS(d *time.Time) string
func TimeToJSFull(d *time.Time) string
func TimeToMap(t time.Time) map[string]any
func TimeToRFC3339(d *time.Time) string
func TimeToString(d *time.Time, fmt string) string
func TimeToVerbose(d *time.Time) string
func TimeToYMD(d *time.Time) string
func TimeToday() *time.Time
func TimeTruncate(t *time.Time) *time.Time
func ToCSV(data any) ([]string, [][]string, error)
func ToCSVBytes(data any) ([]byte, error)
func ToJSON(x any) string
func ToJSONBytes(x any, indent bool) []byte
func ToJSONCompact(x any) string
func ToTOML(x any) string
func ToTOMLBytes(x any) []byte
func ToXML(x any) (string, error)
func ToXMLBytes(x any, indent bool) ([]byte, error)
func ToXMLCompact(x any) (string, error)
func UUID() uuid.UUID
func UUIDFromString(s string) *uuid.UUID
func UUIDFromStringOK(s string) uuid.UUID
func UUIDP() *uuid.UUID
func UUIDString(u *uuid.UUID) string
func UUIDV7() uuid.UUID
func UUIDV7P() *uuid.UUID
func ValueMapGet[T any](m ValueMap, pth string) (T, error)
type DebugInfo
- func DebugGetInfo(version string, started time.Time) *DebugInfo
type Diff
- func NewDiff(p string, o string, n string) *Diff
- func (d Diff) String() string
- func (d Diff) StringVerbose() string
type Diffs
- func DiffObjects(l any, r any, path ...string) Diffs
- func DiffObjectsIgnoring(l any, r any, ignored []string, path ...string) Diffs
- func RandomDiffs(size int) Diffs
- func (d Diffs) Sorted() Diffs
- func (d Diffs) String() string
- func (d Diffs) StringVerbose() string
type DiffsSet
- func (d DiffsSet) Keys() []string
type ErrorDetail
- func GetErrorDetail(e error, includeStack bool) *ErrorDetail
type ErrorFrame
- func TraceDetail(trace errors.StackTrace) []ErrorFrame
type FieldDesc
- func (d FieldDesc) Parse(q any) (any, error)
type FieldDescResults
- func FieldDescsCollect(r *http.Request, args FieldDescs) *FieldDescResults
- func (a *FieldDescResults) HasMissing() bool
type FieldDescs
- func (d FieldDescs) Get(key string) *FieldDesc
- func (d FieldDescs) Keys() []string
type HTTPRequest
- func NewHTTPGet(ctx context.Context, url string) *HTTPRequest
- func NewHTTPPost(ctx context.Context, url string, body io.Reader) *HTTPRequest
- func NewHTTPRequest(ctx context.Context, method string, url string, bodies ...io.Reader) *HTTPRequest
- func (r *HTTPRequest) Run() (*http.Response, error)
- func (r *HTTPRequest) RunSimple() (*http.Response, []byte, error)
- func (r *HTTPRequest) WithClient(c *http.Client) *HTTPRequest
- func (r *HTTPRequest) WithHeader(k string, v string) *HTTPRequest
type KeyTypeDesc
- func (k *KeyTypeDesc) Array(key string) []string
- func (k *KeyTypeDesc) Matches(x *KeyTypeDesc) bool
- func (k *KeyTypeDesc) String() string
type KeyTypeDescs
- func (k KeyTypeDescs) Array(key string) [][]string
- func (k KeyTypeDescs) Sort() KeyTypeDescs
- func (k KeyTypeDescs) Strings() []string
type KeyVal
- func (k KeyVal[T]) String() string
type KeyVals
- func (k KeyVals[T]) String() string
- func (k KeyVals[T]) ToMap() map[string]T
- func (k KeyVals[T]) Values() []T
type Logger
type NilBool
- func (n NilBool) MarshalJSON() ([]byte, error)
- func (n *NilBool) UnmarshalJSON(data []byte) error
type NilFloat64
- func (n NilFloat64) MarshalJSON() ([]byte, error)
- func (n *NilFloat64) UnmarshalJSON(data []byte) error
type NilInt32
- func (n NilInt32) MarshalJSON() ([]byte, error)
- func (n *NilInt32) UnmarshalJSON(data []byte) error
type NilInt64
- func (n NilInt64) MarshalJSON() ([]byte, error)
- func (n *NilInt64) UnmarshalJSON(data []byte) error
type NilJSON
- func (n NilJSON) MarshalJSON() ([]byte, error)
- func (n *NilJSON) UnmarshalJSON(data []byte) error
type NilString
- func (n NilString) MarshalJSON() ([]byte, error)
- func (n *NilString) UnmarshalJSON(data []byte) error
type NilTime
- func (n NilTime) MarshalJSON() ([]byte, error)
- func (n *NilTime) UnmarshalJSON(data []byte) error
type Node
- func (n *Node[T]) Flatten(curr string) []string
- func (n *Node[T]) Get(pth ...string) *Node[T]
type Nodes
- func (n Nodes[T]) Flatten(curr string) []string
- func (n Nodes[T]) Get(pth ...string) *Node[T]
- func (n Nodes[T]) Merge(x Nodes[T]) Nodes[T]
- func (n Nodes[T]) Sort() Nodes[T]
type OrderedMap
- func NewOMap[V any]() *OrderedMap[V]
- func NewOrderedMap[V any](lexical bool, capacity int) *OrderedMap[V]
- func (o *OrderedMap[V]) Append(k string, v V)
- func (o *OrderedMap[V]) Clone() *OrderedMap[V]
- func (o *OrderedMap[V]) Get(k string) (V, bool)
- func (o *OrderedMap[V]) GetSimple(k string) V
- func (o *OrderedMap[V]) HasKey(k string) bool
- func (o *OrderedMap[V]) IndexOf(k string) int
- func (o OrderedMap[V]) MarshalJSON() ([]byte, error)
- func (o OrderedMap[V]) MarshalXML(e *xml.Encoder, start xml.StartElement) error
- func (o OrderedMap[V]) MarshalYAML() (any, error)
- func (o *OrderedMap[V]) Pairs() []*OrderedPair[V]
- func (o *OrderedMap[V]) Remove(k string)
- func (o *OrderedMap[V]) Set(k string, v V)
- func (o *OrderedMap[V]) UnmarshalJSON(b []byte) error
type OrderedPair
type Pkg
- func (p Pkg) Drop(n int) Pkg
- func (p Pkg) Equals(other Pkg) bool
- func (p Pkg) Last() string
- func (p Pkg) Push(name string) Pkg
- func (p Pkg) Quoted(quote string) string
- func (p Pkg) Shift() Pkg
- func (p Pkg) StartsWith(t Pkg) bool
- func (p Pkg) String() string
- func (p Pkg) StringWith(extra ...string) string
- func (p Pkg) ToPath(extra ...string) string
- func (p Pkg) Trim(src Pkg) Pkg
- func (p Pkg) With(key string) Pkg
type Progress
- func NewProgress(key string, total int, fns ...func(p *Progress, delta int)) *Progress
- func (p *Progress) Increment(i int, logger Logger)
- func (p *Progress) String() string
type Set
- func NewSet[T cmp.Ordered](capacity ...int) *Set[T]
- func (s *Set[T]) Clone() *Set[T]
- func (s *Set[T]) Contains(x T) bool
- func (s *Set[T]) Entries() []T
- func (s Set[T]) MarshalJSON() ([]byte, error)
- func (s Set[T]) MarshalXML(e *xml.Encoder, start xml.StartElement) error
- func (s Set[T]) MarshalYAML() (any, error)
- func (s *Set[T]) Remove(x T)
- func (s *Set[T]) Set(v T)
- func (s *Set[T]) UnmarshalJSON(b []byte) error
type StringSlice
- func NewStringSlice(a []string) *StringSlice
- func (s *StringSlice) Empty() bool
- func (s *StringSlice) Join(x string) string
- func (s *StringSlice) Push(strs ...string)
- func (s *StringSlice) Pushf(msg string, args ...any)
- func (s *StringSlice) Sort()
- func (s *StringSlice) String() string
type Timer
- func TimerStart() *Timer
- func (t *Timer) Elapsed() int
- func (t *Timer) End() int
- func (t *Timer) EndString() string
- func (t *Timer) String() string
type Tree
- func (t Tree[T]) Flatten() []string
- func (t Tree[T]) Merge(x *Tree[T]) *Tree[T]
type ValueMap
- func FromJSONMap(msg json.RawMessage) (ValueMap, error)
- func FromTOMLMap(msg []byte) (ValueMap, error)
- func FromXMLMap(msg []byte) (ValueMap, error)
- func ParseArrayMap(r any, path string, allowEmpty bool) ([]ValueMap, error)
- func ParseMap(r any, path string, allowEmpty bool) (ValueMap, error)
- func RandomValueMap(keys int) ValueMap
- func ValueMapFor(kvs ...any) ValueMap
- func ValueMapFrom(m map[string]any) ValueMap
- func (m ValueMap) Add(kvs ...any)
- func (m ValueMap) AsChanges() (ValueMap, error)
- func (m ValueMap) AsMap(simplify bool) map[string]any
- func (m ValueMap) Clone() ValueMap
- func (m ValueMap) Filter(keys []string) ValueMap
- func (m ValueMap) GetArray(key string, allowEmpty bool) ([]any, error)
- func (m ValueMap) GetArrayOpt(key string) []any
- func (m ValueMap) GetBool(key string, allowEmpty bool) (bool, error)
- func (m ValueMap) GetBoolOpt(key string) bool
- func (m ValueMap) GetFloat(key string, allowEmpty bool) (float64, error)
- func (m ValueMap) GetFloatArray(key string, allowEmpty bool) ([]float64, error)
- func (m ValueMap) GetFloatOpt(key string) float64
- func (m ValueMap) GetInt(key string, allowEmpty bool) (int, error)
- func (m ValueMap) GetInt64(key string, allowEmpty bool) (int64, error)
- func (m ValueMap) GetIntArray(key string, allowEmpty bool) ([]int, error)
- func (m ValueMap) GetIntOpt(key string) int
- func (m ValueMap) GetMap(key string, allowEmpty bool) (ValueMap, error)
- func (m ValueMap) GetMapArray(key string, allowEmpty bool) ([]ValueMap, error)
- func (m ValueMap) GetMapOpt(key string) ValueMap
- func (m ValueMap) GetPath(path string, allowMissing bool) (any, error)
- func (m ValueMap) GetRequired(k string) (any, error)
- func (m ValueMap) GetString(key string, allowEmpty bool) (string, error)
- func (m ValueMap) GetStringArray(key string, allowEmpty bool) ([]string, error)
- func (m ValueMap) GetStringArrayOpt(key string) []string
- func (m ValueMap) GetStringOpt(key string) string
- func (m ValueMap) GetStringPtr(key string) *string
- func (m ValueMap) GetTime(key string, allowEmpty bool) (*time.Time, error)
- func (m ValueMap) GetTimeOpt(key string) time.Time
- func (m ValueMap) GetType(key string, ret any) error
- func (m ValueMap) GetUUID(key string, allowEmpty bool) (*uuid.UUID, error)
- func (m ValueMap) GetUUIDOpt(key string) uuid.UUID
- func (m ValueMap) HasKey(key string) bool
- func (m ValueMap) JSON() string
- func (m ValueMap) Keys() []string
- func (m ValueMap) KeysAndValues() ([]string, []any)
- func (m ValueMap) MarshalXML(e *xml.Encoder, _ xml.StartElement) error
- func (m ValueMap) Merge(args ...ValueMap) ValueMap
- func (m ValueMap) Overwrite(sourceMap ValueMap) ValueMap
- func (m ValueMap) ParseArray(path string, allowMissing bool, allowEmpty bool, coerce bool) ([]any, error)
- func (m ValueMap) ParseArrayFloat(path string, allowMissing bool, allowEmpty bool) ([]float64, error)
- func (m ValueMap) ParseArrayInt(path string, allowMissing bool, allowEmpty bool) ([]int, error)
- func (m ValueMap) ParseArrayMap(path string, allowMissing bool, allowEmpty bool) ([]ValueMap, error)
- func (m ValueMap) ParseArrayString(path string, allowMissing bool, allowEmpty bool) ([]string, error)
- func (m ValueMap) ParseBool(path string, allowMissing bool, allowEmpty bool) (bool, error)
- func (m ValueMap) ParseFloat(path string, allowMissing bool, allowEmpty bool) (float64, error)
- func (m ValueMap) ParseInt(path string, allowMissing bool, allowEmpty bool) (int, error)
- func (m ValueMap) ParseInt64(path string, allowMissing bool, allowEmpty bool) (int64, error)
- func (m ValueMap) ParseJSON(path string, allowMissing bool, allowEmpty bool) (any, error)
- func (m ValueMap) ParseMap(path string, allowMissing bool, allowEmpty bool) (ValueMap, error)
- func (m ValueMap) ParseString(path string, allowMissing bool, allowEmpty bool) (string, error)
- func (m ValueMap) ParseTime(path string, allowMissing bool, allowEmpty bool) (*time.Time, error)
- func (m ValueMap) ParseUUID(path string, allowMissing bool, allowEmpty bool) (*uuid.UUID, error)
- func (m ValueMap) SetPath(path string, val any) error
- func (m ValueMap) String() string
- func (m ValueMap) ToQueryString() string
- func (m ValueMap) ToStringMap() map[string]string
- func (m ValueMap) With(k string, v any) ValueMap
- func (m ValueMap) WithoutKeys(keys ...string) ValueMap

Constants ¶

View Source

const (
	BoolTrue  = "true"
	BoolFalse = "false"
)

View Source

const (
	AppKey     = "projectforge"
	AppName    = "Project Forge"
	AppSummary = "Build and maintain feature-rich applications using Golang"
	AppPort    = 40000
	AppContact = "Kyle U <projectforge@kyleu.com>"
	AppURL     = "https://projectforge.dev"
	AppSource  = "https://github.com/kyleu/projectforge"
	AppLegal   = `Built by <a href="mailto:projectforge@kyleu.com">Kyle U</a>, all rights reserved`

	KeyDebug   = "debug"
	KeyError   = "error"
	KeyRandom  = "random"
	KeyStart   = "start"
	KeyUnknown = "unknown"

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

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

	OK = "ok"
	// $PF_SECTION_START(keys)$.
	DatabaseMySQL      = "mysql"
	DatabasePostgreSQL = "postgres"
	DatabaseSQLite     = "sqlite"
	DatabaseSQLServer  = "sqlserver"

	KeyDetail = "detail"
	KeySimple = "simple"

	ExtCS     = ".cs"
	ExtCSHTML = ".cshtml"
	ExtCSS    = ".css"
	ExtGo     = ".go"
	ExtHTML   = ".html"
	ExtJS     = ".js"
	ExtMod    = ".mod"
	ExtSQL    = ".sql"
	ExtSVG    = ".svg"
	ExtTS     = ".ts"
)

Variables ¶

View Source

var (
	DEBUG     = false
	ConfigDir = "."
)

View Source

var EmptyStruct = struct{}{}

View Source

var HTTPDefaultClient = http.DefaultClient

View Source

var SVGIconKeys = []string{} /* 170 elements not displayed */

View Source

var SVGLibrary = map[string]string{}/* 171 elements not displayed */

View Source

var StringDefaultLinebreak = func() string {
	if runtime.GOOS == "windows" {
		return winLB
	}
	return saneLB
}()

View Source

var UUIDDefault = uuid.UUID{}

Functions ¶

func ArrayDereference ¶ added in v0.9.29

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

func ArrayFirstN ¶ added in v0.8.15

func ArrayFirstN[V any](items []V, n int) []V

func ArrayFlatten ¶ added in v0.8.15

func ArrayFlatten[T any](arrs ...[]T) []T

func ArrayFromAny ¶ added in v0.2.32

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

func ArrayLastN ¶ added in v0.8.15

func ArrayLastN[V any](items []V, n int) []V

func ArrayLimit ¶ added in v1.4.9

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

func ArrayRemoveDuplicates ¶ added in v0.2.33

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

func ArrayRemoveEmpty ¶ added in v1.5.20

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

func ArrayRemoveNil ¶ added in v0.6.15

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

func ArraySorted ¶ added in v0.10.14

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

func ArraySplit ¶ added in v1.4.5

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

func ArrayTest ¶ added in v1.3.8

func ArrayTest(dest any) bool

func ArrayToStringArray ¶ added in v1.0.7

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

func ArrayTransform ¶ added in v1.0.6

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

func AsyncCollect ¶ added in v0.2.29

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

func AsyncCollectMap ¶ added in v0.6.9

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.6.0

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.38

func ByteSizeIEC(b int64) string

func ByteSizeSI ¶ added in v0.2.38

func ByteSizeSI(b int64) string

func Choose ¶ added in v1.0.22

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

func ConfigureAcronym ¶ added in v1.4.5

func ConfigureAcronym(key, val string)

func CountryFlag ¶ added in v0.6.3

func CountryFlag(code string) string

func CycleJSON ¶

func CycleJSON(src any, tgt any) error

func CycleXML ¶ added in v1.1.0

func CycleXML(src any, tgt any) error

func DebugBuildInfo ¶ added in v0.11.5

func DebugBuildInfo() *debug.BuildInfo

func DebugMemStats ¶ added in v0.11.5

func DebugMemStats() *runtime.MemStats

func DebugStartCPUProfile ¶ added in v0.11.5

func DebugStartCPUProfile() error

func DebugTakeHeapProfile ¶ added in v0.11.5

func DebugTakeHeapProfile() error

func DecryptMessage ¶

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

func DefaultIfNil ¶ added in v0.7.21

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

func DefaultValue ¶ added in v1.4.5

func DefaultValue[T any]() T

func EncryptMessage ¶

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

func ErrorMerge ¶ added in v0.3.15

func ErrorMerge(errs ...error) error

func Filename ¶ added in v1.0.6

func Filename(s string) string

func FormatSeconds ¶ added in v1.2.18

func FormatSeconds(x float64) string

func FormatSecondsFull ¶ added in v1.2.19

func FormatSecondsFull(x float64) string

func FromJSON ¶

func FromJSON(msg json.RawMessage, tgt any) error

func FromJSONAny ¶ added in v1.1.0

func FromJSONAny(msg json.RawMessage) (any, error)

func FromJSONAnyOK ¶ added in v1.5.17

func FromJSONAnyOK(msg json.RawMessage) any

func FromJSONObj ¶ added in v1.3.7

func FromJSONObj[T any](msg json.RawMessage) (T, error)

func FromJSONReader ¶

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

func FromJSONStrict ¶

func FromJSONStrict(msg json.RawMessage, tgt any) error

func FromJSONString ¶ added in v0.11.14

func FromJSONString(msg json.RawMessage) (string, error)

func FromTOML ¶ added in v1.3.0

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

func FromTOMLAny ¶ added in v1.3.0

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

func FromTOMLReader ¶ added in v1.3.0

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

func FromTOMLStrict ¶ added in v1.3.0

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

func FromTOMLString ¶ added in v1.3.0

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

func FromXML ¶ added in v1.1.0

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

func FromXMLAny ¶ added in v1.1.0

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

func FromXMLReader ¶ added in v1.1.0

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

func FromXMLStrict ¶ added in v1.1.0

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

func FromXMLString ¶ added in v1.1.0

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

func GetEnv ¶ added in v0.2.9

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

func GetEnvBool ¶ added in v0.2.14

func GetEnvBool(name string, defaultValue bool) bool

func GetEnvDuration ¶ added in v0.3.8

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

func GetEnvInt ¶ added in v0.3.1

func GetEnvInt(name string, defaultValue int) int

func HashFNV128UUID ¶ added in v1.0.9

func HashFNV128UUID(s string) uuid.UUID

func HashFNV32 ¶

func HashFNV32(s string) uint32

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 v1.0.6

func InitAcronyms(extras ...string) error

func JSONToMap ¶

func JSONToMap(i any) map[string]any

func JoinLines ¶ added in v1.1.0

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

func JoinLinesFull ¶ added in v1.1.0

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

func LengthAny ¶ added in v0.2.32

func LengthAny(dest any) int

func MapError ¶ added in v1.0.7

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

func MapGetOrElse ¶ added in v1.4.3

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

func MarkdownTable ¶ added in v0.2.9

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

func MarkdownTableParse ¶ added in v1.0.21

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

func MicrosToMillis ¶

func MicrosToMillis(i int) string

func OrDefault ¶ added in v1.4.5

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

func ParseArray ¶ added in v1.4.3

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

func ParseArrayFloat ¶ added in v1.4.3

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

func ParseArrayInt ¶ added in v1.4.3

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

func ParseArrayString ¶ added in v1.4.3

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

func ParseBool ¶ added in v1.4.3

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

func ParseFloat ¶ added in v1.4.3

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

func ParseInt ¶ added in v1.4.3

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

func ParseInt64 ¶ added in v1.5.24

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

func ParseJSON ¶ added in v1.5.16

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

func ParseString ¶ added in v1.4.3

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

func ParseTime ¶ added in v1.4.3

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

func ParseUUID ¶ added in v1.4.3

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

func RandomBool ¶

func RandomBool() bool

func RandomBytes ¶

func RandomBytes(size int) []byte

func RandomDate ¶

func RandomDate() time.Time

func RandomElement ¶ added in v1.4.7

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

func RandomElements ¶ added in v1.0.12

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

func RandomFloat ¶ added in v0.5.1

func RandomFloat(maxExclusive int) float64

func RandomIcon ¶ added in v1.0.5

func RandomIcon() string

func RandomInt ¶

func RandomInt(maxExclusive int) int

func RandomInt64 ¶ added in v1.5.24

func RandomInt64(maxExclusive int64) int64

func RandomString ¶

func RandomString(length int) string

func RandomURL ¶ added in v1.2.18

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.6.10

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

func StringArrayFromAny ¶ added in v1.1.1

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 StringDetectLinebreak ¶ added in v0.10.23

func StringDetectLinebreak(s string) string

func StringForms ¶

func StringForms(s string) (string, string)

func StringNullable ¶ added in v1.1.0

func StringNullable(s fmt.Stringer) string

func StringPad ¶

func StringPad(s string, size int) string

func StringPadLeft ¶ added in v0.7.10

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

func StringPadRight ¶ added in v0.7.10

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

func StringPlural ¶

func StringPlural(count int, s string) string

func StringRepeat ¶

func StringRepeat(s string, n int) string

func StringReplaceBetween ¶ added in v0.7.5

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

func StringSplit ¶

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

func StringSplitAndTrim ¶

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

func StringSplitLast ¶

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

func StringSplitLastOnly ¶ added in v0.10.20

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

func StringSplitLines ¶ added in v0.10.23

func StringSplitLines(s string) []string

func StringSplitLinesIndented ¶ added in v0.12.3

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

func StringSplitPath ¶ added in v0.10.20

func StringSplitPath(s string) (string, string)

func StringSplitPathAndTrim ¶ added in v0.10.19

func StringSplitPathAndTrim(s string) []string

func StringSubstringBetween ¶ added in v0.7.5

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

func StringToCamel ¶

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

func StringToLowerCamel ¶

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

func StringToPlural ¶

func StringToPlural(s string) string

func StringToSingular ¶

func StringToSingular(s string) string

func StringToSnake ¶ added in v0.3.15

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.10.14

func TimeCurrent() time.Time

func TimeCurrentMillis ¶

func TimeCurrentMillis() int64

func TimeCurrentNanos ¶ added in v0.10.14

func TimeCurrentNanos() int64

func TimeCurrentP ¶ added in v0.10.14

func TimeCurrentP() *time.Time

func TimeCurrentUnix ¶ added in v0.10.14

func TimeCurrentUnix() int64

func TimeFromFull ¶

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

func TimeFromFullMS ¶ added in v1.0.16

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 TimeFromRFC3339 ¶ added in v1.0.26

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

func TimeFromString ¶

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

func TimeFromStringFmt ¶

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

func TimeFromStringSimple ¶ added in v1.0.12

func TimeFromStringSimple(s string) *time.Time

func TimeFromVerbose ¶ added in v0.9.17

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

func TimeFromYMD ¶

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

func TimeMax ¶ added in v1.4.3

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

func TimeMin ¶ added in v1.4.3

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

func TimeRelative ¶

func TimeRelative(t *time.Time) string

func TimeToFull ¶

func TimeToFull(d *time.Time) string

func TimeToFullMS ¶ added in v1.0.16

func TimeToFullMS(d *time.Time) string

func TimeToHTML ¶

func TimeToHTML(d *time.Time) string

func TimeToHours ¶ added in v1.0.21

func TimeToHours(d *time.Time) string

func TimeToJS ¶

func TimeToJS(d *time.Time) string

func TimeToJSFull ¶ added in v1.2.18

func TimeToJSFull(d *time.Time) string

func TimeToMap ¶ added in v0.6.3

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

func TimeToRFC3339 ¶ added in v1.0.26

func TimeToRFC3339(d *time.Time) string

func TimeToString ¶

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

func TimeToVerbose ¶ added in v0.9.17

func TimeToVerbose(d *time.Time) string

func TimeToYMD ¶

func TimeToYMD(d *time.Time) string

func TimeToday ¶ added in v0.7.0

func TimeToday() *time.Time

func TimeTruncate ¶ added in v0.7.2

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

func ToCSV ¶ added in v1.1.0

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

func ToCSVBytes ¶ added in v1.1.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 v1.3.0

func ToTOML(x any) string

func ToTOMLBytes ¶ added in v1.3.0

func ToTOMLBytes(x any) []byte

func ToXML ¶ added in v1.1.0

func ToXML(x any) (string, error)

func ToXMLBytes ¶ added in v1.1.0

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

func ToXMLCompact ¶ added in v1.1.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.8.24

func UUIDFromStringOK(s string) uuid.UUID

func UUIDP ¶

func UUIDP() *uuid.UUID

func UUIDString ¶ added in v0.6.24

func UUIDString(u *uuid.UUID) string

func UUIDV7 ¶ added in v1.5.6

func UUIDV7() uuid.UUID

func UUIDV7P ¶ added in v1.5.6

func UUIDV7P() *uuid.UUID

func ValueMapGet ¶ added in v1.4.5

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.11.5

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

type Diff ¶

type Diff struct {
	Path string `json:"path"`
	Old  string `json:"o,omitempty"`
	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.5.6

func (d Diff) StringVerbose() string

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 v1.2.22

func (d Diffs) Sorted() Diffs

func (Diffs) String ¶

func (d Diffs) String() string

func (Diffs) StringVerbose ¶ added in v0.5.6

func (d Diffs) StringVerbose() string

type DiffsSet ¶ added in v1.0.9

type DiffsSet map[string]Diffs

func (DiffsSet) Keys ¶ added in v1.5.17

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,omitempty" 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.12.0

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

func (FieldDesc) Parse ¶ added in v1.2.17

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

type FieldDescResults ¶ added in v1.5.5

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

func FieldDescsCollect ¶ added in v1.5.5

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

func (*FieldDescResults) HasMissing ¶ added in v1.5.5

func (a *FieldDescResults) HasMissing() bool

type FieldDescs ¶ added in v0.12.0

type FieldDescs []*FieldDesc

func (FieldDescs) Get ¶ added in v1.2.17

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

func (FieldDescs) Keys ¶ added in v1.1.0

func (d FieldDescs) Keys() []string

type HTTPRequest ¶ added in v1.4.5

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

func NewHTTPGet ¶ added in v1.5.22

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

func NewHTTPPost ¶ added in v1.5.22

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

func NewHTTPRequest ¶ added in v1.4.5

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

func (*HTTPRequest) Run ¶ added in v1.4.11

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

func (*HTTPRequest) RunSimple ¶ added in v1.4.5

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

func (*HTTPRequest) WithClient ¶ added in v1.4.5

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

func (*HTTPRequest) WithHeader ¶ added in v1.4.5

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

type KeyTypeDesc ¶ added in v0.2.9

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

func (*KeyTypeDesc) Array ¶ added in v0.2.9

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

func (*KeyTypeDesc) Matches ¶ added in v1.2.16

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

func (*KeyTypeDesc) String ¶ added in v1.5.14

func (k *KeyTypeDesc) String() string

type KeyTypeDescs ¶ added in v0.2.9

type KeyTypeDescs []*KeyTypeDesc

func (KeyTypeDescs) Array ¶ added in v0.2.9

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

func (KeyTypeDescs) Sort ¶ added in v0.2.9

func (k KeyTypeDescs) Sort() KeyTypeDescs

func (KeyTypeDescs) Strings ¶ added in v1.5.14

func (k KeyTypeDescs) Strings() []string

type KeyVal ¶ added in v0.8.17

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

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

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

type KeyVals ¶ added in v0.8.17

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

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

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

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

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

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

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

type Logger ¶ added in v0.2.35

type Logger = *zap.SugaredLogger

var RootLogger Logger

type NilBool ¶ added in v1.2.7

type NilBool struct {
	sql.NullBool
}

func (NilBool) MarshalJSON ¶ added in v1.2.7

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

func (*NilBool) UnmarshalJSON ¶ added in v1.2.7

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

type NilFloat64 ¶ added in v1.2.7

type NilFloat64 struct {
	sql.NullFloat64
}

func (NilFloat64) MarshalJSON ¶ added in v1.2.7

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

func (*NilFloat64) UnmarshalJSON ¶ added in v1.2.7

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

type NilInt32 ¶ added in v1.2.7

type NilInt32 struct {
	sql.NullInt32
}

func (NilInt32) MarshalJSON ¶ added in v1.2.7

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

func (*NilInt32) UnmarshalJSON ¶ added in v1.2.7

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

type NilInt64 ¶ added in v1.2.7

type NilInt64 struct {
	sql.NullInt64
}

func (NilInt64) MarshalJSON ¶ added in v1.2.7

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

func (*NilInt64) UnmarshalJSON ¶ added in v1.2.7

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

type NilJSON ¶ added in v1.5.17

type NilJSON struct {
	sql.Null[json.RawMessage]
}

func (NilJSON) MarshalJSON ¶ added in v1.5.17

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

func (*NilJSON) UnmarshalJSON ¶ added in v1.5.17

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

type NilString ¶ added in v1.2.7

type NilString struct {
	sql.NullString
}

func (NilString) MarshalJSON ¶ added in v1.2.7

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

func (*NilString) UnmarshalJSON ¶ added in v1.2.7

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

type NilTime ¶ added in v1.2.7

type NilTime struct {
	sql.NullTime
}

func (NilTime) MarshalJSON ¶ added in v1.2.7

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

func (*NilTime) UnmarshalJSON ¶ added in v1.2.7

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

type Node ¶ added in v1.0.18

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 v1.0.18

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

func (*Node[T]) Get ¶ added in v1.0.18

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

type Nodes ¶ added in v1.0.18

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

func (Nodes[T]) Flatten ¶ added in v1.0.18

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

func (Nodes[T]) Get ¶ added in v1.0.18

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

func (Nodes[T]) Merge ¶ added in v1.0.18

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

func (Nodes[T]) Sort ¶ added in v1.0.18

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

type OrderedMap ¶

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

func NewOMap ¶ added in v1.2.21

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

func NewOrderedMap ¶

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

func (*OrderedMap[V]) Append ¶

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

func (*OrderedMap[V]) Clone ¶ added in v1.5.16

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

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 v1.2.21

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

func (*OrderedMap[V]) IndexOf ¶ added in v1.2.21

func (o *OrderedMap[V]) IndexOf(k string) 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]) Pairs ¶ added in v1.2.21

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

func (*OrderedMap[V]) Remove ¶ added in v1.2.21

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

func (*OrderedMap[V]) Set ¶ added in v1.2.21

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

func (*OrderedMap[V]) UnmarshalJSON ¶

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

type OrderedPair ¶ added in v1.2.21

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

type Pkg ¶

type Pkg []string

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 v1.4.2

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

func NewProgress ¶ added in v1.4.2

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

func (*Progress) Increment ¶ added in v1.4.2

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

func (*Progress) String ¶ added in v1.4.2

func (p *Progress) String() string

type Set ¶ added in v1.5.18

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

func NewSet ¶ added in v1.5.18

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

func (*Set[T]) Clone ¶ added in v1.5.18

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

func (*Set[T]) Contains ¶ added in v1.5.18

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

func (*Set[T]) Entries ¶ added in v1.5.18

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

func (Set[T]) MarshalJSON ¶ added in v1.5.18

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

func (Set[T]) MarshalXML ¶ added in v1.5.18

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

func (Set[T]) MarshalYAML ¶ added in v1.5.18

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

func (*Set[T]) Remove ¶ added in v1.5.18

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

func (*Set[T]) Set ¶ added in v1.5.18

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

func (*Set[T]) UnmarshalJSON ¶ added in v1.5.18

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

type StringSlice ¶ added in v1.1.1

type StringSlice struct {
	Slice []string
}

func NewStringSlice ¶ added in v1.1.1

func NewStringSlice(a []string) *StringSlice

func (*StringSlice) Empty ¶ added in v1.1.1

func (s *StringSlice) Empty() bool

func (*StringSlice) Join ¶ added in v1.1.1

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

func (*StringSlice) Push ¶ added in v1.1.1

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

func (*StringSlice) Pushf ¶ added in v1.1.1

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

func (*StringSlice) Sort ¶ added in v1.1.1

func (s *StringSlice) Sort()

func (*StringSlice) String ¶ added in v1.3.1

func (s *StringSlice) String() string

type Timer ¶ added in v0.2.9

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

func TimerStart ¶

func TimerStart() *Timer

func (*Timer) Elapsed ¶ added in v0.2.9

func (t *Timer) Elapsed() int

func (*Timer) End ¶ added in v0.2.9

func (t *Timer) End() int

func (*Timer) EndString ¶ added in v0.2.9

func (t *Timer) EndString() string

func (*Timer) String ¶ added in v0.2.9

func (t *Timer) String() string

type Tree ¶ added in v1.0.18

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

func (Tree[T]) Flatten ¶ added in v1.0.18

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

func (Tree[T]) Merge ¶ added in v1.0.18

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

type ValueMap ¶

type ValueMap map[string]any

func FromJSONMap ¶ added in v0.11.14

func FromJSONMap(msg json.RawMessage) (ValueMap, error)

func FromTOMLMap ¶ added in v1.3.0

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

func FromXMLMap ¶ added in v1.1.0

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

func ParseArrayMap ¶ added in v1.4.3

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

func ParseMap ¶ added in v1.4.3

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

func RandomValueMap ¶

func RandomValueMap(keys int) ValueMap

func ValueMapFor ¶

func ValueMapFor(kvs ...any) ValueMap

func ValueMapFrom ¶ added in v1.5.24

func ValueMapFrom(m map[string]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 v1.5.21

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

func (ValueMap) Clone ¶

func (m ValueMap) Clone() ValueMap

func (ValueMap) Filter ¶ added in v0.7.13

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 v1.0.7

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

func (ValueMap) GetBool ¶

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

func (ValueMap) GetBoolOpt ¶ added in v0.2.33

func (m ValueMap) GetBoolOpt(key string) bool

func (ValueMap) GetFloat ¶

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

func (ValueMap) GetFloatArray ¶ added in v1.0.7

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

func (ValueMap) GetFloatOpt ¶ added in v1.0.7

func (m ValueMap) GetFloatOpt(key string) 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) GetIntArray ¶ added in v1.0.7

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

func (ValueMap) GetIntOpt ¶ added in v0.6.4

func (m ValueMap) GetIntOpt(key string) int

func (ValueMap) GetMap ¶

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

func (ValueMap) GetMapArray ¶ added in v1.0.7

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

func (ValueMap) GetMapOpt ¶ added in v1.0.7

func (m ValueMap) GetMapOpt(key string) 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) 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 v1.0.7

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

func (ValueMap) GetStringOpt ¶

func (m ValueMap) GetStringOpt(key string) string

func (ValueMap) GetStringPtr ¶ added in v0.8.23

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 v1.0.7

func (m ValueMap) GetTimeOpt(key string) 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 v1.0.7

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

func (ValueMap) HasKey ¶ added in v1.0.10

func (m ValueMap) HasKey(key string) bool

func (ValueMap) JSON ¶ added in v1.4.4

func (m ValueMap) JSON() string

func (ValueMap) Keys ¶

func (m ValueMap) Keys() []string

func (ValueMap) KeysAndValues ¶

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

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.7.13

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 v1.0.7

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

func (ValueMap) ParseArrayInt ¶ added in v0.3.16

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

func (ValueMap) ParseArrayMap ¶ added in v1.0.7

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

func (ValueMap) ParseArrayString ¶ added in v0.3.16

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) ParseInt64 ¶ added in v1.5.24

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

func (ValueMap) ParseJSON ¶ added in v1.5.16

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) SetPath ¶

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

func (ValueMap) String ¶ added in v1.1.0

func (m ValueMap) String() string

func (ValueMap) ToQueryString ¶

func (m ValueMap) ToQueryString() string

func (ValueMap) ToStringMap ¶ added in v0.11.6

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

func (ValueMap) With ¶ added in v1.5.21

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

func (ValueMap) WithoutKeys ¶ added in v1.2.10

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

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL