serde-content

Rust data structures for the Serde data model

APACHE-2.0 License

Downloads
17.7K
Stars
5

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