RDFtk: IO

This crate provides traits for reading and writing Statements and Graphs as well as implementations of these for common representations.

The following are some well-known formats (see Wikipedia for a description of different serializations), support is indicated in the final column with an R for read support and W for write support. One additional module, dot allows for the creation of GraphViz dot files for a visualization of a graph's structure.

| Module | Name | MIME Type | R/W | |-----------|---------------------------------------------------------------------------------------------------- |-----------------------------|---------| | nt | RDF 1.1 N-Triples; A line-based syntax for an RDF graph | application/n-triples | R+W | | nq | RDF 1.1 N-Quads; A line-based syntax for RDF datasets | application/n-quads | W | | turtle | RDF 1.1 Turtle; Terse RDF Triple Language | text/turtle | W | | trig | RDF 1.1 TriG; RDF Dataset Language | application/trig | | | xml | RDF 1.1 XML Syntax | application/rdf+xml | W | | json | RDF 1.1 JSON Alternate Serialization | application/rdf+json | R+W | | n3 | Notation3 (N3): A readable RDF syntax | text/rdf+n3 | W | | TBD | Binary RDF Representation for Publication and Exchange (HDT) | N/A | | | TBD | RDF Binary using Apache Thrift | application/x-binary-rdf | | | TBD | JSON-LD 1.1; A JSON-based Serialization for Linked Data | application/ld+json | | | TBD | RDFa Core 1.1 - Third Edition | text/html | |

Each module will also provide public constants NAME, FILE_EXTENSION, and MIME_TYPE.

Example

An example, reading an existing NTriple file.

```rust use rdftkio::nt::reader::NTriplesReader; use rdftkio::GraphReader; use rdftkmemgraph::simple::graphfactory; use std::fs::File; use std::path::PathBuf;

let filepath = PathBuf::from("tests/w3c/nt/literal.nt"); let mut file = File::open(filepath).unwrap(); let reader = NTriplesReader::default(); let graph = reader.read(&mut file, graph_factory()).unwrap(); ```

Changes

Version 0.2.1

• Added JSON reader.

Version 0.2.0

• Updated rdftk_core dependency to 0.3.0, this is a significant API change.
• All read operations require a graph factory now.

Version 0.1.9

• Added unicode escape handling into the IRI parsing.
• All W3C test cases for NTriples now passing.
• Removed local error module, using core error types now.

Version 0.1.8

• Using new style interfaces, a consistent use of traits and trait reference types.
• Have a working NTriple parser.

Version 0.1.7

• Using rdftk_core 0.2, this has changes in the signature of both Graph and DataSet traits.
  • This results in changes to both GraphWriter and DataSetWriter traits.
• Applied a lot more warnings in lib.rs
• Fixed resulting Clippy suggestions.

Version 0.1.6

• Made all modules have separate reader/writer sub-modules.
• Put all modules behind features.
• Added JSON writer.
• Re-write NQuad writer to write datasets.
• Re-wrote NTripe writer to use NQuad writer.
• Fixed formatting in Turtle writer.
• Added XML writer.

Version 0.1.5

• Internal change to use StatementRef.

Version 0.1.4

• API changes in core crate:
  • Altered PrefixMappings::compress and PrefixMappings::expand to take references.

Version 0.1.2

• Made all IRI into IRIRef.

Version 0.1.1

• Made all local dependencies only major/minor valued.

Version 0.1.0

• First release.
• Provides write support only for N-Triples, N-Quads, and GraphViz.

TODO

1. The core; N-Triples, N-Quads, N3, and Turtle need read and write support.
2. The extended core; RDF/XML, JSON-LD, and RDFa need read and write support.
3. The rest; RDF/JSON, TriG, HDT, and BinaryRDF will be implemended as needed.