Macro serde_with::flattened_maybe
source · [−]macro_rules! flattened_maybe {
($fn:ident, $field:literal) => { ... };
}
Expand description
Support deserializing from flattened and non-flattened representation
When working with different serialization formats, sometimes it is more idiomatic to flatten
fields, while other formats prefer nesting. Using #[serde(flatten)]
only the flattened form
is supported.
This helper creates a function, which support deserializing from either the flattened or the
nested form. It gives an error, when both forms are provided. The flatten
attribute is
required on the field such that the helper works. The serialization format will always be
flattened.
Examples
// Setup the types
#[derive(Deserialize, Debug)]
struct S {
#[serde(flatten, deserialize_with = "deserialize_t")]
t: T,
}
#[derive(Deserialize, Debug)]
struct T {
i: i32,
}
// The macro creates custom deserialization code.
// You need to specify a function name and the field name of the flattened field.
serde_with::flattened_maybe!(deserialize_t, "t");
// Supports both flattened
let j = r#" {"i":1} "#;
assert!(serde_json::from_str::<S>(j).is_ok());
// and non-flattened versions.
let j = r#" {"t":{"i":1}} "#;
assert!(serde_json::from_str::<S>(j).is_ok());
// Ensure that the value is given
let j = r#" {} "#;
assert!(serde_json::from_str::<S>(j).is_err());
// and only occurs once, not multiple times.
let j = r#" {"i":1,"t":{"i":1}} "#;
assert!(serde_json::from_str::<S>(j).is_err());