Crate oxttl

Source
Expand description

§OxTTL

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

Oxttl is a set of parsers and serializers for Turtle, TriG, N-Triples, N-Quads and N3.

Support for SPARQL-star is also available behind the rdf-starfeature for all languages but N3 (Turtle-star, TriG-star, N-Triples-star and N-Quads-star)

It is designed as a low level parser compatible with both synchronous and asynchronous I/O.

Usage example counting the number of people in a Turtle file:

use oxrdf::{NamedNodeRef, vocab::rdf};
use oxttl::TurtleParser;

let file = b"@base <http://example.com/> .
@prefix schema: <http://schema.org/> .
<foo> a schema:Person ;
    schema:name \"Foo\" .
<bar> a schema:Person ;
    schema:name \"Bar\" .";

let schema_person = NamedNodeRef::new("http://schema.org/Person").unwrap();
let mut count = 0;
for triple in TurtleParser::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.

Re-exports§

pub use crate::n3::N3Parser;
pub use crate::nquads::NQuadsParser;
pub use crate::nquads::NQuadsSerializer;
pub use crate::ntriples::NTriplesParser;
pub use crate::ntriples::NTriplesSerializer;
pub use crate::trig::TriGParser;
pub use crate::trig::TriGSerializer;
pub use crate::turtle::TurtleParser;
pub use crate::turtle::TurtleSerializer;

Modules§

n3
A N3 streaming parser implemented by N3Parser.
nquads
A N-Quads streaming parser implemented by NQuadsParser and a serializer implemented by NQuadsSerializer.
ntriples
A N-Triples streaming parser implemented by NTriplesParser and a serializer implemented by NTriplesSerializer.
trig
A TriG streaming parser implemented by TriGParser and a serializer implemented by TriGSerializer.
turtle
A Turtle streaming parser implemented by TurtleParser and a serializer implemented by TurtleSerializer.

Structs§

TextPosition
A position in a text i.e. a line number starting from 0, a column number starting from 0 (in number of code points) and a global file offset starting from 0 (in number of bytes).
TurtleSyntaxError
An error in the syntax of the parsed file.

Enums§

TurtleParseError
A parsing error.