Crate json_ptr[][src]

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.

Build Status crates.io Documentation

Creating a JSON Pointer

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

extern crate json_ptr as json_pointer;

use json_pointer::JsonPointer;

fn main() {
    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.

extern crate json_ptr as json_pointer;
#[macro_use]
extern crate serde_json;

use json_pointer::JsonPointer;

fn main() {
    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.

extern crate json_ptr as json_pointer;

use json_pointer::JsonPointer;

fn main() {
    let str_ptr = "/f%o".parse::<JsonPointer<_, _>>().unwrap();
    let uri_ptr = "#/f%25o".parse::<JsonPointer<_, _>>().unwrap();
 
    assert_eq!(str_ptr, uri_ptr);
}

Structs

JsonPointer

A JSON Pointer.

Enums

IndexError

An error that can be encountered when indexing using a JSON pointer.

ParseError

An error that can be encountered when parsing.