D:YAML
A YAML 1.1-compliant parser and emitter library for the D programming language, designed for ease of use and full feature support.
What is D:YAML?
D:YAML is a YAML parser and emitter library for the D programming language, enabling developers to read, write, and manipulate YAML data with almost full compliance to the YAML 1.1 specification. It solves the problem of handling YAML files in D applications by providing a robust, feature-complete alternative to building custom parsers.
D programmers who need to work with YAML for configuration, data serialization, or interoperability with other systems that use YAML.
Developers choose D:YAML for its high-level API, comprehensive YAML 1.1 support, and memory-efficient design, offering a reliable and easy-to-integrate solution compared to manual parsing or less complete libraries.
Overview
YAML parser and emitter for the D programming language
Use Cases
Best For
- Parsing YAML configuration files in D applications
- Emitting YAML data for interoperability with other systems
- Handling YAML anchors and aliases in complex data structures
- Working with both block-style and flow-style YAML syntax
- Implementing custom YAML tags and implicit type resolution
- Minimizing memory allocations when processing YAML input
Not Ideal For
- Projects that need to parse YAML with recursive data structures, as D:YAML explicitly does not support this.
- Multi-language systems where YAML processing is required outside the D programming language ecosystem.
- Applications demanding full YAML 1.2 compliance, since D:YAML is based on YAML 1.1 with documented differences.
Pros & Cons
Pros
Parses all constructs from the specification, including block and flow styles, anchors, aliases, and custom tags, with all examples from the spec handled correctly.
Reuses input memory and uses slices to minimize allocations, optimizing performance for handling large or frequent YAML data.
Offers an easy-to-use interface with detailed debugging messages, comprehensive tutorials, and code examples for quick integration.
Remembers YAML style information between loading and dumping when possible, ensuring output consistency with input formatting.
Cons
Explicitly lacks support for recursive data structures in YAML, a limitation for complex nested data that the README admits with no plans to implement.
Exclusively supports UTF-8 encoding, making it unsuitable for systems using other text encodings like UTF-16 or legacy formats.
Admitted to be 'almost' compliant with YAML 1.1, with documented differences that could cause edge-case issues in strict parsing scenarios.
Frequently Asked Questions
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.