fatih/structsArchived
Structs
Structs is a reflection utility and type inspection framework for Go. It provides tools for inspecting, converting, and validating data structures by extracting field names, tags, and values from Go objects.
The library specializes in transforming Go structs into generic maps or slices for serialization and data manipulation. It utilizes tag-driven mapping to determine custom keys and exclusion rules during these transformations.
The project covers broader capabilities including metadata extraction, type validation to verify if variables are structs or pointers, and initialization verification to detect zero-value states across data structures.
Features
- Struct-to-Map Converters - Transforms Go structs into generic maps of keys and values using custom naming and exclusion rules.
- Go Struct Reflection Utilities - Reading, modifying, and inspecting fields and tags within Go data structures using reflection.
- Field Inspection Utilities - Provides methods for retrieving and accessing Go struct field metadata and values via reflection.
- Go Data Mapping Libraries - Provides mapping and conversion utilities between Go native structs and generic maps.
- Recursive Pointer Unwrapping - Resolves nested pointers to their base struct types to ensure consistent analysis regardless of memory address.
- Runtime Type Validation - Ensures type safety by confirming an object is a struct or pointer before applying reflection logic.
- Struct Metadata Extractors - Retrieves Go struct type names, field tags, and lists of exported fields from objects at runtime.
- Struct Type Identification - Provides the ability to verify if a variable is a struct or a pointer to a struct for reflection purposes.
- Go Type Inspection Frameworks - Verifies struct types, detects uninitialized fields, and retrieves package-specific type names in Go.
- Data Serialization Formats - Converts complex Go data structures into standardized maps or lists for easier serialization.
- Struct Field Iterators - Provides mechanisms to traverse Go struct fields at runtime to extract values and metadata into generic collections.
- Reflection-Based Data Mapping - Uses language reflection to transform Go structs into generic data maps based on metadata.
- Struct Tag Mapping Utilities - Reads struct tags to enforce, ignore, or rename fields during the transformation of data into maps or slices.
- Reflection Utilities - Provides tools for runtime introspection and object reflection to extract field names and values.
- Initialization Status Checks - Verifies whether a data structure or its individual fields have been initialized.
- Struct-to-Slice Converters - Extracts all exported field values from a Go struct into a slice while ignoring empty or specified fields.
- Type Name Extraction - Implements the extraction of specific package-qualified type names from Go objects.
- Go Type Validators - Verifies if variables are structs or pointers and checks for zero-value initialization.
- Zero Value Detection - Detects if a data structure is uninitialized by identifying if all its fields contain zero values.
- Zero-Value Field Skippers - Detects and skips Go zero-value fields to prevent overwriting data with empty values during transformations.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
