Tpt
68e5fb43df
|
5 years ago | |
---|---|---|
.github/workflows | 5 years ago | |
bench | 5 years ago | |
lib | 5 years ago | |
server | 5 years ago | |
.gitignore | 7 years ago | |
.gitmodules | 6 years ago | |
Cargo.toml | 5 years ago | |
LICENSE-APACHE | 7 years ago | |
LICENSE-MIT | 7 years ago | |
README.md | 5 years ago | |
clippy.toml | 6 years ago |
README.md
Rudf
Rudf is a work in progress graph database implementing the SPARQL standard.
There is no released version yet.
Its goal is to provide a compliant, safe and fast graph database based on the RocksDB key-value store. It is written in Rust.
The lib
directory contains the database written as a Rust library and the server
directory a stand-alone binary of a web server implementing the SPARQL 1.1 Protocol.
Are currently implemented:
- SPARQL 1.1 Query except
FROM
andFROM NAMED
. - 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 and SPARQL Query Results JSON Format.
Run the web server
Build
You need to have a recent stable version of Rust and Cargo installed.
If it's done, executing cargo build --release
in the root directory of this repository should compile the full server after having downloaded its dependencies.
It will create a fat binary in target/release/rudf_server
.
Usage
Run ./rudf_server
to start the server. It listen by default on localhost:7878
.
The server provides an HTML UI with a form to execute SPARQL requests.
It provides the following routes:
/
allows toPOST
data to the server. For examplecurl -f -X POST -H 'Content-Type:application/n-triples' --data-binary "@MY_FILE.nt" http://localhost:7878/
will add the N-Triples file MY_FILE.nt to the server repository. Turtle, TriG, N-Triples, N-Quads and RDF XML are supported./query
allows to evaluate SPARQL queries against the server repository following the SPARQL 1.1 Protocol. For examplecurl -f -X POST -H 'Content-Type:application/sparql-query' --data 'SELECT * WHERE { ?s ?p ?o } LIMIT 10' http://localhost:7878/query
. This route supports content negotiation and could return Turtle, N-Triples, RDF XML, SPARQL Query Results XML Format and SPARQL Query Results JSON Format.
Use rudf_server --help
to see the possible options when starting the server.
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 Futures by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.