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_output substrings (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.toml stores metadata (key, source_file, title, description, category, files, expected_output, skip_test).
examples/**/*.py stores the executable code.
tests/test_examples.py and docs/generate_examples_doc.py both 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 example bindings/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.

Metadata

Release files for pyrudof 0.3.21

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for pyrudof 0.3.21
File	Interpreter	ABI	Platform	Reset
pyrudof-0.3.21-cp37-abi3-win_amd64.whl 18.4 MB Sep 13, 2026	CPython 3.7	abi3	Windows x86-64	Details
pyrudof-0.3.21-cp37-abi3-manylinux_2_34_x86_64.whl 23.7 MB Sep 13, 2026	CPython 3.7	abi3	Linux glibc 2.34+ x86-64	Details
pyrudof-0.3.21-cp37-abi3-manylinux_2_34_aarch64.whl 23.4 MB Sep 13, 2026	CPython 3.7	abi3	Linux glibc 2.34+ ARM64	Details
pyrudof-0.3.21-cp37-abi3-macosx_13_0_x86_64.whl 16.8 MB Sep 13, 2026	CPython 3.7	abi3	macOS 13.0+ x86-64	Details
pyrudof-0.3.21-cp37-abi3-macosx_13_0_arm64.whl 16.2 MB Sep 13, 2026	CPython 3.7	abi3	macOS 13.0+ ARM64	Details

Total release size: 98.4 MB

Release files / pyrudof-0.3.21-cp37-abi3-win_amd64.whl

Download URL	pyrudof-0.3.21-cp37-abi3-win_amd64.whl
Size	18.4 MB
Tags	CPython 3.7 Windows x86-64 abi3
SHA-256 checksum How to use checksums	`dad94d7677e026a196817edbb41f64caadd036a261d1ce80fe9192f5f55c74a0`
BLAKE2b-256 checksum How to use checksums	`2c90baf5a1c5628b2daa75885cea3293b65edaa1caaddf071c4d452c1a9d521f`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

Release files / pyrudof-0.3.21-cp37-abi3-manylinux_2_34_x86_64.whl

Download URL	pyrudof-0.3.21-cp37-abi3-manylinux_2_34_x86_64.whl
Size	23.7 MB
Tags	CPython 3.7 Linux glibc 2.34+ x86-64 abi3
SHA-256 checksum How to use checksums	`8bf6db4fbbb20eb8434670d6391397613ed5db994f838cb815b5c71e1356de12`
BLAKE2b-256 checksum How to use checksums	`113cc3d8a0986ca7934ae1bf66f52fbd56fa8753d928d55ebf15885801e083fe`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

Release files / pyrudof-0.3.21-cp37-abi3-manylinux_2_34_aarch64.whl

Download URL	pyrudof-0.3.21-cp37-abi3-manylinux_2_34_aarch64.whl
Size	23.4 MB
Tags	CPython 3.7 Linux glibc 2.34+ ARM64 abi3
SHA-256 checksum How to use checksums	`2d93b0caf5ced01f3b845478daffe34862976f95632a333cec76a574b96dee4b`
BLAKE2b-256 checksum How to use checksums	`008f91796f0eb057bcca1a71c5837a216d85a5c27f1cfcd456ad353d72fd027b`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

Release files / pyrudof-0.3.21-cp37-abi3-macosx_13_0_x86_64.whl

Download URL	pyrudof-0.3.21-cp37-abi3-macosx_13_0_x86_64.whl
Size	16.8 MB
Tags	CPython 3.7 abi3 macOS 13.0+ x86-64
SHA-256 checksum How to use checksums	`fa1bee12108e6a907c3436aaaf954985eac3cfe3d08a60afa22593066028c25c`
BLAKE2b-256 checksum How to use checksums	`95de2f2ab05557f24092bf8cf828413d35b024789463779e214aa3733c49bfdb`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

Release files / pyrudof-0.3.21-cp37-abi3-macosx_13_0_arm64.whl

Download URL	pyrudof-0.3.21-cp37-abi3-macosx_13_0_arm64.whl
Size	16.2 MB
Tags	CPython 3.7 abi3 macOS 13.0+ ARM64
SHA-256 checksum How to use checksums	`8809a436aa1f5f5abe4f5727e63a05361742a20ae17571f617679bad9a93e0ec`
BLAKE2b-256 checksum How to use checksums	`ca936e44e001fbafcac9fbbce902c613c921539d7273b6a3269041aedbc601a7`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`