#yaml-parser #yaml #bindings #safe-bindings #ffi #rapidyaml

no-std ryml

Parse YAML and do it fast: Rapid YAML bindings for Rust

11 releases

0.3.2 Jun 12, 2023
0.3.1 Jun 12, 2023
0.3.0 May 24, 2023
0.2.0 May 17, 2023
0.1.5 Jul 30, 2022

#15 in #yaml-parser

Download history 62/week @ 2024-06-17 78/week @ 2024-06-24 61/week @ 2024-07-01 61/week @ 2024-07-08 75/week @ 2024-07-15 83/week @ 2024-07-22 161/week @ 2024-07-29 94/week @ 2024-08-05 108/week @ 2024-08-12 60/week @ 2024-08-19 92/week @ 2024-08-26 61/week @ 2024-09-02 73/week @ 2024-09-09 61/week @ 2024-09-16 103/week @ 2024-09-23 85/week @ 2024-09-30

331 downloads per month
Used in roead

GPL-3.0-or-later

235KB
2.5K SLoC

ryml: Rapid YAML Bindings for Rust

GPL 3 Crates.io version GitHub issues

Rapid YAML/ryml is a C++ library to parse and emit YAML, and do it fast. The ryml crate provides fairly thin but safe (I think) FFI bindings to bring this power to Rust.

This crate is currently is early, early alpha. Not all of the C++ API is covered, and some of it probably will not be, but the core functionality is all in place (indeed, much more than the official Python bindings).

Usage

A basic example of how to use this crate:

use ryml::Tree;

static SRC: &str = r#"
Hello: World
Names: [Caleb, Voronwe, 'Nicene Nerd']
Credo: !!apostolicus
 - in Deum, Patrem omnipotentem
 - et in Iesum Christum, Filium eius unicum
 - in Spiritum Sanctum
"#;

let mut tree = Tree::parse(SRC)?;
assert_eq!(10, tree.len());

// First, the low-level, index-based API
let root_id = tree.root_id()?;
assert_eq!(root_id, 0);
assert_eq!(tree.num_children(root_id)?, 3);
for i in 0..tree.num_children(root_id)? {
  let child_id = tree.child_at(root_id, i)?;
  println!("{}", tree.key_scalar(child_id)?.scalar); // "Hello", "Names", "Credo"
}

// Next, the high-level, NodeRef API
let world = tree.root_ref()?.get("Hello")?;
assert_eq!(world.val()?, "World");
let credo = tree.root_ref()?.get("Credo")?;
assert!(credo.is_seq()?);
assert_eq!(credo.val_tag()?, "!!apostolicus");    
for node in credo.iter()? {
  println!("{}", node.val()?);
}

// Mutate the tree
{
   let mut root_ref_mut = tree.root_ref_mut()?;
   let mut credo = root_ref_mut.get_mut("Credo")?;
   let mut amen = credo.get_mut(3)?; // A new index
   amen.set_val("Amen")?;
}

// Serialize the tree back to a string
let new_text = tree.emit()?;

static END: &str = r#"Hello: World
Names:
 - Caleb
 - Voronwe
 - 'Nicene Nerd'
Credo: !!apostolicus
 - 'in Deum, Patrem omnipotentem'
 - 'et in Iesum Christum, Filium eius unicum'
 - in Spiritum Sanctum
 - Amen
"#;

assert_eq!(new_text, END);

For more usage information, see the full documentation.

Contributing

Issue tracker: https://github.com/NiceneNerd/ryml/issues
Source code: https://github.com/NiceneNerd/ryml

Some welcome to-dos:

  • Anything that would improve error handling
  • no_std support is an eventual goal
  • Safety improvements
  • Could definitely use more tests and such

License

This project is licensed under the GPLv3+ license. The original ryml library is licensed under the MIT license.

Dependencies

~3–28MB
~387K SLoC