typutil

README

type conversion utils

This is useful when dealing with json parsed types for example.

Assign

Assign is a tool that allows assigning any value to any other value and let the library handle the conversion in a somewhat intelligent way.

For example a map[string]any can be assigned to a struct (json tags will be taken into account for variable names) and values will be converted.

Documentation

Index

• Variables
• func As[T any](v any) (T, error)
• func AsBool(v any) bool
• func AsByteArray(v any) ([]byte, bool)
• func AsFloat(v any) (float64, bool)
• func AsInt(v any) (int64, bool)
• func AsNumber(v any) (any, bool)
• func AsString(v any) (string, bool)
• func AsUint(v any) (uint64, bool)
• func Assign(dst, src any) error
• func AssignReflect(vdst, vsrc reflect.Value) error
• func BaseType(v any) any
• func Equal(a, b any) bool
• func Flatten(a any) any
• func IsNil(v any) bool
• func Math(mathop string, a, b any) (any, bool)
• func OffsetGet(ctx context.Context, v any, offset string) (any, error)
• func SetValidator[T any](validator string, fnc func(T) error)
• func SetValidatorArgs(validator string, fnc any)
• func ToType(ref, v any) (any, bool)
• func Validate(obj any) error

Variables

var (
	ErrAssignDestNotPointer      = errors.New("assign destination must be a pointer")
	ErrAssignImpossible          = errors.New("the requested assign is not possible")
	ErrNilPointerRead            = errors.New("attempt to read from a nil pointer")
	ErrEmptyValue                = errors.New("validator: value must not be empty")
	ErrDestinationNotAddressable = errors.New("assign: destination cannot be addressed")
	ErrStructPtrRequired         = errors.New("parameter must be a pointer to a struct")
	ErrBadOffset                 = errors.New("bad offset type")
)

Functions

func As

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

func AsBool

func AsBool(v any) bool

some helper functions related to numbers

func AsByteArray

func AsByteArray(v any) ([]byte, bool)

func AsFloat

func AsFloat(v any) (float64, bool)

func AsInt

func AsInt(v any) (int64, bool)

func AsNumber

func AsNumber(v any) (any, bool)

AsNumber will convert n in one of int64, uint64 or float64

func AsString

func AsString(v any) (string, bool)

func AsUint

func AsUint(v any) (uint64, bool)

func Assign

func Assign(dst, src any) error

func AssignReflect

func AssignReflect(vdst, vsrc reflect.Value) error

func BaseType

func BaseType(v any) any

BaseType attempts to convert v into its base type, that is if v is a type that is defined as `type foo string`, a simple string will be returned.

func Equal

func Equal(a, b any) bool

Equal returns true if a and b are somewhat equal

func Flatten

func Flatten(a any) any

Flatten transforms a into a simple interface, even if it is contains multiple levels. *string becomes string (or nil if it's nil), etc

func IsNil

func IsNil(v any) bool

IsNil recursively checks if v is nil, even if it is a pointer of an interface of a ...

func Math

func Math(mathop string, a, b any) (any, bool)

Math performs a mathematical operation on two variables of any type and returns a numeric type and true if everything went fine.

For example Math("+", 40.000, "2") will return float64(42)

For now if passed any float value, the function will always return a float value in the end. This may change in the future.

func OffsetGet

func OffsetGet(ctx context.Context, v any, offset string) (any, error)

OffsetGet returns v[offset] dealing with various case of figure. ctx will be passed to some methods handling it

func SetValidator

func SetValidator[T any](validator string, fnc func(T) error)

SetValidator sets the given function as validator with the given name. This should be typically called in init()

func SetValidatorArgs

func SetValidatorArgs(validator string, fnc any)

func ToType

func ToType(ref, v any) (any, bool)

ToType returns v converted to ref's type

func Validate

func Validate(obj any) error

Validate accept any struct as argument and returns if the struct is valid. The parameter should be a pointer to the struct so validators can edit values.