#error #serialization #serde #path #field-name #element #find

serde_path_to_error

Path to the element that failed to deserialize

17 releases

0.1.16 Mar 9, 2024
0.1.14 Jul 15, 2023
0.1.11 Mar 22, 2023
0.1.9 Dec 17, 2022
0.1.1 Jan 7, 2019

#116 in Encoding

Download history 628298/week @ 2024-08-15 657060/week @ 2024-08-22 604816/week @ 2024-08-29 674783/week @ 2024-09-05 639249/week @ 2024-09-12 656824/week @ 2024-09-19 705742/week @ 2024-09-26 712997/week @ 2024-10-03 705549/week @ 2024-10-10 788117/week @ 2024-10-17 790056/week @ 2024-10-24 739782/week @ 2024-10-31 776047/week @ 2024-11-07 790792/week @ 2024-11-14 738219/week @ 2024-11-21 508113/week @ 2024-11-28

2,950,246 downloads per month
Used in 804 crates (175 directly)

MIT/Apache

84KB
2.5K SLoC

Serde path to error

github crates.io docs.rs build status

Find out the path at which a deserialization error occurred. This crate provides a wrapper that works with any existing Serde Deserializer and exposes the chain of field names leading to the error.

[dependencies]
serde = "1.0"
serde_path_to_error = "0.1"
use serde::Deserialize;
use std::collections::BTreeMap as Map;

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

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

fn main() {
    let j = r#"{
        "name": "demo",
        "dependencies": {
            "serde": {
                "version": 1
            }
        }
    }"#;

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

    let result: Result<Package, _> = serde_path_to_error::deserialize(jd);
    match result {
        Ok(_) => panic!("expected a type error"),
        Err(err) => {
            let path = err.path().to_string();
            assert_eq!(path, "dependencies.serde.version");
        }
    }
}

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

~110–345KB