Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/scholtzan/rdf-rs
RDF library implemented in Rust
https://github.com/scholtzan/rdf-rs
rdf rust sparql
Last synced: 8 days ago
JSON representation
RDF library implemented in Rust
- Host: GitHub
- URL: https://github.com/scholtzan/rdf-rs
- Owner: scholtzan
- License: mit
- Created: 2016-09-04T14:29:32.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2020-11-13T05:05:07.000Z (about 4 years ago)
- Last Synced: 2024-11-01T04:51:50.572Z (15 days ago)
- Topics: rdf, rust, sparql
- Language: Rust
- Homepage: https://scholtzan.github.io/rdf-rs
- Size: 820 KB
- Stars: 25
- Watchers: 3
- Forks: 7
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# rdf-rs
> Note: This project is work in progress and currently not stable.
`rdf` is a library for the [Resource Description Framework](https://www.w3.org/RDF/) (RDF) and [SPARQL](https://www.w3.org/TR/rdf-sparql-query/) implemented in Rust.
This project is a way for me to learn Rust and combine it with my interests in semantic web technologies.
### Usage
Add this to your Cargo.toml:
```toml
[dependencies]
rdf = "0.1.4"
```
### Basic Examples
RDF triples can be stored and represented in a graph.
```rust
use rdf::graph::Graph;
use rdf::uri::Uri;
use rdf::triple::Triple;
let mut graph = Graph::new(None);
let subject = graph.create_blank_node();
let predicate = graph.create_uri_node(&Uri::new("http://example.org/show/localName".to_string()));
let object = graph.create_blank_node();
let triple = Triple::new(&subject, &predicate, &object);
graph.add_triple(&triple);
```
RDF graphs can be serialized to a supported format.
```rust
use rdf::writer::n_triples_writer::NTriplesWriter;
use rdf::writer::rdf_writer::RdfWriter;
use rdf::graph::Graph;
use rdf::uri::Uri;
use rdf::triple::Triple;
let writer = NTriplesWriter::new();
let mut graph = Graph::new(None);
let subject = graph.create_blank_node();
let predicate = graph.create_uri_node(&Uri::new("http://example.org/show/localName".to_string()));
let object = graph.create_blank_node();
let triple = Triple::new(&subject, &predicate, &object);
graph.add_triple(&triple);
assert_eq!(writer.write_to_string(&graph).unwrap(),
"_:auto0 _:auto1 .\n".to_string());
```
RDF syntax can also be parsed and transformed into an RDF graph.
```rust
use rdf::reader::turtle_parser::TurtleParser;
use rdf::reader::rdf_parser::RdfParser;
use rdf::uri::Uri;
let input = "@base .
@prefix rdf: .
@prefix foaf: .
rdf:type foaf:Document ;
\"N-Triples\"@en-US ;
foaf:maker _:art .";
let mut reader = TurtleParser::from_string(input.to_string());
match reader.decode() {
Ok(graph) => {
assert_eq!(graph.count(), 3);
assert_eq!(graph.namespaces().len(), 2);
assert_eq!(graph.base_uri(), &Some(Uri::new("http://example.org/".to_string())))
},
Err(_) => assert!(false)
}
```
## Current State
Currently `rdf-rs` provides basic data structures for representing RDF graphs, triples and nodes.
The following formats can be parsed and serialized:
* Turtle
* N-Triples
## Future Work and Ideas
* Support querying with SPARQL
* Add support for more formats
* More comprehensive `Uri` data structure