百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
S

saphyr

> 编程语言
开源

一组专门用于解析 YAML 的框架。

329 stars0 点赞2 次浏览
访问官网GitHub

工具介绍

一组专门用于解析 YAML 的框架。

Saphyr libraries

This repository is home to saphyr-parser, saphyr and soon-to-be saphyr-serde. These crates provide fully YAML 1.2 compliant parsing and manipulation, with a focus on correctness, performance and API friendliness (in that order).

saphyr is the most user-friendly and high-level crate, providing quick-and-easy YAML importing, exporting and object manipulation.

rust
use saphyr::{LoadableYamlNode, Yaml, YamlEmitter};

let docs = Yaml::load_from_str("[1, 2, 3]").unwrap();
let doc = &docs[0]; // select the first YAML document
assert_eq!(doc[0].as_integer().unwrap(), 1); // access elements by index

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

saphyr-parser is the parser behind saphyr. It provides direct access to the parsing process by emitting YAML events. It does not include YAML to object mapping, but is a lightweight alternative to saphyr for those interested in building directly atop the parser, without having an intermediate conversion to a Rust object. More details on where to start are available on doc.rs.

rust
/// Sink of events. Collects them into an array.
struct EventSink {
    events: Vec,
}

/// Implement `on_event`, pushing into `self.events`.
impl EventReceiver for EventSink {
    fn on_event(&mut self, ev: Event) {
        self.events.push(ev);
    }
}

/// Load events from a yaml string.
fn str_to_events(yaml: &str) -> Vec {
    let mut sink = EventSink { events: Vec::new() };
    let mut parser = Parser::new_from_str(yaml);
    // Load events using our sink as the receiver.
    parser.load(&mut sink, true).unwrap();
    sink.events
}

Specification Compliance

This implementation is fully compatible with the YAML 1.2 specification. saphyr-parser) tests against (and passes) the YAML test suite.

License

Sets of licences are available for each of the crates. Due to this project being based on a fork of chyh1990's yaml-rust, there are 2 licenses to be included if using saphyr or saphyr-parser. Refer to the projects' READMEs for details.

Contribution

Fork this repository and Create a Pull Request on Github. You may need to click on "compare across forks" and select your fork's branch.

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.

Links

saphyr

  • saphyr source code repository
  • saphyr releases on crates.io
  • saphyr documentation on docs.rs

saphyr-parser

  • saphyr-parser source code repository
  • saphyr-parser releases on crates.io
  • saphyr-parser documentation on docs.rs

Other links

  • yaml-test-suite
  • YAML 1.2 specification

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Rustparsingrustyaml

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月18日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言