The missing YAML 1.2 implementation for Rust.
yaml-rust is a pure Rust YAML 1.2 implementation,
which enjoys the memory safety
property and other benefits from the Rust language.
The parser is heavily influenced by
Add the following to the Cargo.toml of your project:
 = "0.4"
extern crate yaml_rust;
yaml::YamlLoader to load the YAML documents and access it
extern crate yaml_rust; use ;
Index<&'a str> &
Index<usize>assumes the container is an Array
Index<&'a str>assumes the container is a string to value Map
If your document does not conform to this convention (e.g. map with
complex type key), you can use the
Yaml::as_XXX family API to access your
- Pure Rust
- Ruby-like Array/Hash access API
- Low-level YAML events emission
This implementation aims to provide YAML parser fully compatible with the YAML 1.2 specification. The parser can correctly parse almost all examples in the specification, except for the following known bugs:
- Empty plain scalar in certain contexts
However, the widely used library
libyaml also fails to parse these examples,
so it may not be a huge problem for most users.
- Tag directive
- Alias while deserialization
Minimum Rust version policy
This crate's minimum supported
rustc version is 1.31 (released with Rust 2018, after v0.4.3), as this is the currently known minimum version for
regex as well.
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Fork & PR on Github.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.