1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130

//! This crate aims to provide a comprehensive toolkit
//! for working with [RDF] and [Linked Data] in Rust.
//!
//! RDF is a data model
//! designed to exchange knowledge on the Web
//! in an interoperable way.
//! Each piece of knowledge in RDF (a *statement*)
//! is represented by a [triple], made of three [term]s.
//! A set of [triple]s forms an RDF [graph].
//! Finally, several [graph]s can be grouped in a collection
//! called a [dataset], where each [graph] is identified by a unique name.
//!
//! [RDF]: https://www.w3.org/TR/rdf-primer/
//! [Linked Data]: http://linkeddata.org/
//! [triple]: triple/index.html
//! [term]: term/index.html
//! [graph]: graph/index.html
//! [dataset]: dataset/index.html
//!
//! # Generalized vs. Strict RDF model
//!
//! The data model supported by this crate is in fact
//! a superset of the RDF data model as defined by the W3C.
//! When the distinction matters,
//! they will be called, respectively,
//! the *generalized* RDF model, and the *strict* RDF model.
//!
//! # Getting Started
//!
//! Following a short example how to build a graph, mutate it and serialize it
//! back.
//!
//! ```
//! use sophia::graph::{*, inmem::FastGraph};
//! use sophia::ns::Namespace;
//! use sophia::parser::turtle;
//! use sophia::serializer::*;
//! use sophia::serializer::nt::NtSerializer;
//! use sophia::triple::stream::TripleSource;
//!
//! let example = r#"
//!     @prefix : <http://example.org/>.
//!     @prefix foaf: <http://xmlns.com/foaf/0.1/>.
//!
//!     :alice foaf:name "Alice";
//!            foaf:mbox <mailto:alice@work.example> .
//!
//!     :bob foaf:name "Bob".
//! "#;
//! let mut graph: FastGraph = turtle::parse_str(example).collect_triples()?;
//!
//! let ex = Namespace::new("http://example.org/")?;
//! let foaf = Namespace::new("http://xmlns.com/foaf/0.1/")?;
//! graph.insert(
//!     &ex.get("bob")?,
//!     &foaf.get("knows")?,
//!     &ex.get("alice")?,
//! )?;
//!
//! let mut nt_stringifier = NtSerializer::new_stringifier();
//! let example2 = nt_stringifier.serialize_graph(&mut graph)?.as_str();
//! println!("The resulting graph\n{}", example2);
//! # Ok::<(), Box<dyn std::error::Error>>(())
//! ```

pub mod query;

/// This module re-exports symbols from
/// [`sophia_api::dataset`](https://docs.rs/sophia_api/latest/sophia_api/dataset/),
/// and also provides some implementations of its traits.
pub mod dataset {
    pub use sophia_api::dataset::*;
    pub mod indexed;
    pub mod inmem;
}
/// This module re-exports symbols from
/// [`sophia_api::graph`](https://docs.rs/sophia_api/latest/sophia_api/graph/),
/// and also provides some implementations of its traits.
pub mod graph {
    pub use sophia_api::graph::*;
    pub mod indexed;
    pub mod inmem;
}
/// This module re-exports symbols from
/// [`sophia_api::ns`](https://docs.rs/sophia_api/latest/sophia_api/ns/).
pub mod ns {
    pub use sophia_api::ns::*;
}
/// This module re-exports symbols from
/// [`sophia_api::parser`](https://docs.rs/sophia_api/latest/sophia_api/parser/),
/// and also provides some implementations of its traits.
pub mod parser {
    pub use sophia_api::parser::*;
    pub mod gtrig;
    pub mod nq;
    pub mod nt;
    pub mod rio_common;
    pub mod trig;
    pub mod turtle;
    #[cfg(feature = "xml")]
    pub mod xml;
    #[cfg(feature = "xml")]
    pub mod xml_legacy;
}
/// This module re-exports symbols from
/// [`sophia_api::quad`](https://docs.rs/sophia_api/latest/sophia_api/quad/).
pub mod quad {
    pub use sophia_api::quad::*;
}
/// This module re-exports symbols from
/// [`sophia_api::serializer`](https://docs.rs/sophia_api/latest/sophia_api/serializer/),
/// and also provides some implementations of its traits.
pub mod serializer {
    pub use sophia_api::serializer::*;
    pub mod nq;
    pub mod nt;
}
/// This module re-exports symbols from
/// [`sophia_api::term`](https://docs.rs/sophia_api/latest/sophia_api/term/)
/// and
/// [`sophia_term`](https://docs.rs/sophia_term/latest/sophia_term/).
pub mod term {
    pub use sophia_api::term::*;
    pub use sophia_term::*;
}
/// This module re-exports symbols from
/// [`sophia_api::triple`](https://docs.rs/sophia_api/latest/sophia_api/triple/).
pub mod triple {
    pub use sophia_api::triple::*;
}