Documentation
¶
Index ¶
- func Bool(value bool) *bool
- func BoolFromAny(value any) (bool, bool)
- func BoolFromAnyDefault(value any, fallback bool) bool
- func CSVStringSliceFromAny(value any) []string
- func CSVStringSliceFromAnyEmpty(value any) []string
- func CloneAnyMap(in map[string]any) map[string]any
- func CloneAnyMapDeep(in map[string]any) map[string]any
- func CloneAnyMapEmptyOnEmpty(in map[string]any) map[string]any
- func CloneAnyMapNilOnEmpty(in map[string]any) map[string]any
- func CloneStringMap(in map[string]string) map[string]string
- func CloneStringMapEmptyOnEmpty(in map[string]string) map[string]string
- func CloneStringMapNilOnEmpty(in map[string]string) map[string]string
- func FirstNonEmpty(values ...string) string
- func FirstNonEmptyFromAny(values ...any) string
- func FirstNonEmptyRaw(values ...string) string
- func Float64FromAny(value any) (float64, bool)
- func Int(value int) *int
- func Int64FromAny(value any) (int64, bool)
- func Int64FromUint(value uint) (int64, bool)
- func Int64FromUint64(value uint64) (int64, bool)
- func IntFromAny(value any) (int, bool)
- func IntFromInt64(value int64) (int, bool)
- func IntFromUint(value uint) (int, bool)
- func IntFromUint64(value uint64) (int, bool)
- func MapFromAnyEmpty(value any) map[string]any
- func NormalizeFilePath(path string) (string, error)
- func NormalizeLowerUniqueStringSlice(values []string) []string
- func NormalizeLowerUniqueStringSliceSorted(values []string) []string
- func NormalizeSQLIdentifier(value string) (string, error)
- func NormalizeSQLIdentifiers(values []string) ([]string, error)
- func NormalizeStringSlice(values []string) []string
- func NormalizeStringSliceEmpty(values []string) []string
- func NormalizeUniqueStringSlice(values []string) []string
- func NormalizeUniqueStringSliceEmpty(values []string) []string
- func NormalizeUniqueStringSliceFold(values []string) []string
- func OpenFileWithinRoot(root, path string) (*os.File, error)
- func OpenTrustedFile(path string) (*os.File, error)
- func ReadFileWithinRoot(root, path string) ([]byte, error)
- func ReadTrustedFile(path string) ([]byte, error)
- func StringFromAny(value any) string
- func StringOrNil(value string) *string
- func StringSliceFromAny(value any) []string
- func Uint16FromInt(value int) (uint16, bool)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func BoolFromAny ¶ added in v0.27.0
BoolFromAny converts common scalar values into a boolean.
func BoolFromAnyDefault ¶ added in v0.134.0
BoolFromAnyDefault converts common scalar values into a boolean and returns fallback when the value is not recognized.
func CSVStringSliceFromAny ¶ added in v0.27.0
CSVStringSliceFromAny normalizes strings and arrays into a trimmed string slice.
func CSVStringSliceFromAnyEmpty ¶ added in v0.113.1
CSVStringSliceFromAnyEmpty normalizes strings and arrays, returning an empty slice when empty.
func CloneAnyMap ¶
CloneAnyMap returns a shallow copy and preserves nil-vs-empty input.
func CloneAnyMapDeep ¶ added in v0.133.1
CloneAnyMapDeep recursively clones maps, slices, arrays, pointers, and interfaces reachable from an arbitrary-value map. It preserves concrete container types and nil-vs-empty values. This is intended for detached callback inputs whose metadata may contain nested mutable values.
func CloneAnyMapEmptyOnEmpty ¶
CloneAnyMapEmptyOnEmpty returns an empty map when input is nil or empty.
func CloneAnyMapNilOnEmpty ¶
CloneAnyMapNilOnEmpty returns nil when input is nil or empty.
func CloneStringMap ¶
CloneStringMap returns a shallow copy and preserves nil-vs-empty input.
func CloneStringMapEmptyOnEmpty ¶ added in v0.27.0
CloneStringMapEmptyOnEmpty returns an empty map when input is nil or empty.
func CloneStringMapNilOnEmpty ¶
CloneStringMapNilOnEmpty returns nil when input is nil or empty.
func FirstNonEmpty ¶
FirstNonEmpty returns the first non-empty value after trimming whitespace.
func FirstNonEmptyFromAny ¶ added in v0.113.1
FirstNonEmptyFromAny converts values to strings and returns the first non-empty result.
func FirstNonEmptyRaw ¶
FirstNonEmptyRaw returns the first value whose trimmed form is non-empty.
func Float64FromAny ¶ added in v0.27.0
Float64FromAny converts common scalar values into float64.
func Int64FromAny ¶ added in v0.27.0
Int64FromAny converts common scalar values into int64 when the value fits.
func Int64FromUint ¶ added in v0.27.0
Int64FromUint converts an unsigned int to int64 when it fits.
func Int64FromUint64 ¶ added in v0.27.0
Int64FromUint64 converts an unsigned 64-bit integer to int64 when it fits.
func IntFromAny ¶ added in v0.27.0
IntFromAny converts common scalar values into int when the value fits.
func IntFromInt64 ¶ added in v0.27.0
IntFromInt64 converts a signed 64-bit integer to int when it fits on the current platform.
func IntFromUint ¶ added in v0.27.0
IntFromUint converts an unsigned int to int when it fits on the current platform.
func IntFromUint64 ¶ added in v0.27.0
IntFromUint64 converts an unsigned 64-bit integer to int when it fits.
func MapFromAnyEmpty ¶ added in v0.134.0
MapFromAnyEmpty returns a borrowed map[string]any value as-is, including a typed nil map, and returns a non-nil empty map for every other input type.
func NormalizeFilePath ¶ added in v0.27.0
NormalizeFilePath trims and cleans a local file path.
func NormalizeLowerUniqueStringSlice ¶ added in v0.113.1
NormalizeLowerUniqueStringSlice trims, lowercases, dedupes, and returns nil when empty.
func NormalizeLowerUniqueStringSliceSorted ¶ added in v0.113.1
NormalizeLowerUniqueStringSliceSorted trims, lowercases, dedupes, sorts, and returns nil when empty.
func NormalizeSQLIdentifier ¶ added in v0.27.0
NormalizeSQLIdentifier lowercases, trims, and validates a SQL identifier.
func NormalizeSQLIdentifiers ¶ added in v0.27.0
NormalizeSQLIdentifiers validates each SQL identifier in order.
func NormalizeStringSlice ¶ added in v0.113.1
NormalizeStringSlice trims values and removes blank entries, returning nil when empty.
func NormalizeStringSliceEmpty ¶ added in v0.113.1
NormalizeStringSliceEmpty trims values and removes blank entries, returning an empty slice when empty.
func NormalizeUniqueStringSlice ¶ added in v0.113.1
NormalizeUniqueStringSlice trims values, removes blanks, and keeps first occurrences.
func NormalizeUniqueStringSliceEmpty ¶ added in v0.113.1
NormalizeUniqueStringSliceEmpty trims values, removes blanks, keeps first occurrences, and returns an empty slice when empty.
func NormalizeUniqueStringSliceFold ¶ added in v0.113.1
NormalizeUniqueStringSliceFold trims values and removes duplicates case-insensitively.
func OpenFileWithinRoot ¶ added in v0.27.0
OpenFileWithinRoot opens a file that must remain inside root.
func OpenTrustedFile ¶ added in v0.27.0
OpenTrustedFile opens a normalized operator-controlled or application-owned file path.
func ReadFileWithinRoot ¶ added in v0.27.0
ReadFileWithinRoot reads a file that must remain inside root.
func ReadTrustedFile ¶ added in v0.27.0
ReadTrustedFile reads a normalized operator-controlled or application-owned file path.
func StringFromAny ¶ added in v0.27.0
StringFromAny converts common scalar values into a trimmed string.
func StringOrNil ¶ added in v0.27.0
StringOrNil returns nil for empty-after-trim input and a pointer otherwise.
func StringSliceFromAny ¶ added in v0.27.0
StringSliceFromAny normalizes []string and []any into a trimmed string slice.
func Uint16FromInt ¶ added in v0.27.0
Uint16FromInt converts an int to uint16 when it is within bounds.
Types ¶
This section is empty.
Source Files