oxiland 0.7.0

Embedded RDF datasets, SPARQL, persistence, and streaming I/O for Rust
Documentation 
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

# Examples

Runnable starting points for Python, Rust, and the command-line package. The
repository examples are executed in CI; production configuration and failure
handling are intentionally expanded in the linked guides.

## Python (`python/examples/`)

Install the published package:

```console
python -m venv .venv
source .venv/bin/activate
python -m pip install oxiland
```

From a repository checkout, run the examples at the repository root:

| Example | What it demonstrates | Run |
|---|---|---|
| `quick_start.py` | Build a model and run ASK | `python python/examples/quick_start.py` |
| `select.py` | Stream SELECT solution rows | `python python/examples/select.py` |
| `parse_serialize.py` | Load Turtle and serialize N-Triples | `python python/examples/parse_serialize.py` |
| `persistent.py` | Open a durable model and commit a transaction | `python python/examples/persistent.py` |

The same workflows are explained in [Models and RDF terms](python-models.md),
[RDF I/O and SPARQL](python-data.md), and
[Production operations](python-production.md).

## Rust (`examples/`)

| Example | What it demonstrates | Run |
|---|---|---|
| `quick_start.rs` | Model + ASK | `cargo run --example quick_start` |
| `select.rs` | SELECT bindings | `cargo run --example select` |
| `construct.rs` | CONSTRUCT | `cargo run --example construct` |
| `update.rs` | SPARQL Update | `cargo run --example update` |
| `contexts.rs` | Named graphs + find | `cargo run --example contexts` |
| `parse_serialize.rs` | Turtle to N-Triples | `cargo run --example parse_serialize` |
| `progressive_load.rs` | Progressive parse load | `cargo run --example progressive_load` |
| `persistent_transaction.rs` | Persistent open + transaction | `cargo run --example persistent_transaction` |
| `std_replacements.rs` | Hash/list replacement notes | `cargo run --example std_replacements` |

## Command line

```console
# Import into a new persistent store
oxiland-cli --new ./catalog parse ./data.ttl

# Query as CSV
oxiland-cli --results csv ./catalog query sparql - \
  'SELECT ?s ?p ?o WHERE { ?s ?p ?o } LIMIT 20'

# Export named graphs safely
oxiland-cli --quiet --output nquads ./catalog serialize > catalog.nq
```

See the [CLI guide](cli.md) for term arguments, stdout/stderr behavior, import
failure semantics, and the 0.7 named-graph restore limitation.

## Next guides

- [Python overview](python.md)
- [Python API reference](python-api.md)
- [Rust getting started](getting-started.md)
- [Rust SPARQL](sparql.md)
- [Rust persistence](persistence.md)
- [CLI](cli.md)