saphyr

saphyr 是一个完全符合 YAML 1.2 规范的纯 Rust 库。

此作品基于 yaml-rust，针对 YAML 测试套件 进行了修复。 yaml-rust 的解析器受到了 libyaml 和 yaml-cpp 的影响。

saphyr 是一个纯 Rust YAML 1.2 实现，利用了 Rust 语言提供的内存安全和其他优点。

快速开始

安装

将以下内容添加到您的 Cargo.toml 中

[dependencies]
saphyr = "0.0.1"

或使用 cargo add 自动获取最新版本

cargo add saphyr

示例

使用 saphyr::YamlLoader 加载 YAML 文档并将它们作为 Yaml 对象访问

use saphyr::{YamlLoader, YamlEmitter};

fn main() {
    let s =
"
foo:
    - list1
    - list2
bar:
    - 1
    - 2.0
";
    let docs = YamlLoader::load_from_str(s).unwrap();

    // Multi document support, doc is a yaml::Yaml
    let doc = &docs[0];

    // Debug support
    println!("{:?}", doc);

    // Index access for map & array
    assert_eq!(doc["foo"][0].as_str().unwrap(), "list1");
    assert_eq!(doc["bar"][1].as_f64().unwrap(), 2.0);

    // Array/map-like accesses are checked and won't panic.
    // They will return `BadValue` if the access is invalid.
    assert!(doc["INVALID_KEY"][100].is_badvalue());

    // Dump the YAML object
    let mut out_str = String::new();
    {
        let mut emitter = YamlEmitter::new(&mut out_str);
        emitter.dump(doc).unwrap(); // dump the YAML object to a String
    }
    println!("{}", out_str);
}

请注意，saphyr::Yaml 实现了 Index<&'a str> 和 Index<usize>