stdlib

Jan 27, 2026

Changes in this version

+ func MustVE[T any](v T, err error) T

Jan 23, 2026

Changes in this version

+ func Unwrap(v any) (any, bool)

Jan 23, 2026

Changes in this version

+ func MustUint(value any) uint

+ func Uint(value any) (uint, error)

Jan 23, 2026

Changes in this version

+ func MustOptionApply[T any](t T, options ...Option[T]) T

Jan 23, 2026

Changes in this version

+ func MustBytes(value any) []byte

+ func MustDate(value any) time.Time

+ func MustFloat32(value any) float32

+ func MustFloat64(value any) float64

+ func MustInt16(value any) int16

+ func MustInt32(value any) int32

+ func MustInt64(value any) int64

+ func MustInt8(value any) int8

+ func MustTimestamp(value any) time.Time

+ func MustTimestampMs(value any) time.Time

+ func MustTimestampS(value any) time.Time

+ func MustUint16(value any) uint16

+ func MustUint32(value any) uint32

+ func MustUint64(value any) uint64

+ func MustUint8(value any) uint8

+ func MustUtf8(value any) string

type ListType

+ func MustList(value any) *ListType

Jan 23, 2026

Changes in this version

+ func MustV[T any](v T, err error) T

Jan 23, 2026

Changes in this version

+ func Int(value any) (int, error)

Nov 3, 2025

Changes in this version

+ func ReturnGlobal(random *Random)

+ type Random struct

+ Rand *rand.Rand

+ Seed int64

+ Source rand.Source

+ func GetGlobal() *Random

+ func NewRandom(seed int64) *Random

Sep 26, 2025

Changes in this version

type DataType

+ const DataTypeInt128

+ const DataTypeUint128

Jan 24, 2025

Changes in this version

+ var DefaultCancelFn = func(context.Context) error

+ var DefaultCancelTimeout = 30 * time.Second

+ var DefaultTaskTimeout = 30 * time.Second

+ var ErrTaskTimeout = Error

+ func Task(ctx context.Context, task TaskFn, options ...Option[*TaskConfig]) error

type Option

+ func WithTaskCancel(fn TaskCancelFn) Option[*TaskConfig]

+ func WithTaskTimeout(timeout time.Duration) Option[*TaskConfig]

+ type TaskCancelFn func(ctx context.Context) error

+ type TaskConfig struct

+ Cancel TaskCancelFn

+ CancelTimeout time.Duration

+ Timeout time.Duration

+ type TaskFn func(context.Context) error

Jan 7, 2025

Changes in this version

+ func Timestamp(value any) (time.Time, error)

type DataType

+ const DataTypeList

+ const DataTypeTimestamp

+ func ReflectTypeToDataType(rt reflect.Type) (DataType, error)

+ type ListType struct

+ ItemType DataType

+ Items []any

+ func List(value any) (*ListType, error)

Dec 10, 2024

Changes in this version

+ func Dereference[T any](t *T) T

+ func SafeDereference[T any](t *T) T

Nov 26, 2024

Changes in this version

+ var ErrConversionNotSupported = Error

+ var ErrInvalidDataType = fmt.Errorf("not a valid DataType, try [%s]", strings.Join(_DataTypeNames, ", "))

+ var ErrPrecisionLoss = Error

+ func Bool(value any) (bool, error)

+ func Bytes(value any) ([]byte, error)

+ func DataTypeConvert(dt DataType, value any) (any, error)

+ func DataTypeNames() []string

+ func Date(value any) (time.Time, error)

+ func Float32(value any) (float32, error)

+ func Float64(value any) (float64, error)

+ func Int16(value any) (int16, error)

+ func Int32(value any) (int32, error)

+ func Int64(value any) (int64, error)

+ func Int8(value any) (int8, error)

+ func Null(value any) (any, error)

+ func TimestampMs(value any) (time.Time, error)

+ func TimestampS(value any) (time.Time, error)

+ func Uint16(value any) (uint16, error)

+ func Uint32(value any) (uint32, error)

+ func Uint64(value any) (uint64, error)

+ func Uint8(value any) (uint8, error)

+ func Utf8(value any) (string, error)

+ type DataType string

+ const DataTypeBool

+ const DataTypeBytes

+ const DataTypeDate

+ const DataTypeFloat32

+ const DataTypeFloat64

+ const DataTypeInt16

+ const DataTypeInt32

+ const DataTypeInt64

+ const DataTypeInt8

+ const DataTypeNull

+ const DataTypeTimestampMs

+ const DataTypeTimestampS

+ const DataTypeUint16

+ const DataTypeUint32

+ const DataTypeUint64

+ const DataTypeUint8

+ const DataTypeUtf8

+ func ParseDataType(name string) (DataType, error)

+ func (x *DataType) UnmarshalText(text []byte) error

+ func (x DataType) IsValid() bool

+ func (x DataType) MarshalText() ([]byte, error)

+ func (x DataType) String() string

Oct 22, 2024

Changes in this version

+ type CloserFn func() error

+ func (fn CloserFn) Close() error

Oct 18, 2024

Changes in this version

+ func DeferCloserToGroup(c **CloserGroup, closer ...io.Closer) io.Closer

+ type CloserGroup struct

+ Closers []io.Closer

+ func CloserJoin(closer io.Closer, closers ...io.Closer) *CloserGroup

+ func NewCloserGroup(closers ...io.Closer) *CloserGroup

+ func (g *CloserGroup) Append(closers ...io.Closer)

+ func (g *CloserGroup) Close() error

Oct 15, 2024

Changes in this version

+ var TimestampLayouts = [3]string

+ func MustTime[T any](value T) time.Duration

+ func ToTime[T any](value T) (time.Time, error)

Oct 10, 2024

Changes in this version

+ func ZeroPad[T constraints.Integer](width T, v T) string

Sep 25, 2024

Changes in this version

+ var Seed int64

Sep 24, 2024

Changes in this version

+ func RandomExcluding[T comparable](fn func() T, exclude map[T]struct{}) T

Sep 24, 2024

Changes in this version

+ var Rand *rand.Rand

+ var Source rand.Source

Sep 24, 2024

Changes in this version

+ var FakeRequestKey = NewContextKey[*FakeRequest]("stdlib.FakeRequest", &FakeRequest{ ... })

+ func FakeContext(ctx context.Context, count uint64) context.Context

+ func RandomNumberRange[T constraints.Integer | constraints.Float](rng *rand.Rand, min, max T) T

+ func RandomNumber[T constraints.Integer | constraints.Float](rng *rand.Rand) T

+ func RandomRegex[T ~string](rng *rand.Rand, pattern string) T

+ func RandomSelection[T any](rng *rand.Rand, items []T) T

+ func RandomString[T ~string](rng *rand.Rand, min, max uint64) T

+ type FakeConstraintsNumeric struct

+ Cardinality uint64

+ Dataset []T

+ Max T

+ Min T

+ type FakeConstraintsTextual struct

+ Cardinality uint64

+ Dataset []T

+ MaxLength uint64

+ MinLength uint64

+ type FakeNumber struct

+ Cardinality uint64

+ Max T

+ Min T

+ Possible []T

+ RandomFn func(ctx context.Context, n *FakeNumber[T]) T

+ RangeFn func(ctx context.Context, n *FakeNumber[T]) T

+ SelectFn func(ctx context.Context, n *FakeNumber[T]) T

+ State *FakeState[T]

+ StateFn func(ctx context.Context, n *FakeNumber[T])

+ Strategy FakeStrategy

+ func (n *FakeNumber[T]) Generate(ctx context.Context) T

+ type FakeRequest struct

+ Generations uint64

+ Rand *rand.Rand

+ type FakeText struct

+ Cardinality uint64

+ MaxLength uint64

+ MinLength uint64

+ PatternFn func(ctx context.Context, t *FakeText[T]) T

+ Possible []T

+ RandomFn func(ctx context.Context, t *FakeText[T]) T

+ RangeFn func(ctx context.Context, t *FakeText[T]) T

+ Regex *regexp.Regexp

+ SelectFn func(ctx context.Context, t *FakeText[T]) T

+ State *FakeState[T]

+ StateFn func(ctx context.Context, t *FakeText[T])

+ Strategy FakeStrategy

+ func (t *FakeText[T]) Generate(ctx context.Context) T

Sep 24, 2024

Changes in this version

+ var ErrInvalidFakeWellKnownType = fmt.Errorf("not a valid FakeWellKnownType, try [%s]", ...)

+ var RNG *rand.Rand

+ func FakeWellKnownTypeNames() []string

+ type FakeConstraints struct

+ Cardinality uint64

+ Dataset []T

+ Max T

+ Min T

+ Pattern string

type FakeOptions

+ Constraints *FakeConstraints[T]

+ RandomFn func(ctx context.Context, options *FakeOptions[T]) T

+ RangeFn func(ctx context.Context, options *FakeOptions[T], min, max T) T

+ SelectFn func(ctx context.Context, options *FakeOptions[T], items []T) T

+ State *FakeState[T]

+ StateFn func(ctx context.Context, options *FakeOptions[T])

+ func (o *FakeOptions[T]) Generate(ctx context.Context) T

type FakeState

+ Curr T

type FakeStrategy

+ const FakeStrategyDistributionNormal

+ const FakeStrategyDistributionUniform

+ const FakeStrategyRandomPattern

+ const FakeStrategyRandomRange

+ const FakeStrategyRandomSelect

Sep 23, 2024

Changes in this version

+ var ErrInvalidFakeStrategy = fmt.Errorf("not a valid FakeStrategy, try [%s]", strings.Join(_FakeStrategyNames, ", "))

+ func FakeStrategyNames() []string

+ type FakeOptions struct

+ Next func(o *FakeOptions[T])

+ Rules *FakeRules[T]

+ Strategy FakeStrategy

+ type FakeRules struct

+ Cardinality uint64

+ DistributionMean float64

+ Incrementing bool

+ LowerBound T

+ Matches string

+ UpperBound T

+ type FakeState struct

+ Generation uint64

+ Init T

+ Prev T

+ type FakeStrategy string

+ const FakeStrategyNormalDistribution

+ const FakeStrategyRandom

+ const FakeStrategyRandomSelection

+ const FakeStrategyStateful

+ const FakeStrategyUniformDistribution

+ const FakeStrategyUnspecified

+ func ParseFakeStrategy(name string) (FakeStrategy, error)

+ func (x *FakeStrategy) UnmarshalText(text []byte) error

+ func (x FakeStrategy) IsValid() bool

+ func (x FakeStrategy) MarshalText() ([]byte, error)

+ func (x FakeStrategy) String() string

Sep 16, 2024

Changes in this version

+ func SliceSet[T comparable](input []T) map[T]struct

Sep 10, 2024

Changes in this version

+ func MustMapAny[T any](value T) map[string]any

+ func MustMapString[T any](value T) map[string]string

+ func ToMapAny[T any](value T) (map[string]any, error)

+ func ToMapString[T any](value T) (map[string]string, error)

Sep 9, 2024

Changes in this version

+ func MustMapStringAny[T any](value T) map[string]any

+ func ToMapStringAny[T any](value T) (map[string]any, error)

Jun 27, 2024

Changes in this version

+ var ErrTypeConversionFailed = Error

+ func ToBool[T any](value T) (bool, error)

+ func ToDuration[T any](value T) (time.Duration, error)

+ func ToInt[T any](value T) (int, error)

+ func ToString[T any](value T) (string, error)

Jun 27, 2024

Changes in this version

+ func MustBool[T any](value T) bool

+ func MustDuration[T any](value T) time.Duration

+ func MustInt[T any](value T) int

+ func MustString[T any](value T) string

Jun 27, 2024

Changes in this version

+ type Optional struct

+ func Default[T any](v T) Optional[T]

+ func Some[T any](v T) Optional[T]

+ func (o *Optional[T]) Changed() bool

+ func (o *Optional[T]) Get() T

+ func (o *Optional[T]) Set(v T)

Jun 24, 2024

Changes in this version

+ var ErrTypeAssertionFailed = Error

+ func As[T any](v any) (T, error)

Jun 23, 2024

Changes in this version

+ func AnyTo[T any](v any) any

Jun 20, 2024

Changes in this version

type Error

+ func (e Error) WithTag(tags ...string) Error

type ErrorExtras

+ func (e ErrorExtras) WithTag(tags ...string) ErrorExtras

Jun 20, 2024

Changes in this version

type Error

+ func (e Error) WithTags(tags ...string) Error

type ErrorExtras

+ Tags []string

+ func (e ErrorExtras) WithTags(tags ...string) ErrorExtras

Jun 19, 2024

Changes in this version

+ func DeferCall(err *error, fn func() error)

Jun 19, 2024

Changes in this version

+ func DeferCloser(err *error, fn func() error)

Jun 19, 2024

Changes in this version

+ func ErrorKey(namespace, code string) string

Jun 19, 2024

Changes in this version

type Error

+ func (e Error) Key() string

Jun 19, 2024

Changes in this version

+ func SliceMap[TIn any, TOut any](input []TIn, mapper Mapper[TIn, TOut]) []TOut

+ type KeyedMapper func(k K, v VIn) VOut

+ type Mapper func(t TIn) TOut

Jun 19, 2024

Changes in this version

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

+ func MapValues[K comparable, V any](input map[K]V) []V

Jun 19, 2024

Changes in this version

type ErrorGroup

+ func NewTranslatedErrorGroup(translate ErrorTranslate, errs ...error) *ErrorGroup

Jun 19, 2024

Changes in this version

type ErrorGroup

+ func (g *ErrorGroup) Translate(translate ErrorTranslate)

Jun 18, 2024

Changes in this version

+ func IsZeroAny(t any) bool

Jun 15, 2024

Changes in this version

+ func Build[T any](t T, builders ...Builder[T]) (T, error)

+ type Builder func(t T) T

Jun 10, 2024

Changes in this version

+ func MustT[T any](v any) T

Jun 7, 2024

Changes in this version

+ type Valid struct

+ Value T

+ func ValidCheck[T any](t T, validators ...Validator[T]) (*Valid[T], error)

+ type Validator func(t T) error

Jun 6, 2024

Changes in this version

type ErrorGroup

+ func NewErrorGroup(errs ...error) *ErrorGroup

Jun 3, 2024

Changes in this version

+ type ContextKey struct

+ func NewContextKey[T any](name string, def T) ContextKey[T]

+ func (k ContextKey[T]) String() string

+ func (k ContextKey[T]) Value(ctx context.Context) T

+ func (k ContextKey[T]) ValueOk(ctx context.Context) (T, bool)

+ func (k ContextKey[T]) WithValue(parent context.Context, value T) context.Context

May 30, 2024

Changes in this version

+ func SliceTypeAssert[TIn any, TOut any](slice []TIn) []TOut

type ErrorGroup

+ func ErrorJoin(err error, errs ...error) *ErrorGroup

May 30, 2024

Changes in this version

+ func Defer(err *error, fn func() error)

May 29, 2024

Changes in this version

+ var ErrUndefined = Error

+ func E[T any](v T) bool

+ func ErrorGroupFormatterDefault(errors []Error) string

+ func IsZero[T any](t T) bool

+ func MapFilterRange[K comparable, V any](input KeyedRanger[K, V], predicate KeyedPredicate[K, V]) map[K]V

+ func MapFilter[K comparable, V any](input map[K]V, predicate KeyedPredicate[K, V]) map[K]V

+ func MustE[T any](fn func() (T, error)) T

+ func Must[T any](t T) T

+ func OptionApply[T any](t T, options ...Option[T]) (T, error)

+ func Pointer[T any](t T) *T

+ func SliceFilterRange[T any](input Ranger[T], predicate Predicate[T]) []T

+ func SliceFilter[T any](input []T, predicate Predicate[T]) []T

+ func SliceFlatten[T any](slices ...[]T) []T

+ func SliceToMap[K comparable, V any](input []V, key func(v V) K) map[K]V

+ func TitleCase(s string) string

+ func URLPort(u *url.URL) (int, error)

+ func VO[T ValueObject](v T) T

+ type Bitmask uint8

+ const ErrorFlagRetryable

+ const ErrorFlagTimeout

+ const ErrorFlagUnknown

+ const ErrorNamespaceDefault

+ func ParseBitmask(binary string) (Bitmask, error)

+ func (b Bitmask) Clear(bits Bitmask) Bitmask

+ func (b Bitmask) Has(bits Bitmask) bool

+ func (b Bitmask) MarshalText() ([]byte, error)

+ func (b Bitmask) Set(bits Bitmask) Bitmask

+ func (b Bitmask) String() string

+ func (b Bitmask) Toggle(bits Bitmask) Bitmask

+ type Causer interface

+ Cause func() error

+ type DebugExtras struct

+ StackTrace string

+ func (e DebugExtras) IsZero() bool

+ type Entity interface

+ EntityID func() ID

+ type Equaler interface

+ Equal func(x T, y T) bool

+ type Error struct

+ Code string

+ Extras ErrorExtras

+ Flags Bitmask

+ Message string

+ Namespace string

+ Wrapped error

+ func (e Error) AsGroup() *ErrorGroup

+ func (e Error) Copy() Error

+ func (e Error) Equal(e2 Error) bool

+ func (e Error) Error() string

+ func (e Error) Format(s fmt.State, verb rune)

+ func (e Error) Is(target error) bool

+ func (e Error) IsRetryable() bool

+ func (e Error) IsTimeout() bool

+ func (e Error) IsTransient() bool

+ func (e Error) IsZero() bool

+ func (e Error) String() string

+ func (e Error) Unwrap() error

+ func (e Error) WithDebugInfo(extras DebugExtras) Error

+ func (e Error) WithFlag(attribute Bitmask) Error

+ func (e Error) WithHelp(extras HelpExtras) Error

+ func (e Error) WithRetry(extras RetryExtras) Error

+ func (e Error) Wrap(err error) Error

+ func (e Error) Wrapf(format string, a ...any) Error

+ type ErrorExtras struct

+ Debug DebugExtras

+ Help HelpExtras

+ Retry RetryExtras

+ func (e ErrorExtras) IsZero() bool

+ func (e ErrorExtras) WithDebugExtras(extras DebugExtras) ErrorExtras

+ func (e ErrorExtras) WithHelpExtras(extras HelpExtras) ErrorExtras

+ func (e ErrorExtras) WithRetryExtras(extras RetryExtras) ErrorExtras

+ type ErrorGroup struct

+ Errors []Error

+ Formatter ErrorGroupFormatter

+ func ErrorTranslateGroup(translate ErrorTranslate, errors ...error) *ErrorGroup

+ func (g *ErrorGroup) Append(errs ...error)

+ func (g *ErrorGroup) Empty() bool

+ func (g *ErrorGroup) Error() string

+ func (g *ErrorGroup) ErrorOrNil() error

+ func (g *ErrorGroup) GroupOrNil() *ErrorGroup

+ func (g *ErrorGroup) Len() int

+ func (g *ErrorGroup) Less(i, j int) bool

+ func (g *ErrorGroup) Slice() []Error

+ func (g *ErrorGroup) Swap(i, j int)

+ func (g *ErrorGroup) Unwrap() error

+ type ErrorGroupFormatter func([]Error) string

+ type ErrorTranslate func(err error) error

+ type HasAs interface

+ As func(target any) bool

+ type HasIs interface

+ Is func(target error) bool

+ type HasUnwrap interface

+ Unwrap func() error

+ type HelpExtras struct

+ Links []Link

+ func (e HelpExtras) IsZero() bool

+ type ID struct

+ Type string

+ Value string

+ type KeyedPredicate func(k K, v V) bool

+ type KeyedRanger interface

+ Range func(predicate KeyedPredicate[K, V])

+ type Link struct

+ Description string

+ URL string

+ type Memoize struct

+ Fn func() (T, error)

+ func (m *Memoize[T]) Get() (T, error)

+ type Option func(t T) error

+ type Predicate func(t T) bool

+ type Ranger interface

+ Range func(predicate Predicate[T])

+ type RetryExtras struct

+ Delay time.Duration

+ func (e RetryExtras) IsZero() bool

+ type ValueObject interface

+ type Zeroer interface

+ IsZero func() bool