goccy/go-yaml
Go Yaml
This library is a Go-based utility for encoding and decoding YAML data into native language structures. It facilitates the transformation of complex objects into human-readable text formats and provides mechanisms for mapping data fields through reflection and custom type handling.
The library distinguishes itself by maintaining an intermediate abstract syntax tree, which allows for precise document modifications and the preservation of comments during serialization. It includes a path-based query engine that enables users to navigate, filter, and update document hierarchies without manual iteration, as well as support for resolving external references across multiple files.
Beyond core parsing and serialization, the project offers comprehensive tools for document manipulation, including recursive tree traversal and tag-driven formatting controls. It also provides diagnostic utilities that generate descriptive, colorized error messages with specific source location data to assist in debugging.
Features
- Multi-Format Encoder-Decoder Abstractions - Transforms native language structures into formatted YAML text and parses documents back into objects using automated field mapping.
- YAML Parsers - Encodes and decodes YAML data into native structures with support for path-based queries and custom serialization logic.
- YAML Data Serialization - Converts native language objects into human-readable text format to simplify data storage and transmission.
- Go Data Mapping Libraries - Provides a utility for mapping complex data structures to and from text formats using reflection and custom type handling.
- Reflection-Based Data Mapping - Uses runtime reflection to automatically bind document fields to native language structures during serialization.
- Path-Based Query Engines - Provides a path-based query engine to navigate and update complex document hierarchies without manual iteration.
- Document Content Manipulation - Filters, replaces, and merges document elements using path-based queries and recursive processing to update complex data structures.
- Custom Serialization Interfaces - Enables defining custom conversion logic for specific data types to control marshaling and unmarshaling behavior.
- Custom-Type Mappings - Defines specific conversion behavior for complex data types to control information representation during marshaling and unmarshaling.
- Document Node Modeling - Maintains an internal abstract syntax tree to enable precise document modifications and comment preservation during serialization.
- Automated Document Processing - Automates document maintenance and transformation tasks by filtering, merging, and updating complex data structures.
- Anchor Resolution in Merging - Integrates anchors and elements defined in separate files during decoding to maintain consistency across related data documents.
- Serialization Control - Uses metadata annotations on data structures to define custom formatting and field mapping behavior.
- YAML Configuration Files - Parses and manipulates structured configuration files to allow for programmatic access and easy updates to application settings.
- YAML Serializers - Transforms objects into human-readable YAML text while maintaining comments and precise formatting control.
- Serialization Error Reporters - Provides descriptive, colorized error messages with precise source location data during YAML serialization and deserialization processes.
- External Style Reference Resolution - Integrates anchors and elements defined in separate files during decoding to maintain consistency across related documents.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
