#json #json-parser #pointers #serde-json #rfc #fragment #uri

json-pointer

A crate for parsing and using JSON pointers, as specified in RFC 6901

7 releases

0.3.4 Sep 5, 2020
0.3.3 Sep 5, 2020
0.3.2 Jun 1, 2017
0.3.1 May 30, 2017
0.1.0 May 26, 2017

#340 in Encoding

Download history 107284/week @ 2024-07-27 106838/week @ 2024-08-03 128433/week @ 2024-08-10 145773/week @ 2024-08-17 139846/week @ 2024-08-24 121609/week @ 2024-08-31 158627/week @ 2024-09-07 129148/week @ 2024-09-14 163147/week @ 2024-09-21 157687/week @ 2024-09-28 191934/week @ 2024-10-05 160708/week @ 2024-10-12 184798/week @ 2024-10-19 191626/week @ 2024-10-26 187215/week @ 2024-11-02 187498/week @ 2024-11-09

780,679 downloads per month
Used in 60 crates (11 directly)

MIT license

19KB
287 lines

json-pointer

A crate for parsing and using JSON pointers, as specified in RFC 6901. Unlike the pointer method built into serde_json, this handles both validating JSON Pointers before use and the URI Fragment Identifier Representation.

pipeline status crates.io Documentation

Creating a JSON Pointer

JSON pointers can be created with a literal [&str], or parsed from a String.

let from_strs = JsonPointer::new([
    "foo",
    "bar",
]);
let parsed = "/foo/bar".parse::<JsonPointer<_, _>>().unwrap();

assert_eq!(from_strs.to_string(), parsed.to_string());
}

Using a JSON Pointer

The JsonPointer type provides .get() and .get_mut(), to get references and mutable references to the appropriate value, respectively.

let ptr = "/foo/bar".parse::<JsonPointer<_, _>>().unwrap();

let document = json!({
    "foo": {
        "bar": 0,
        "baz": 1,
    },
    "quux": "xyzzy"
});

let indexed = ptr.get(&document).unwrap();

assert_eq!(indexed, &json!(0));

URI Fragment Identifier Representation

JSON Pointers can be embedded in the fragment portion of a URI. This is the reason why most JSON pointer libraries require a # character at the beginning of a JSON pointer. The crate will detect the leading # as an indicator to parse in URI Fragment Identifier Representation. Note that this means that this crate does not support parsing full URIs.

let str_ptr = "/f%o".parse::<JsonPointer<_, _>>().unwrap();
let uri_ptr = "#/f%25o".parse::<JsonPointer<_, _>>().unwrap();

assert_eq!(str_ptr, uri_ptr);

Dependencies

~0.5–1MB
~20K SLoC