pyrudof - Python bindings for Rudof
pyrudof provides Python bindings for rudof,
a Rust library for Semantic Web operations.
At a high level it supports:
- Loading and serializing RDF and PG data.
- Loading, checking, serializing and validating ShEx schemas.
- Loading, serializing and validating SHACL shapes.
- Loading, serializing and validating PGSchemas.
- Loading, running and serializing SPARQL queries and query results.
- Converting and comparing schemas between supported formats.
- Loading and serializing DCTAP and Service Descriptions.
- Generating synthetic data from schemas.
Installation
Install from PyPI (recommended)
pip install pyrudof
pyrudof is built with PyO3 using abi3 wheels (Python 3.7+ compatible).
Build from source
Building from source requires a working Rust toolchain and Python.
# Clone the repository
git clone https://github.com/rudof-project/rudof.git
cd rudof/python
# Optional but recommended: virtual environment
python -m venv .venv
# Linux/macOS:
source .venv/bin/activate
# Windows PowerShell:
# .\.venv\Scripts\Activate.ps1
# Build and install editable package
pip install maturin
pip install -e .
For a release wheel:
maturin build --release
pip install --force-reinstall target/wheels/pyrudof-*.whl
Architecture and package structure
Package layout
| Path | Purpose |
|---|---|
src/ |
Rust implementation of the Python bindings (Rudof, RudofConfig, generator APIs, enums, and error mappings). |
stubs/pyrudof/ |
Hand-maintained .pyi type stubs for static type checking and editor support. |
examples/ |
Runnable example scripts organized by category, plus examples.toml manifest metadata. |
tests/ |
Python unittest suite and manifest registry loader for example-based tests. |
docs/ |
Sphinx docs, including the examples page generator (generate_examples_doc.py). |
Cargo.toml / pyproject.toml |
Rust crate and Python build configuration (maturin + PyO3). |
Test architecture
Tests are dynamically generated from examples/examples.toml.
Each generated test:
- Executes the registered Python example as a subprocess.
- Asserts a zero exit code.
- Checks configured
expected_outputsubstrings (if any).
| Component | Purpose |
|---|---|
tests/test_examples.py |
Builds dynamic unittest.TestCase classes per category/example. |
tests/examples_registry.py |
Loads and validates examples/examples.toml entries. |
examples/examples.toml |
Single source of truth for metadata and category order. |
examples/**/*.py |
Executable example scripts run by tests and referenced by docs. |
Testing
All test commands are run from bindings/python/tests.
Run the full suite
cd bindings/python/tests
python -m unittest discover -vvv
Run a specific category or test
# All ShEx examples
python -m unittest test_examples.TestShexExamples -v
# All SHACL examples
python -m unittest test_examples.TestShaclExamples -v
# All data generation examples
python -m unittest test_examples.TestGenerateExamples -v
# A single example
python -m unittest test_examples.TestShexExamples.test_shex_validate_inline -v
Run skipped examples
Examples marked with skip_test = true in the manifest are skipped by default.
# Linux/macOS
RUN_SKIPPED_EXAMPLES=1 python -m unittest test_examples -v
# Windows PowerShell
$env:RUN_SKIPPED_EXAMPLES="1"; python -m unittest test_examples -v
Examples and documentation
The examples system is intentionally centralized:
examples/examples.tomlstores metadata (key,source_file,title,description,category,files,expected_output,skip_test).examples/**/*.pystores the executable code.tests/test_examples.pyanddocs/generate_examples_doc.pyboth read from that same manifest.
Available categories
| Category | Description |
|---|---|
rdf |
RDF loading, serialization, node inspection |
sparql |
SELECT / CONSTRUCT query workflows |
shex |
ShEx loading, validation, and serialization |
shacl |
SHACL loading, validation, extraction, serialization |
dctap |
DCTAP profile handling |
endpoint |
Service description examples |
generate |
Synthetic data generation APIs |
utility |
Config, resets, version, module/error helpers |
Add a new example
- Create a runnable script under
bindings/python/examples/(recommended: place it inside a category subfolder, for examplebindings/python/examples/shex/my_example.py). - Register it in
bindings/python/examples/examples.toml. - Run tests from
bindings/python/tests. - Regenerate and check docs in
bindings/python/docs.
Manifest template:
[[example]]
key = "my_example"
source_file = "shex/my_example.py"
title = "My Example"
description = "What this example demonstrates"
category = "shex" # rdf | sparql | shex | shacl | dctap | endpoint | generate | utility
files = { data = "person.ttl" } # optional referenced files
expected_output = ["Alice"] # optional substrings (can be empty list)
# skip_test = true # optional (network/special runtime)
Build docs locally
cd bindings/python/docs
python generate_examples_doc.py --update
python generate_examples_doc.py --check
python -m sphinx -b html . _build/html
Then open bindings/python/docs/_build/html/index.html.
1 maintainer
Metadata
1 maintainer
Release files for pyrudof 0.3.18
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| pyrudof-0.3.18-cp37-abi3-win_amd64.whl | CPython 3.7 | abi3 | Windows x86-64 | Details |
| pyrudof-0.3.18-cp37-abi3-manylinux_2_34_x86_64.whl | CPython 3.7 | abi3 | Linux glibc 2.34+ x86-64 | Details |
| pyrudof-0.3.18-cp37-abi3-manylinux_2_34_aarch64.whl | CPython 3.7 | abi3 | Linux glibc 2.34+ ARM64 | Details |
| pyrudof-0.3.18-cp37-abi3-macosx_13_0_x86_64.whl | CPython 3.7 | abi3 | macOS 13.0+ x86-64 | Details |
| pyrudof-0.3.18-cp37-abi3-macosx_13_0_arm64.whl | CPython 3.7 | abi3 | macOS 13.0+ ARM64 | Details |
Total release size: 97.8 MB
Release files / pyrudof-0.3.18-cp37-abi3-win_amd64.whl
| Download URL | pyrudof-0.3.18-cp37-abi3-win_amd64.whl |
|---|---|
| Size | 18.3 MB |
| Tags | CPython 3.7 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
dae16438e0b6f8e49cd4b9fa8aaa19b75126de5ab11ada7e56188b8e4b87d0c1
|
|
BLAKE2b-256 checksum How to use checksums |
fb4d4fb1520f742e82cc5e9b7c2c7e883ff7200a4d9ff9e878264f57bbcfc176
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / pyrudof-0.3.18-cp37-abi3-manylinux_2_34_x86_64.whl
| Download URL | pyrudof-0.3.18-cp37-abi3-manylinux_2_34_x86_64.whl |
|---|---|
| Size | 23.6 MB |
| Tags | CPython 3.7 Linux glibc 2.34+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
73ea67788463a9801f2630843baf7a73393b01d88c36b5c952d4f45a4e477e2e
|
|
BLAKE2b-256 checksum How to use checksums |
41f11bffe78245158613a968d3c9958defed99ee9e02a409a2ffac679c440506
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / pyrudof-0.3.18-cp37-abi3-manylinux_2_34_aarch64.whl
| Download URL | pyrudof-0.3.18-cp37-abi3-manylinux_2_34_aarch64.whl |
|---|---|
| Size | 23.3 MB |
| Tags | CPython 3.7 Linux glibc 2.34+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
4a7cbfef548bf5be4b3bbff1fe666f7e3b2f03406e67261cc1246707f4c5e516
|
|
BLAKE2b-256 checksum How to use checksums |
92001bca3e6f66d2bf044eff7e75d8cf2e740aa2d99b4af334b360731901d6d9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / pyrudof-0.3.18-cp37-abi3-macosx_13_0_x86_64.whl
| Download URL | pyrudof-0.3.18-cp37-abi3-macosx_13_0_x86_64.whl |
|---|---|
| Size | 16.7 MB |
| Tags | CPython 3.7 abi3 macOS 13.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
f3405535617e7cf2a16a95871e1984adb0c33a0390f812f9e2a49f4cc149c5ce
|
|
BLAKE2b-256 checksum How to use checksums |
2c35e166ac33a12aa765babd5e76e465b589e5e020a2b67f8b466b9b9b9ae498
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / pyrudof-0.3.18-cp37-abi3-macosx_13_0_arm64.whl
| Download URL | pyrudof-0.3.18-cp37-abi3-macosx_13_0_arm64.whl |
|---|---|
| Size | 15.9 MB |
| Tags | CPython 3.7 abi3 macOS 13.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
b4ce1f001677e0f808bf301d3046f92c1df930aa91e0902a16987651a561be0b
|
|
BLAKE2b-256 checksum How to use checksums |
b4c1a6e38eb263e6016d0c5eb8dc34bea8a7663b71881645f8a290fde66f8825
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
