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.19
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.19-cp37-abi3-win_amd64.whl | CPython 3.7 | abi3 | Windows x86-64 | Details |
| pyrudof-0.3.19-cp37-abi3-manylinux_2_34_x86_64.whl | CPython 3.7 | abi3 | Linux glibc 2.34+ x86-64 | Details |
| pyrudof-0.3.19-cp37-abi3-manylinux_2_34_aarch64.whl | CPython 3.7 | abi3 | Linux glibc 2.34+ ARM64 | Details |
| pyrudof-0.3.19-cp37-abi3-macosx_13_0_x86_64.whl | CPython 3.7 | abi3 | macOS 13.0+ x86-64 | Details |
| pyrudof-0.3.19-cp37-abi3-macosx_13_0_arm64.whl | CPython 3.7 | abi3 | macOS 13.0+ ARM64 | Details |
Total release size: 98.3 MB
Release files / pyrudof-0.3.19-cp37-abi3-win_amd64.whl
| Download URL | pyrudof-0.3.19-cp37-abi3-win_amd64.whl |
|---|---|
| Size | 18.4 MB |
| Tags | CPython 3.7 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
46f9649094bf47c46c5b72c5ad90036c46db488ebdc2246e8e09721e3d8ea29c
|
|
BLAKE2b-256 checksum How to use checksums |
0f12ff420e5a88a102283c56ca5fdb8a6f9d237d3412998f5f3b2f0229cc0490
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / pyrudof-0.3.19-cp37-abi3-manylinux_2_34_x86_64.whl
| Download URL | pyrudof-0.3.19-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 |
427896f8563d06a2005c122ace92f10d72f2b10966fcad48b6d3865c7fb3de41
|
|
BLAKE2b-256 checksum How to use checksums |
c77d2cce36fe9cb7cb6ebddd77f037c77ceeaca207966185be170151a3af6832
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / pyrudof-0.3.19-cp37-abi3-manylinux_2_34_aarch64.whl
| Download URL | pyrudof-0.3.19-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 |
9125c598888a6eea7cbc99788ed717b06486fbe55273b307da514ea3515ae97f
|
|
BLAKE2b-256 checksum How to use checksums |
317b5f66dacd1df8e3b2d9fa3ab50bf9b8bbed5eb43bf0dca6f0c25c41d6b955
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / pyrudof-0.3.19-cp37-abi3-macosx_13_0_x86_64.whl
| Download URL | pyrudof-0.3.19-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 |
f88f9203d67d8268baf9499a9d2cc9c9b4c230b78fa1968efa51016a08125b10
|
|
BLAKE2b-256 checksum How to use checksums |
23858662739df532cfd00e1866ead44c96a0890d7985cea56fd10a075a9b4b0b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / pyrudof-0.3.19-cp37-abi3-macosx_13_0_arm64.whl
| Download URL | pyrudof-0.3.19-cp37-abi3-macosx_13_0_arm64.whl |
|---|---|
| Size | 16.1 MB |
| Tags | CPython 3.7 abi3 macOS 13.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
4011f79cf3c86ff2e1570eafc86e3c6f0f8b45f27d667cd71f921155ae7fab2f
|
|
BLAKE2b-256 checksum How to use checksums |
b10318e74ed48f2dcd503fca91e21e9de18b623d7a863512a221f225b9583207
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
