Fork of https://github.com/oxigraph/oxigraph.git for the purpose of NextGraph project
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
oxigraph/lib
dependabot[bot] d4390ad68b Update quick-xml requirement from 0.21 to 0.22 4 years ago
..
benches Implements a crate for the testsuite, adds parser tests and a better isomorphism algorithm 4 years ago
src Adds examples (and tests) to SledStore 4 years ago
tests Makes Oxigraph store "graph aware" 4 years ago
Cargo.toml Update quick-xml requirement from 0.21 to 0.22 4 years ago
README.md Splits the main README into a README per component 4 years ago

README.md

Oxigraph

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

Oxigraph is a graph database library implementing the SPARQL standard.

Its goal is to provide a compliant, safe and fast graph database. It also provides a set of utility functions for reading, writing, and processing RDF files.

It currently provides three store implementations providing SPARQL capability:

  • MemoryStore: a simple in memory implementation.
  • RocksDbStore: a file system implementation based on the RocksDB key-value store. It requires the "rocksdb" feature to be activated. The clang compiler needs to be installed to compile RocksDB.
  • SledStore: another file system implementation based on the Sled key-value store. It requires the "sled" feature to be activated. Sled is much faster to build than RockDB and does not require a C++ compiler. However, Sled is still in development, less tested and data load seems much slower than RocksDB.

Oxigraph is in heavy development and SPARQL query evaluation has not been optimized yet.

The disabled by default "sophia" feature provides sophia_api traits implementation on Oxigraph terms and stores.

Oxigraph also provides a standalone HTTP server and a Python library based on this library.

Oxigraph implements the following specifications:

A preliminary benchmark is provided.

Usage example with the MemoryStore:

use oxigraph::MemoryStore;
use oxigraph::model::*;
use oxigraph::sparql::QueryResults;

let store = MemoryStore::new();

// insertion
let ex = NamedNode::new("http://example.com")?;
let quad = Quad::new(ex.clone(), ex.clone(), ex.clone(), None);
store.insert(quad.clone());

// quad filter
let results: Vec<Quad> = store.quads_for_pattern(Some(ex.as_ref().into()), None, None, None).collect();
assert_eq!(vec![quad], results);

// SPARQL query
if let QueryResults::Solutions(mut solutions) =  store.query("SELECT ?s WHERE { ?s ?p ?o }")? {
    assert_eq!(solutions.next().unwrap()?.get("s"), Some(&ex.into()));
}

License

This project is licensed under either of

at your option.

Contribution

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