#serde #serialization #json #toml #yaml


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

#1218 in Encoding

Download history 300/week @ 2023-07-25 161/week @ 2023-08-01 168/week @ 2023-08-08 272/week @ 2023-08-15 181/week @ 2023-08-22 168/week @ 2023-08-29 240/week @ 2023-09-05 243/week @ 2023-09-12 200/week @ 2023-09-19 249/week @ 2023-09-26 151/week @ 2023-10-03 193/week @ 2023-10-10 243/week @ 2023-10-17 293/week @ 2023-10-24 204/week @ 2023-10-31 264/week @ 2023-11-07

1,033 downloads per month
Used in 13 crates (9 directly)


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

serde_any = "0.5"

The list of supported formats can be controlled via feature flags

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


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)?;


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

    let m = MyStruct { ... };

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.


Licensed under either of

at your option.


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.


~68K SLoC