util

package

Go to main page

Versions in this module

v0

v0.6.9

Mar 8, 2026

Changes in this version

+ const KeyEllipsis

+ const KeyOK

+ const KeySuccess

v0.6.8

Jan 31, 2026

Changes in this version

+ func Acronym(s string) string

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

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

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

v0.6.7

Jan 3, 2026

v0.6.6

Dec 29, 2025

Changes in this version

+ const KeyMap

+ const UUIDRegex

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

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

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

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

+ func IsNil(x any) bool

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

+ 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[K comparable, V any, NV any](m map[K]V, fn func(k K, v V) (NV, error)) (map[K]NV, error)

+ func RandomID() string

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

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

type OrderedMap

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

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

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

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

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

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

type Pkg

+ func NewPkgSplit(s string, delim string) Pkg

+ type Str string

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

+ func (s Str) Contains(x string) bool

+ func (s Str) ContainsAny(x string) bool

+ func (s Str) ContainsRune(chr rune) bool

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

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

+ func (s Str) DetectLinebreak() string

+ func (s Str) Empty() bool

+ func (s Str) Equal(x string) bool

+ func (s Str) EqualFold(x string) bool

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

+ func (s Str) HasPrefix(prefix string) bool

+ func (s Str) HasSuffix(suffix string) bool

+ func (s Str) Index(substring string) int

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

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

+ func (s Str) Length() int

+ func (s Str) OrDefault(dflt string) Str

+ func (s Str) Pad(size int) Str

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

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

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

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

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

+ func (s Str) Repeat(n int) Str

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

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

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

+ func (s Str) Split(delim string) Strings

+ func (s Str) SplitAndTrim(delim string) Strings

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

+ func (s Str) SplitLines() Strings

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

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

+ func (s Str) SplitPathAndTrim() Strings

+ func (s Str) String() string

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

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

+ func (s Str) ToCamel() Str

+ func (s Str) ToKebab() Str

+ func (s Str) ToLower() Str

+ func (s Str) ToProper() Str

+ func (s Str) ToSnake() Str

+ func (s Str) ToUpper() Str

+ func (s Str) TrimPrefix(prefix string) Str

+ func (s Str) TrimSpace() Str

+ func (s Str) TrimSuffix(suffix string) Str

+ func (s Str) Truncate(mx int) Str

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

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

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

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

type StringSlice

+ func NewStringSliceWithSize(size int) *StringSlice

+ func (s *StringSlice) JoinCommas() string

+ func (s *StringSlice) JoinSimple() string

+ func (s *StringSlice) JoinSpace() string

+ func (s *StringSlice) Length() int

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

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

+ type Strings []Str

+ func Strs(strs ...string) Strings

+ func (s Strings) Empty() bool

+ func (s Strings) Join(delim string) Str

+ func (s Strings) Strings() []string

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

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

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

+ type ToOrderedMapAny interface

+ ToOrderedMapAny func() *OrderedMap[any]

type ValueMap

+ func (m ValueMap) Empty() bool

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

+ func (m ValueMap) GetRichStringOpt(key string) Str

+ func (m ValueMap) Length() int

v0.6.5

Dec 14, 2025

v0.6.4

Dec 6, 2025

v0.6.3

Nov 30, 2025

Changes in this version

+ func FormatMilliseconds(x float64, includeFraction bool) string

+ func MillisToString(i int) string

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

v0.6.2

Nov 28, 2025

v0.6.1

Nov 22, 2025

Changes in this version

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

type StringSlice

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

v0.6.0

Oct 18, 2025

Changes in this version

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

type MergeSet

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

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

type StringSlice

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

v0.5.24

Oct 11, 2025

Changes in this version

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

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

+ type Diffable interface

+ Diff func(other any, path []string, ignored ...string) Diffs

type OrderedMap

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

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

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

type ValueMap

+ func ValueMapFromAny(x any) (ValueMap, error)

+ func ValueMapFromAnyOK(x any) ValueMap

+ func (m ValueMap) ToMap() ValueMap

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

v0.5.23

Sep 28, 2025

Changes in this version

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

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

+ func EncodeBytes(b []byte) string

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

type Diffs

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

type FieldDesc

+ func (d *FieldDesc) DefaultBool() bool

+ func (d *FieldDesc) DefaultFloat() float64

+ func (d *FieldDesc) DefaultInt() int

+ type MergeSet struct

+ Map map[K]T

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

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

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

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

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

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

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

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