#serde #serialization #key #ignored #config-file #fields #data

no-std serde_ignored

Find out about keys that are ignored when deserializing data

15 releases

0.1.10 Jan 2, 2024
0.1.9 Jul 15, 2023
0.1.7 Jan 3, 2023
0.1.6 Dec 17, 2022
0.0.2 Feb 10, 2017

#366 in Encoding

Download history 114137/week @ 2024-08-15 121680/week @ 2024-08-22 130032/week @ 2024-08-29 145657/week @ 2024-09-05 127879/week @ 2024-09-12 126142/week @ 2024-09-19 137744/week @ 2024-09-26 130487/week @ 2024-10-03 127663/week @ 2024-10-10 147693/week @ 2024-10-17 143519/week @ 2024-10-24 140584/week @ 2024-10-31 147618/week @ 2024-11-07 152828/week @ 2024-11-14 159163/week @ 2024-11-21 129361/week @ 2024-11-28

612,661 downloads per month
Used in 309 crates (60 directly)

MIT/Apache

41KB
1K SLoC

Serde ignored

github crates.io docs.rs build status

Find out about keys that are ignored when deserializing data. This crate provides a wrapper that works with any existing Serde Deserializer and invokes a callback on every ignored field.

You can use this to warn users about extraneous keys in a config file, for example.

Note that if you want unrecognized fields to be an error, consider using the #[serde(deny_unknown_fields)] attribute instead.

[dependencies]
serde = "1.0"
serde_ignored = "0.1"
use serde::Deserialize;
use std::collections::{BTreeSet as Set, BTreeMap as Map};

#[derive(Debug, PartialEq, Deserialize)]
struct Package {
    name: String,
    dependencies: Map<String, Dependency>,
}

#[derive(Debug, PartialEq, Deserialize)]
struct Dependency {
    version: String,
}

fn main() {
    let j = r#"{
        "name": "demo",
        "dependencies": {
            "serde": {
                "version": "1.0",
                "typo1": ""
            }
        },
        "typo2": {
            "inner": ""
        },
        "typo3": {}
    }"#;

    // Some Deserializer.
    let jd = &mut serde_json::Deserializer::from_str(j);

    // We will build a set of paths to the unused elements.
    let mut unused = Set::new();

    let p: Package = serde_ignored::deserialize(jd, |path| {
        unused.insert(path.to_string());
    }).unwrap();

    // Deserialized as normal.
    println!("{:?}", p);

    // There were three ignored keys.
    let mut expected = Set::new();
    expected.insert("dependencies.serde.typo1".to_owned());
    expected.insert("typo2".to_owned());
    expected.insert("typo3".to_owned());
    assert_eq!(unused, expected);
}

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

Dependencies

~100–335KB