Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

utils

package

Go to main page

Versions in this module

v2

v2.2.0

Sep 28, 2025

v2.1.0

Sep 5, 2025

v2.0.0

Aug 18, 2025

Changes in this version

+ const CommandSelectionFieldKey

+ var ErrHandlerNotfound = errors.New("connector handler not found")

+ func CommandSelectionFieldFromContext(ctx context.Context) schema.NestedField

+ func DebugJSONAttributes(data map[string]any, isDebug bool) []attribute.KeyValue

+ func DecodeArbitraryJSONPtrSlice(value any) ([]*any, error)

+ func DecodeArbitraryJSONSlice(value any) ([]any, error)

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

+ func DecodeBooleanPtrSlice(value any) ([]*bool, error)

+ func DecodeBooleanReflection(value reflect.Value) (bool, error)

+ func DecodeBooleanSlice(value any) ([]bool, error)

+ func DecodeDate(value any, options ...DecodeTimeOption) (time.Time, error)

+ func DecodeDateReflection(value reflect.Value, options ...DecodeTimeOption) (time.Time, error)

+ func DecodeDateTime(value any, options ...DecodeTimeOption) (time.Time, error)

+ func DecodeDateTimePtrSlice(value any) ([]*time.Time, error)

+ func DecodeDateTimeReflection(value reflect.Value, options ...DecodeTimeOption) (time.Time, error)

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

+ func DecodeDuration(value any, options ...DecodeTimeOption) (time.Duration, error)

+ func DecodeFloatPtrSlice[T float32 | float64](value any) ([]*T, error)

+ func DecodeFloatReflection[T float32 | float64](value reflect.Value) (T, error)

+ func DecodeFloatSlice[T float32 | float64](value any) ([]T, error)

+ func DecodeFloat[T float32 | float64](value any) (T, error)

+ func DecodeIntPtrSlice[T int | int8 | int16 | int32 | int64](value any) ([]*T, error)

+ func DecodeIntReflection[T int | int8 | int16 | int32 | int64](value reflect.Value) (T, error)

+ func DecodeIntSlice[T int | int8 | int16 | int32 | int64](value any) ([]T, error)

+ func DecodeInt[T int | int8 | int16 | int32 | int64](value any) (T, error)

+ func DecodeNullableArbitraryJSONPtrSlice(value any) (*[]*any, error)

+ func DecodeNullableArbitraryJSONSlice(value any) (*[]any, error)

+ func DecodeNullableBoolean(value any) (*bool, error)

+ func DecodeNullableBooleanPtrSlice(value any) (*[]*bool, error)

+ func DecodeNullableBooleanReflection(value reflect.Value) (*bool, error)

+ func DecodeNullableBooleanSlice(value any) (*[]bool, error)

+ func DecodeNullableDate(value any, options ...DecodeTimeOption) (*time.Time, error)

+ func DecodeNullableDateReflection(value reflect.Value, options ...DecodeTimeOption) (*time.Time, error)

+ func DecodeNullableDateTime(value any, options ...DecodeTimeOption) (*time.Time, error)

+ func DecodeNullableDateTimePtrSlice(value any) (*[]*time.Time, error)

+ func DecodeNullableDateTimeReflection(value reflect.Value, options ...DecodeTimeOption) (*time.Time, error)

+ func DecodeNullableDateTimeSlice(value any) (*[]time.Time, error)

+ func DecodeNullableDuration(value any, options ...DecodeTimeOption) (*time.Duration, error)

+ func DecodeNullableDurationReflection(value reflect.Value, options ...DecodeTimeOption) (*time.Duration, error)

+ func DecodeNullableFloatPtrSlice[T float32 | float64](value any) (*[]*T, error)

+ func DecodeNullableFloatReflection[T float32 | float64](value reflect.Value) (*T, error)

+ func DecodeNullableFloatSlice[T float32 | float64](value any) (*[]T, error)

+ func DecodeNullableFloat[T float32 | float64](value any) (*T, error)

+ func DecodeNullableIntPtrSlice[T int | int8 | int16 | int32 | int64](value any) (*[]*T, error)

+ func DecodeNullableIntReflection[T int | int8 | int16 | int32 | int64](value reflect.Value) (*T, error)

+ func DecodeNullableIntSlice[T int | int8 | int16 | int32 | int64](value any) (*[]T, error)

+ func DecodeNullableInt[T int | int8 | int16 | int32 | int64](value any) (*T, error)

+ func DecodeNullableObjectValue[T any](object map[string]any, key string, decodeHooks ...mapstructure.DecodeHookFunc) (*T, error)

+ func DecodeNullableObject[T any](value map[string]any, decodeHooks ...mapstructure.DecodeHookFunc) (*T, error)

+ func DecodeNullableRawJSON(value any) (*json.RawMessage, error)

+ func DecodeNullableRawJSONPtrSlice(value any) (*[]*json.RawMessage, error)

+ func DecodeNullableRawJSONSlice(value any) (*[]json.RawMessage, error)

+ func DecodeNullableString(value any) (*string, error)

+ func DecodeNullableStringPtrSlice(value any) (*[]*string, error)

+ func DecodeNullableStringReflection(value reflect.Value) (*string, error)

+ func DecodeNullableStringSlice(value any) (*[]string, error)

+ func DecodeNullableUUID(value any) (*uuid.UUID, error)

+ func DecodeNullableUUIDPtrSlice(value any) (*[]*uuid.UUID, error)

+ func DecodeNullableUUIDSlice(value any) (*[]uuid.UUID, error)

+ func DecodeNullableUintPtrSlice[T uint | uint8 | uint16 | uint32 | uint64](value any) (*[]*T, error)

+ func DecodeNullableUintReflection[T uint | uint8 | uint16 | uint32 | uint64](value reflect.Value) (*T, error)

+ func DecodeNullableUintSlice[T uint | uint8 | uint16 | uint32 | uint64](value any) (*[]T, error)

+ func DecodeNullableUint[T uint | uint8 | uint16 | uint32 | uint64](value any) (*T, error)

+ func DecodeNullableValue[T any](value any, decodeHooks ...mapstructure.DecodeHookFunc) (*T, error)

+ func DecodeObjectValueDefault[T any](object map[string]any, key string, decodeHooks ...mapstructure.DecodeHookFunc) (T, error)

+ func DecodeObjectValue[T any](object map[string]any, key string, decodeHooks ...mapstructure.DecodeHookFunc) (T, error)

+ func DecodeObject[T any](value map[string]any, decodeHooks ...mapstructure.DecodeHookFunc) (T, error)

+ func DecodeRawJSONPtrSlice(value any) ([]*json.RawMessage, error)

+ func DecodeRawJSONSlice(value any) ([]json.RawMessage, error)

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

+ func DecodeStringPtrSlice(value any) ([]*string, error)

+ func DecodeStringReflection(value reflect.Value) (string, error)

+ func DecodeStringSlice(value any) ([]string, error)

+ func DecodeUUID(value any) (uuid.UUID, error)

+ func DecodeUUIDPtrSlice(value any) ([]*uuid.UUID, error)

+ func DecodeUUIDSlice(value any) ([]uuid.UUID, error)

+ func DecodeUintPtrSlice[T uint | uint8 | uint16 | uint32 | uint64](value any) ([]*T, error)

+ func DecodeUintReflection[T uint | uint8 | uint16 | uint32 | uint64](value reflect.Value) (T, error)

+ func DecodeUintSlice[T uint | uint8 | uint16 | uint32 | uint64](value any) ([]T, error)

+ func DecodeUint[T uint | uint8 | uint16 | uint32 | uint64](value any) (T, error)

+ func DecodeValue[T any](value any, decodeHooks ...mapstructure.DecodeHookFunc) (T, error)

+ func EncodeNullableObjectSlice[T any](inputs *[]T) ([]map[string]any, error)

+ func EncodeObject(input any) (map[string]any, error)

+ func EncodeObjectSlice[T any](input []T) ([]map[string]any, error)

+ func EncodeObjectWithColumnSelection[T any](fields map[string]schema.Field, data T) (map[string]any, error)

+ func EncodeObjects(input any) ([]map[string]any, error)

+ func EncodeObjectsWithColumnSelection[T any](fields map[string]schema.Field, data []T) ([]map[string]any, error)

+ func EvalFunctionSelectionFieldValue(request *schema.QueryRequest) (schema.NestedField, error)

+ func EvalNestedColumnArray(fields *schema.NestedArray, value any) (any, error)

+ func EvalNestedColumnArrayIntoSlice[T any](fields *schema.NestedArray, value []T) (any, error)

+ func EvalNestedColumnFields(fields schema.NestedField, value any) (any, error)

+ func EvalNestedColumnObject(fields *schema.NestedObject, value any) (any, error)

+ func EvalObjectWithColumnSelection(fields map[string]schema.Field, data map[string]any) (map[string]any, error)

+ func EvalObjectsWithColumnSelection(fields map[string]schema.Field, data []map[string]any) ([]map[string]any, error)

+ func GetAny(object map[string]any, key string) (any, bool)

+ func GetArbitraryJSON(object map[string]any, key string) (any, error)

+ func GetArbitraryJSONDefault(object map[string]any, key string) (any, error)

+ func GetArbitraryJSONPtrSlice(object map[string]any, key string) ([]*any, error)

+ func GetArbitraryJSONPtrSliceDefault(object map[string]any, key string) ([]*any, error)

+ func GetArbitraryJSONSlice(object map[string]any, key string) ([]any, error)

+ func GetArbitraryJSONSliceDefault(object map[string]any, key string) ([]any, error)

+ func GetBoolean(object map[string]any, key string) (bool, error)

+ func GetBooleanDefault(object map[string]any, key string) (bool, error)

+ func GetBooleanPtrSlice(object map[string]any, key string) ([]*bool, error)

+ func GetBooleanPtrSliceDefault(object map[string]any, key string) ([]*bool, error)

+ func GetBooleanSlice(object map[string]any, key string) ([]bool, error)

+ func GetBooleanSliceDefault(object map[string]any, key string) ([]bool, error)

+ func GetDateTime(object map[string]any, key string, options ...DecodeTimeOption) (time.Time, error)

+ func GetDateTimeDefault(object map[string]any, key string, options ...DecodeTimeOption) (time.Time, error)

+ func GetDateTimePtrSlice(object map[string]any, key string) ([]*time.Time, error)

+ func GetDateTimePtrSliceDefault(object map[string]any, key string) ([]*time.Time, error)

+ func GetDateTimeSlice(object map[string]any, key string) ([]time.Time, error)

+ func GetDateTimeSliceDefault(object map[string]any, key string) ([]time.Time, error)

+ func GetDefaultPtr[T any](value *T, defaultValue *T) *T

+ func GetDefaultValuePtr[T comparable](value *T, defaultValue T) T

+ func GetDefault[T comparable](value T, defaultValue T) T

+ func GetDuration(object map[string]any, key string, options ...DecodeTimeOption) (time.Duration, error)

+ func GetDurationDefault(object map[string]any, key string, options ...DecodeTimeOption) (time.Duration, error)

+ func GetFloatDefault[T float32 | float64](object map[string]any, key string) (T, error)

+ func GetFloatPtrSliceDefault[T float32 | float64](object map[string]any, key string) ([]*T, error)

+ func GetFloatPtrSlice[T float32 | float64](object map[string]any, key string) ([]*T, error)

+ func GetFloatSliceDefault[T float32 | float64](object map[string]any, key string) ([]T, error)

+ func GetFloatSlice[T float32 | float64](object map[string]any, key string) ([]T, error)

+ func GetFloat[T float32 | float64](object map[string]any, key string) (T, error)

+ func GetIntDefault[T int | int8 | int16 | int32 | int64](object map[string]any, key string) (T, error)

+ func GetIntPtrSliceDefault[T int | int8 | int16 | int32 | int64](object map[string]any, key string) ([]*T, error)

+ func GetIntPtrSlice[T int | int8 | int16 | int32 | int64](object map[string]any, key string) ([]*T, error)

+ func GetIntSliceDefault[T int | int8 | int16 | int32 | int64](object map[string]any, key string) ([]T, error)

+ func GetIntSlice[T int | int8 | int16 | int32 | int64](object map[string]any, key string) ([]T, error)

+ func GetInt[T int | int8 | int16 | int32 | int64](object map[string]any, key string) (T, error)

+ func GetKeys[K cmp.Ordered, V any](input map[K]V) []K

+ func GetNullableArbitraryJSON(object map[string]any, key string) (*any, error)

+ func GetNullableArbitraryJSONPtrSlice(object map[string]any, key string) (*[]*any, error)

+ func GetNullableArbitraryJSONSlice(object map[string]any, key string) (*[]any, error)

+ func GetNullableBoolean(object map[string]any, key string) (*bool, error)

+ func GetNullableBooleanPtrSlice(object map[string]any, key string) (*[]*bool, error)

+ func GetNullableBooleanSlice(object map[string]any, key string) (*[]bool, error)

+ func GetNullableDateTime(object map[string]any, key string, options ...DecodeTimeOption) (*time.Time, error)

+ func GetNullableDateTimePtrSlice(object map[string]any, key string) (*[]*time.Time, error)

+ func GetNullableDateTimeSlice(object map[string]any, key string) (*[]time.Time, error)

+ func GetNullableDuration(object map[string]any, key string, options ...DecodeTimeOption) (*time.Duration, error)

+ func GetNullableFloatPtrSlice[T float32 | float64](object map[string]any, key string) (*[]*T, error)

+ func GetNullableFloatSlice[T float32 | float64](object map[string]any, key string) (*[]T, error)

+ func GetNullableFloat[T float32 | float64](object map[string]any, key string) (*T, error)

+ func GetNullableIntPtrSlice[T int | int8 | int16 | int32 | int64](object map[string]any, key string) (*[]*T, error)

+ func GetNullableIntSlice[T int | int8 | int16 | int32 | int64](object map[string]any, key string) (*[]T, error)

+ func GetNullableInt[T int | int8 | int16 | int32 | int64](object map[string]any, key string) (*T, error)

+ func GetNullableRawJSON(object map[string]any, key string) (*json.RawMessage, error)

+ func GetNullableRawJSONPtrSlice(object map[string]any, key string) (*[]*json.RawMessage, error)

+ func GetNullableRawJSONSlice(object map[string]any, key string) (*[]json.RawMessage, error)

+ func GetNullableString(object map[string]any, key string) (*string, error)

+ func GetNullableStringPtrSlice(object map[string]any, key string) (*[]*string, error)

+ func GetNullableStringSlice(object map[string]any, key string) (*[]string, error)

+ func GetNullableUUID(object map[string]any, key string) (*uuid.UUID, error)

+ func GetNullableUUIDPtrSlice(object map[string]any, key string) (*[]*uuid.UUID, error)

+ func GetNullableUUIDSlice(object map[string]any, key string) (*[]uuid.UUID, error)

+ func GetNullableUintPtrSlice[T uint | uint8 | uint16 | uint32 | uint64](object map[string]any, key string) (*[]*T, error)

+ func GetNullableUintSlice[T uint | uint8 | uint16 | uint32 | uint64](object map[string]any, key string) (*[]T, error)

+ func GetNullableUint[T uint | uint8 | uint16 | uint32 | uint64](object map[string]any, key string) (*T, error)

+ func GetRawJSON(object map[string]any, key string) (json.RawMessage, error)

+ func GetRawJSONDefault(object map[string]any, key string) (json.RawMessage, error)

+ func GetRawJSONPtrSlice(object map[string]any, key string) ([]*json.RawMessage, error)

+ func GetRawJSONPtrSliceDefault(object map[string]any, key string) ([]*json.RawMessage, error)

+ func GetRawJSONSlice(object map[string]any, key string) ([]json.RawMessage, error)

+ func GetRawJSONSliceDefault(object map[string]any, key string) ([]json.RawMessage, error)

+ func GetSortedKeys[K cmp.Ordered, V any](input map[K]V) []K

+ func GetSortedValuesByKey[K cmp.Ordered, V any](input map[K]V) []V

+ func GetString(object map[string]any, key string) (string, error)

+ func GetStringDefault(object map[string]any, key string) (string, error)

+ func GetStringPtrSlice(object map[string]any, key string) ([]*string, error)

+ func GetStringPtrSliceDefault(object map[string]any, key string) ([]*string, error)

+ func GetStringSlice(object map[string]any, key string) ([]string, error)

+ func GetStringSliceDefault(object map[string]any, key string) ([]string, error)

+ func GetUUID(object map[string]any, key string) (uuid.UUID, error)

+ func GetUUIDDefault(object map[string]any, key string) (uuid.UUID, error)

+ func GetUUIDPtrSlice(object map[string]any, key string) ([]*uuid.UUID, error)

+ func GetUUIDPtrSliceDefault(object map[string]any, key string) ([]*uuid.UUID, error)

+ func GetUUIDSlice(object map[string]any, key string) ([]uuid.UUID, error)

+ func GetUUIDSliceDefault(object map[string]any, key string) ([]uuid.UUID, error)

+ func GetUintDefault[T uint | uint8 | uint16 | uint32 | uint64](object map[string]any, key string) (T, error)

+ func GetUintPtrSliceDefault[T uint | uint8 | uint16 | uint32 | uint64](object map[string]any, key string) ([]*T, error)

+ func GetUintPtrSlice[T uint | uint8 | uint16 | uint32 | uint64](object map[string]any, key string) ([]*T, error)

+ func GetUintSliceDefault[T uint | uint8 | uint16 | uint32 | uint64](object map[string]any, key string) ([]T, error)

+ func GetUintSlice[T uint | uint8 | uint16 | uint32 | uint64](object map[string]any, key string) ([]T, error)

+ func GetUint[T uint | uint8 | uint16 | uint32 | uint64](object map[string]any, key string) (T, error)

+ func IsDebug(logger *slog.Logger) bool

+ func IsNil(value any) bool

+ func JSONAttribute(key string, data any) attribute.KeyValue

+ func MergeMap[K comparable, V any](dest map[K]V, src map[K]V) map[K]V

+ func MergeSchemas(schemas ...*schema.SchemaResponse) (*schema.SchemaResponse, []error)

+ func ParseBoolMapFromString(input string) (map[string]bool, error)

+ func ParseFloatMapFromString[T float32 | float64](input string) (map[string]T, error)

+ func ParseIntMapFromString(input string) (map[string]int, error)

+ func ParseIntegerMapFromString[T int | int8 | int16 | int32 | int64 | uint | uint8 | uint16 | uint32 | uint64](input string) (map[string]T, error)

+ func ParseStringMapFromString(input string) (map[string]string, error)

+ func PointersToValues[T any](input []*T) ([]T, error)

+ func ResolveArgument(argument schema.Argument, variables map[string]any) (any, error)

+ func ResolveArgumentVariables(arguments map[string]schema.Argument, variables map[string]any) (map[string]any, error)

+ func ResolveArguments(arguments map[string]schema.Argument, variables map[string]any) (map[string]any, error)

+ func ToPtr[V any](value V) *V

+ func ToPtrs[T any](input []T) []*T

+ func UnwrapPointerFromAny(value any) (any, bool)

+ func UnwrapPointerFromAnyToReflectValue(value any) (reflect.Value, bool)

+ func UnwrapPointerFromReflectValue(reflectValue reflect.Value) (reflect.Value, bool)

+ type DecodeTimeOption func(*decodeTimeOptions)

+ func WithBaseUnix(base time.Duration) DecodeTimeOption

+ func WithTimeParser(parser func(string) (time.Time, error)) DecodeTimeOption

+ type EnvBool struct

+ Value *bool

+ Variable *string

+ func NewEnvBool(env string, value bool) EnvBool

+ func NewEnvBoolValue(value bool) EnvBool

+ func NewEnvBoolVariable(name string) EnvBool

+ func (ev *EnvBool) UnmarshalJSON(b []byte) error

+ func (ev EnvBool) Get() (bool, error)

+ func (ev EnvBool) GetOrDefault(defaultValue bool) (bool, error)

+ type EnvFloat struct

+ Value *float64

+ Variable *string

+ func NewEnvFloat(env string, value float64) EnvFloat

+ func NewEnvFloatValue(value float64) EnvFloat

+ func NewEnvFloatVariable(name string) EnvFloat

+ func (ev *EnvFloat) UnmarshalJSON(b []byte) error

+ func (ev EnvFloat) Get() (float64, error)

+ func (ev EnvFloat) GetOrDefault(defaultValue float64) (float64, error)

+ type EnvInt struct

+ Value *int64

+ Variable *string

+ func NewEnvInt(env string, value int64) EnvInt

+ func NewEnvIntValue(value int64) EnvInt

+ func NewEnvIntVariable(name string) EnvInt

+ func (ev *EnvInt) UnmarshalJSON(b []byte) error

+ func (ev EnvInt) Get() (int64, error)

+ func (ev EnvInt) GetOrDefault(defaultValue int64) (int64, error)

+ type EnvMapBool struct

+ Value map[string]bool

+ Variable *string

+ func NewEnvMapBool(env string, value map[string]bool) EnvMapBool

+ func NewEnvMapBoolValue(value map[string]bool) EnvMapBool

+ func NewEnvMapBoolVariable(name string) EnvMapBool

+ func (ev *EnvMapBool) UnmarshalJSON(b []byte) error

+ func (ev EnvMapBool) Get() (map[string]bool, error)

+ type EnvMapFloat struct

+ Value map[string]float64

+ Variable *string

+ func NewEnvMapFloat(env string, value map[string]float64) EnvMapFloat

+ func NewEnvMapFloatValue(value map[string]float64) EnvMapFloat

+ func NewEnvMapFloatVariable(name string) EnvMapFloat

+ func (ev *EnvMapFloat) UnmarshalJSON(b []byte) error

+ func (ev EnvMapFloat) Get() (map[string]float64, error)

+ type EnvMapInt struct

+ Value map[string]int64

+ Variable *string

+ func NewEnvMapInt(env string, value map[string]int64) EnvMapInt

+ func NewEnvMapIntValue(value map[string]int64) EnvMapInt

+ func NewEnvMapIntVariable(name string) EnvMapInt

+ func (ev *EnvMapInt) UnmarshalJSON(b []byte) error

+ func (ev EnvMapInt) Get() (map[string]int64, error)

+ type EnvMapString struct

+ Value map[string]string

+ Variable *string

+ func NewEnvMapString(env string, value map[string]string) EnvMapString

+ func NewEnvMapStringValue(value map[string]string) EnvMapString

+ func NewEnvMapStringVariable(name string) EnvMapString

+ func (ev *EnvMapString) UnmarshalJSON(b []byte) error

+ func (ev EnvMapString) Get() (map[string]string, error)

+ type EnvString struct

+ Value *string

+ Variable *string

+ func NewEnvString(env string, value string) EnvString

+ func NewEnvStringValue(value string) EnvString

+ func NewEnvStringVariable(name string) EnvString

+ func (ev *EnvString) UnmarshalJSON(b []byte) error

+ func (ev EnvString) Get() (string, error)

+ func (ev EnvString) GetOrDefault(defaultValue string) (string, error)

+ type MapEncoder interface

+ ToMap func() map[string]any

+ type ObjectDecoder interface

+ FromValue func(value map[string]any) error

+ type Scalar interface

+ ScalarName func() string

+ type ValueDecoder interface

+ FromValue func(value any) error

v2.0.0-beta.1

Aug 18, 2025

Other modules containing this package

github.com/hasura/ndc-sdk-go