#rdf #json-ld #format #foo #graph-database #json-ld-parser

oxjsonld

Work in progress parser and serializer for the JSON-LD format

1 unstable release

new 0.1.0 May 15, 2025

#1451 in Encoding


Used in 36 crates (via oxrdfio)

MIT/Apache

445KB
9K SLoC

OxJSON-LD

Latest Version Released API docs Crates.io downloads actions status Gitter

OxJSON-LD is a parser and serializer for JSON-LD.

The entry points of this library are the two JsonLdParser and JsonLdSerializer structs.

The parser is a work in progress. Only JSON-LD 1.0 is supported at the moment, JSON-LD 1.1 is not supported yet.

The parser supports two modes:

Usage example counting the number of people in a JSON-LD file:

use oxrdf::{NamedNodeRef, vocab::rdf};
use oxjsonld::JsonLdParser;

let file = br#"{
    "@context": {"schema": "http://schema.org/"},
    "@graph": [
        {
            "@type": "schema:Person",
            "@id": "http://example.com/foo",
            "schema:name": "Foo"
        },
        {
            "@type": "schema:Person",
            "schema:name": "Bar"
        }   
    ]
}"#;

let schema_person = NamedNodeRef::new("http://schema.org/Person").unwrap();
let mut count = 0;
for triple in JsonLdParser::new().for_reader(file.as_ref()) {
    let triple = triple.unwrap();
    if triple.predicate == rdf::TYPE && triple.object == schema_person.into() {
        count += 1;
    }
}
assert_eq!(2, count);

License

This project is licensed under either of

  • Apache License, Version 2.0, (LICENSE-APACHE or <http://www.apache.org/licenses/LICENSE-2.0>)
  • MIT license (LICENSE-MIT or <http://opensource.org/licenses/MIT>)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Oxigraph by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0.6–7MB
~43K SLoC