2 releases

0.8.24 Jun 5, 2022
0.8.17 Mar 27, 2021

#612 in Encoding

Download history 3457/week @ 2024-02-26 4306/week @ 2024-03-04 3048/week @ 2024-03-11 3510/week @ 2024-03-18 1846/week @ 2024-03-25 2261/week @ 2024-04-01 2331/week @ 2024-04-08 2441/week @ 2024-04-15 2067/week @ 2024-04-22 1501/week @ 2024-04-29 1270/week @ 2024-05-06 1789/week @ 2024-05-13 2263/week @ 2024-05-20 1535/week @ 2024-05-27 1673/week @ 2024-06-03 957/week @ 2024-06-10

6,482 downloads per month

MIT/Apache

175KB
4K SLoC

Serde YAML (with quirks)

This fork of serde-yaml implements golang-compatible octal parsing quirk, this feature was not accepted in upstream, but is required in jrsonnet for golang implementation compatibility

See here: https://github.com/dtolnay/serde-yaml/pull/225

This crate is a Rust library for using the Serde serialization framework with data in YAML file format.

This library does not reimplement a YAML parser; it uses yaml-rust which is a pure Rust YAML 1.2 implementation.

Dependency

[dependencies]
serde = "1.0"
serde_yaml = "0.8"

Release notes are available under GitHub releases.

Using Serde YAML

API documentation is available in rustdoc form but the general idea is:

use std::collections::BTreeMap;

fn main() -> Result<(), serde_yaml::Error> {
    // You have some type.
    let mut map = BTreeMap::new();
    map.insert("x".to_string(), 1.0);
    map.insert("y".to_string(), 2.0);

    // Serialize it to a YAML string.
    let s = serde_yaml::to_string(&map)?;
    assert_eq!(s, "---\nx: 1.0\ny: 2.0\n");

    // Deserialize it back to a Rust type.
    let deserialized_map: BTreeMap<String, f64> = serde_yaml::from_str(&s)?;
    assert_eq!(map, deserialized_map);
    Ok(())
}

It can also be used with Serde's derive macros to handle structs and enums defined by your program.

[dependencies]
serde = { version = "1.0", features = ["derive"] }
serde_yaml = "0.8"
use serde::{Serialize, Deserialize};

#[derive(Debug, PartialEq, Serialize, Deserialize)]
struct Point {
    x: f64,
    y: f64,
}

fn main() -> Result<(), serde_yaml::Error> {
    let point = Point { x: 1.0, y: 2.0 };

    let s = serde_yaml::to_string(&point)?;
    assert_eq!(s, "---\nx: 1.0\ny: 2.0\n");

    let deserialized_point: Point = serde_yaml::from_str(&s)?;
    assert_eq!(point, deserialized_point);
    Ok(())
}

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~1.5MB
~30K SLoC