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.16
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.16-cp37-abi3-win_amd64.whl | CPython 3.7 | abi3 | Windows x86-64 | Details |
| pyrudof-0.3.16-cp37-abi3-manylinux_2_34_x86_64.whl | CPython 3.7 | abi3 | Linux glibc 2.34+ x86-64 | Details |
| pyrudof-0.3.16-cp37-abi3-manylinux_2_34_aarch64.whl | CPython 3.7 | abi3 | Linux glibc 2.34+ ARM64 | Details |
| pyrudof-0.3.16-cp37-abi3-macosx_13_0_x86_64.whl | CPython 3.7 | abi3 | macOS 13.0+ x86-64 | Details |
| pyrudof-0.3.16-cp37-abi3-macosx_13_0_arm64.whl | CPython 3.7 | abi3 | macOS 13.0+ ARM64 | Details |
Total release size: 97.6 MB
Release files / pyrudof-0.3.16-cp37-abi3-win_amd64.whl
| Download URL | pyrudof-0.3.16-cp37-abi3-win_amd64.whl |
|---|---|
| Size | 18.2 MB |
| Tags | CPython 3.7 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
21b94cafa3ea52a8dbaa0766805f47f1d503f392a5c96c1c31c8fa1d7f96492c
|
|
BLAKE2b-256 checksum How to use checksums |
9b149f13e04b89711de8954471296917fdabdf3f763d4f8cc6f0593a04acc9d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / pyrudof-0.3.16-cp37-abi3-manylinux_2_34_x86_64.whl
| Download URL | pyrudof-0.3.16-cp37-abi3-manylinux_2_34_x86_64.whl |
|---|---|
| Size | 23.5 MB |
| Tags | CPython 3.7 Linux glibc 2.34+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
c3be4841353d1adb51635df05a811b3f27232e4a7adddfbc2c88a6444f24ac88
|
|
BLAKE2b-256 checksum How to use checksums |
2e7d73c71ea3b726bdedce1072586d54c7db6c514b6ecf530763f918e5e5aa3c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / pyrudof-0.3.16-cp37-abi3-manylinux_2_34_aarch64.whl
| Download URL | pyrudof-0.3.16-cp37-abi3-manylinux_2_34_aarch64.whl |
|---|---|
| Size | 23.2 MB |
| Tags | CPython 3.7 Linux glibc 2.34+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
f56d21edab5b9f491f1ff29afcb0bfe29f4540747a30d835ca5feda7259a0569
|
|
BLAKE2b-256 checksum How to use checksums |
0869dfb40e374cd19b33313d8c056d1cd17a0ddfd7bae4d8348702c9fd10ea1b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / pyrudof-0.3.16-cp37-abi3-macosx_13_0_x86_64.whl
| Download URL | pyrudof-0.3.16-cp37-abi3-macosx_13_0_x86_64.whl |
|---|---|
| Size | 16.6 MB |
| Tags | CPython 3.7 abi3 macOS 13.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
a684eb224ace0a88a50e9c5e9d3bc3d28fac6adb4c9e824a015517c5a3edf70e
|
|
BLAKE2b-256 checksum How to use checksums |
3865724794686543fea9dace26a486d9a1a3b9cdc2fafa0fe43c9de6e0dd919a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / pyrudof-0.3.16-cp37-abi3-macosx_13_0_arm64.whl
| Download URL | pyrudof-0.3.16-cp37-abi3-macosx_13_0_arm64.whl |
|---|---|
| Size | 16.0 MB |
| Tags | CPython 3.7 abi3 macOS 13.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
59cf2f998503088d160619f5da6a9574e11fcdd7227493601592699aa9fe04f0
|
|
BLAKE2b-256 checksum How to use checksums |
ad2067e376b242820ba3940ec272fa7ecadaa87843180db14af947cd1944f4f1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
