YAML parser and emitter with Mir serialisation engine support
To use this package, run the following command in your project's root directory:
Put the following dependency into your project's dependences section:
NOTE: Mir's YAML was moved to https://github.com/libmir/mir-ion
mir-yaml - Mir Fork
mir-yaml is designed to be easy to use while supporting the full feature set of YAML.
To start using it in your project, see the Getting Started tutorial.
Mir specific Features
- Integration with Mir serialisation engine. See also the example.
- Precise number printing (Ryu) and parsing (required by YAML spec).
- Support for Arbitrary timestamp precision (required by YAML spec).
- Support for Timestamp (Mir),
Date(Mir and Phobos),
YamlAlgebraicis full featured Mir Algebraic.
- Easy to use, high level API and detailed debugging messages.
- Detailed API documentation and tutorials.
- Code examples.
- Supports all YAML 1.1 constructs. All examples from the YAML 1.1 specification are parsed correctly.
- Reads from and writes from/to YAML files or in-memory buffers.
- UTF-8, UTF-16 and UTF-32 encodings are supported, both big and little endian (plain ASCII also works as it is a subset of UTF-8).
- Support for both block (Python-like, based on indentation) and flow (JSON-like, based on bracing) constructs.
- Support for YAML anchors and aliases.
- Support for default values in mappings.
- Support for custom tags (data types), and implicit tag resolution for custom scalar tags.
- All tags (data types) described at http://yaml.org/type/ are
supported, with the exception of
tag:yaml.org,2002:yaml, which is used to represent YAML code in YAML.
- Remembers YAML style information between loading and dumping if possible.
- Reuses input memory and uses slices to minimize memory allocations.
- There is no support for recursive data structures. There are no plans to implement this at the moment.
|This README, utility scripts.|
|Example projects using |
Installing and tutorial
API documentation is available here.
mir-yaml was created by Ferdinand Majerech aka Kiith-Sa and is handled by the dlang-community organization since 2017, and libmir organization since 2021.
Parts of code based on PyYAML created by Kirill Simonov.
- Registered by Ilia Ki
- ~master released 2 months ago
- Copyright © 2011-2018, Ferdinand Majerech