Crate oxiland 

Embedded RDF datasets, SPARQL, persistence, and streaming I/O for Rust.

Oxiland provides a safe application facade powered by Oxigraph. RDF term types are re-exported so callers can move data into and out of the broader Oxigraph ecosystem without adapters. Redland workflow mappings are retained as an evidence-scoped migration surface without copying manual-memory ownership rules into Rust (ADR-004).

Module layout (1.0 naming freeze intent — ADR-020)

Stable public modules: terms, io, storage, utility, plus root re-exports such as Model, World, Query, Update, and Error. Breaking renames after 0.6 require an ADR and CHANGELOG entry.

Quick start

use oxiland::terms::{self, Literal, Triple};
use oxiland::{Model, Query, QueryResults};

let model = Model::new()?;
model.add(Triple::new(
    terms::named_node("https://example.com/alice")?,
    terms::named_node("https://example.com/name")?,
    Literal::new_simple_literal("Alice"),
))?;

assert!(matches!(
    Query::new("ASK { ?s ?p ?o }").execute(&model)?,
    QueryResults::Boolean(true)
));

Re-exports

pub use storage::OpenOptions;

pub use storage::StorageBackend;

pub use storage::StorageCapabilities;

pub use storage::compiled_backends;

pub use storage::is_known_backend_name;

Modules

io

Streaming RDF parsing and serialization.

sparql

Oxigraph SPARQL primitives for advanced use cases.

storage

Storage backends, open options, and capability reporting (0.4 / ADR-022).

terms

RDF term, triple, quad, and graph-name types used by Oxiland.

utility

URI, digest, Unicode, namespace, and vocabulary helpers (0.5).

Structs

LogRecord

One log record delivered to handlers.

Model

An RDF graph model backed by an Oxigraph store.

ModelTransaction

Mutator available inside Model::transaction.

ParseError

Structured RDF parse failure.

Query

A SPARQL query configured before execution (ADR-009).

StatementMatches

Streaming matches produced by Model::find.

StatementPattern

A partial triple pattern, equivalent to Redland’s statement matching API.

Update

A SPARQL Update operation configured before execution (ADR-009).

World

Process-level configuration, feature registry, and logging (ADR-014).

Enums

Error

Errors produced by Oxiland.

FeatureValue

A Redland-style feature value.

LogFacility

Logical log facility (ADR-014).

LogLevel

Log severity for World logging (ADR-014).

QueryResults

Results returned by a SPARQL query (ADR-010).

ResultsFormat

Closed set of SPARQL Query Results formats (ADR-011).

Functions

serialize_graph_results_to_writer

Serializes CONSTRUCT/DESCRIBE QueryResults::Graph with an RDF Serializer.

serialize_query_results_to_string

Serializes ASK or SELECT QueryResults to a UTF-8 string.

serialize_query_results_to_writer

Serializes ASK or SELECT QueryResults to a writer.

Type Aliases

Result

Result type used throughout Oxiland.