Yuri Astrakhan
6494ba6e31
|
11 months ago | |
---|---|---|
.. | ||
benches | 12 months ago | |
oxrdf | 11 months ago | |
oxrdfio | 11 months ago | |
oxrdfxml | 11 months ago | |
oxsdatatypes | 11 months ago | |
oxttl | 11 months ago | |
sparesults | 11 months ago | |
spargebra | 11 months ago | |
sparopt | 11 months ago | |
sparql-smith | 11 months ago | |
src | 11 months ago | |
tests | 12 months ago | |
Cargo.toml | 11 months ago | |
README.md | 12 months ago |
README.md
Oxigraph
Oxigraph is a graph database library implementing the SPARQL standard.
Its goal is to provide a compliant, safe and fast on-disk graph database. It also provides a set of utility functions for reading, writing, and processing RDF files.
Oxigraph is in heavy development and SPARQL query evaluation has not been optimized yet.
Oxigraph also provides a CLI tool and a Python library based on this library.
Oxigraph implements the following specifications:
- SPARQL 1.1 Query, SPARQL 1.1 Update, and SPARQL 1.1 Federated Query.
- Turtle, TriG, N-Triples, N-Quads, and RDF XML RDF serialization formats for both data ingestion and retrieval using the Rio library.
- SPARQL Query Results XML Format, SPARQL 1.1 Query Results JSON Format and SPARQL 1.1 Query Results CSV and TSV Formats.
A preliminary benchmark is provided. Oxigraph internal design is described on the wiki.
The main entry point of Oxigraph is the Store
struct:
use oxigraph::store::Store;
use oxigraph::model::*;
use oxigraph::sparql::QueryResults;
let store = Store::new().unwrap();
// insertion
let ex = NamedNode::new("http://example.com").unwrap();
let quad = Quad::new(ex.clone(), ex.clone(), ex.clone(), GraphName::DefaultGraph);
store.insert(&quad).unwrap();
// quad filter
let results = store.quads_for_pattern(Some(ex.as_ref().into()), None, None, None).collect::<Result<Vec<Quad>,_>>().unwrap();
assert_eq!(vec![quad], results);
// SPARQL query
if let QueryResults::Solutions(mut solutions) = store.query("SELECT ?s WHERE { ?s ?p ?o }").unwrap() {
assert_eq!(solutions.next().unwrap().unwrap().get("s"), Some(&ex.into()));
}
Some parts of this library are available as standalone crates:
oxrdf
, datastructures encoding RDF basic concepts (theoxigraph::model
module).oxrdfio
, a unified parser and serializer API for RDF formats (theoxigraph::io
module). It itself relies on:spargebra
, a SPARQL parser.sparesults
, parsers and serializers for SPARQL result formats.sparopt
, a SPARQL optimizer.oxsdatatypes
, an implementation of some XML Schema datatypes.
To build the library locally, don't forget to clone the submodules using git clone --recursive https://github.com/oxigraph/oxigraph.git
to clone the repository including submodules or git submodule update --init
to add submodules to the already cloned repository.
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.