oneyaml Rust docs
Everything about oneyaml for Rust: getting started, the crate guide, how comments stay attached, moving from serde_yaml, how it compares, and the reference.
Start
Getting startedAdd the crate, read YAML into Rust types with serde, write it back, edit a document in place and keep its comments, and apply JSON Patch and merge patches.Crate guideThe crate README: quick start, diagnostics, patches and pointers, when not to use oneyaml, untrusted input, merge keys, feature flags and the minimum Rust version.
Choosing
ComparisonThis page compares oneyaml with the other Rust YAML libraries you are likely to consider. We wrote it, so it is biased: we have tried to be factual, to cite evidence for every claim, and to say plainly where the others are the better choice. If something here is wrong or out…PerformanceWhat every layer of oneyaml costs against the other Rust YAML libraries, on a fixed, generated corpus of configuration-file shapes. Coming from the chart in the README? Results at a glance has the same comparison bar by bar and as tables (five workloads against the fastest…
Reference
ConformanceMeasured on 2026-10-21 at workspace revision e24c4f8, on the vendored yaml-test-suite (release data-2022-01-17, commit 6e6c296a; 402 cases: 308 valid, 94 error; see crates/test-suite/data/yaml-test-suite/SOURCE.md), with rustc 1.97.1.ChangelogAll notable changes to the published crates (oneyaml, oneyaml-core, oneyaml-syntax). The format follows Keep a Changelog, and versions follow semver. oneyaml and oneyaml-core share a version; oneyaml-syntax has its own, looser track (its syntax tree and event stream may…