#serde #serialization #json #toml #yaml

serde_any

Dynamic serialization and deserialization with the format chosen at runtime

9 releases (4 breaking)

Uses old Rust 2015

0.5.0 Jul 19, 2018
0.4.1 Jul 2, 2018
0.3.0 Jun 28, 2018
0.2.1 Jun 25, 2018
0.1.2 Jun 19, 2018

#1275 in Encoding

Download history 327/week @ 2023-11-16 258/week @ 2023-11-23 222/week @ 2023-11-30 244/week @ 2023-12-07 123/week @ 2023-12-14 143/week @ 2023-12-21 138/week @ 2023-12-28 171/week @ 2024-01-04 216/week @ 2024-01-11 130/week @ 2024-01-18 122/week @ 2024-01-25 323/week @ 2024-02-01 200/week @ 2024-02-08 243/week @ 2024-02-15 200/week @ 2024-02-22 125/week @ 2024-02-29

965 downloads per month
Used in 13 crates (9 directly)

MIT/Apache

56KB
786 lines

Serde Any

Dynamic serialization and deserialization with the format chosen at runtime. This crate allows you to serialize and deserialize data using serde without having to choose the data format up-front. The format can be either chosen at runtime, inferred from the file name, or guessed by attemting each supported format until one succeeds.

Supported formats

By default, JSON, YAML, TOML, RON, XML, and URL encoding formats are supported

[dependencies]
serde_any = "0.5"

The list of supported formats can be controlled via feature flags

[dependencies]
serde_any = { version = "0.5", default-features = false, features = ["yaml", "toml"] }

Deserialization

Structs that implement serde::de::Deserialize can be deserialized from a given file

let m: MyStruct = serde_any::from_file("my_data.json")?;

If support for multiple formats is desired, data can be deserialized from a fixed file stem. The following will look for my_data.json, my_data.yaml, my_data.yml, my_data.toml, my_data.ron, my_data.xml.

let m: MyStruct = serde_any::from_file_stem("my_data")?;

Deserialization can also be done from a string, a byte array, or a reader, with any format

let m1: MyStruct = serde_any::from_str_any(r#"{"name": "value"}"#)?;
let m2: MyStruct = serde_any::from_slice_any(b"name: value")?;

The serde_any crate also provides similar deserialization function with a fixed format

let m1: MyStruct = serde_any::from_str(r#"{"name": "value"}"#, serde_any::Format::Json)?;
let m2: MyStruct = serde_any::from_slice(b"name: value", serde_any::Format::Yaml)?;
let m3: MyStruct = serde_any::from_reader(File::open("some_data_file.toml")?, serde_any::Format::Toml)?;

Serialization

Structs that implement serde::ser::Serialize can be serialized into a file

    let m = MyStruct { ... };
    serde_any::to_file("my_data.json")?;

or to a string, a byte array, or a writer, with a fixed format

let m = MyStruct { ... };
let json_string = serde_any::to_string(&m, Format::Json)?;
let yaml_byte_vec = serde_any::to_vec(&m, Format::Yaml)?;

let writer = File::create("some_data_file.toml")?;
serde_any::to_writer(writer, Format::Toml)?;

All serialization functions have pretty printing variants with a _pretty suffix.

License

Licensed under either of

at your option.

Contribution

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.

Dependencies

~1.2–3MB
~68K SLoC