#data-model #serde #data-structures #value #content #offers #design

no-std serde-content

Rust data structures for the Serde data model

2 unstable releases

0.1.0 Aug 5, 2024
0.0.0 Jul 18, 2024

#262 in Encoding

Download history 103/week @ 2024-07-14 5/week @ 2024-07-21 320/week @ 2024-08-04 1191/week @ 2024-08-11 1613/week @ 2024-08-18 1337/week @ 2024-08-25 1704/week @ 2024-09-01 1492/week @ 2024-09-08

6,192 downloads per month
Used in 9 crates (6 directly)

MIT/Apache

130KB
4K SLoC

Serde data model

serde-content is an alternative design for the private Serde content types like this one. These types are used to store the Rust values that represent the Serde data model. The model is stable and well documented.

This crate offers a unified design for both serialising and deserialising data. The goal is to offer a stable interface with roundtrip guarantees when serialising to and deserialising from Value using our Serializer and Deserializer.

Example

use serde::{Deserialize, Serialize};
use serde_content::{Deserializer, Serializer};

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

fn main() -> serde_content::Result<()> {
    let point = Point { x: 1, y: 2 };

    // Convert the Point to the Value type.
    let serialized = Serializer::new().serialize(&point)?;

    // Pretty print the serialised Value.
    dbg!(&serialized);

    // Convert the Value back to a Point.
    let deserialized: Point = Deserializer::new(serialized).deserialize()?;

    // Pretty print the deserialised Point.
    dbg!(deserialized);

    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 Serde by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~165KB