yaml-peg

A YAML 1.2 parser using greedy parsing algorithm with PEG atoms. Support anchor visitor and no-std.

Inspired from yaml-rust and serde-yaml.

This parser is not ensure about YAML spec but almost functions are well-implemented. The buffer reader has also not yet been implemented, but the chunks can be read by the sub-parsers.

After parsing, the anchors can be visited by the anchor visitor.

use yaml_peg::{parse, node};

let doc = "
---
name: Bob
married: true
age: 46
";
let (n, anchors) = parse(doc).unwrap();
assert_eq!(anchors.len(), 0);
assert_eq!(n, vec![node!({
    "name" => "Bob",
    "married" => true,
    "age" => 46,
})]);

See the API doc for more information.

Features

• Support no standard library #![no_std].
• Different data holder Rc / Arc provides parallel visiting and less copy cost.
• Provide document position, tag and anchor reference on the nodes.
• YAML directives YAML and TAG are allowed.

  %YAML 1.2
  %TAG !x! tag:my.prefix:
  ---
  

• Support serde to help you serialize and deserialize a specific type. (as well as the anchors)

  use serde::Deserialize;
  use yaml_peg::serialize::from_str;
  
  #[derive(Deserialize)]
  struct Member {
     name: String,
     married: bool,
     age: u8,
  }
  
  let doc = "
  ---
  name: Bob
  married: true
  age: 46
  ";
  // Return Vec<Member>, use `.remove(0)` to get the first one
  let officer = from_str::<Member>(doc).unwrap().remove(0);
  assert_eq!("Bob", officer.name);
  assert!(officer.married);
  assert_eq!(46, officer.age);