rustdl

Sound, performant OWL 2 DL (SROIQ) reasoner in Rust, with Python bindings. No JVM, no subprocess — native classification via PyO3.

rustdl beats HermiT on every measured ORE workload and wins outright against Konclude on Horn-fragment ontologies. See the project README for the full benchmark table.

Install

pip install rustdl

Wheels are published for CPython 3.10+ on Linux (x86_64, aarch64), macOS (Apple Silicon), and Windows (AMD64). Other platforms build from the sdist (needs a Rust toolchain).

Quick start

Prefer a guided walkthrough? See Debugging an ontology with rustdl — an end-to-end QA tutorial (classify → debug() → justify/repair → fix → read inferred facts).

import rustdl

# A small OWL 2 DL ontology ships inside the wheel (gzip-compressed) — no
# download needed. `examples.pizza()` returns its file path (decompressed
# into a per-user cache dir on first use); `examples.PIZZA_NS` is its
# namespace, so class IRIs are PIZZA_NS + local name (e.g. + "Pizza").
from rustdl.examples import pizza, PIZZA_NS, SULO_NS

# Classify. Format is auto-detected from the extension:
# .ofn (OWL Functional), .owx (OWL/XML), .rdf / .owl (RDF/XML), .omn (Manchester).
result = rustdl.classify(pizza())

print(f"{len(result.classes)} classes, {len(result.unsatisfiable)} unsatisfiable, "
      f"complete={result.complete}")
# -> 88 classes, 0 unsatisfiable, complete=True

# Query the computed hierarchy
print(result.is_subclass(PIZZA_NS + "BoxedPizza", PIZZA_NS + "Pizza"))
# -> True
print(len(result.subclasses_of(PIZZA_NS + "FoodMaterial")))
# -> 25

# The pizza ontology is aligned to the SULO upper ontology, so reasoning
# spans both — e.g. a pizza-making timestamp is inferred to be a SULO StartTime:
print(result.is_subclass(PIZZA_NS + "BakingStartTime", SULO_NS + "StartTime"))
# -> True

# Other hierarchy queries (all take full class IRIs):
result.superclasses_of(PIZZA_NS + "Cheese")        # -> list[str]
result.equivalent_classes(PIZZA_NS + "Pizza")      # -> list[str]
result.direct_subsumers(PIZZA_NS + "BoxedPizza")   # -> list[str] (Hasse-direct parents)

Bundled examples

Three real ontologies ship inside the wheel, gzip-compressed (~200 KB total). They classify with no network access — each examples.X() decompresses its ontology into a per-user cache dir ($XDG_CACHE_HOME/rustdl/examples or ~/.cache/rustdl/examples) on first use, then reuses it. Each examples.X_NS is the namespace, so a class IRI is the namespace plus the local name.

helper	ontology	classes	notes
`pizza()` / `PIZZA_NS`	ontostart pizza	88	SULO-aligned pizza-making ontology; classifies instantly + complete
`sulo()` / `SULO_NS`	SULO (Simple Upper-Level Ontology)	17	tiny; classifies in milliseconds
`sio()` / `SIO_NS`	SIO (Semanticscience Integrated Ontology)	~1600	realistic larger workload; takes tens of seconds. Class IRIs are numeric codes, e.g. `SIO_NS + "SIO_000006"` ("process")

import rustdl
from rustdl import examples

r = rustdl.classify(examples.sulo())
print(r.is_subclass(examples.SULO_NS + "StartTime", examples.SULO_NS + "Object"))
# -> True

API

Classification

result = rustdl.classify(path, *, per_pair_timeout_ms=1000, saturation_only=False)
result = rustdl.classify_bytes(data, format="ofn", *, per_pair_timeout_ms=1000, saturation_only=False)

per_pair_timeout_ms — bound each subsumption test (default 1000; 0 = unbounded). A pair that exceeds the budget is recorded as "not subsumed": sound (never a false subsumption) but the result may be incomplete. When that happens, an IncompleteClassificationWarning is emitted and result.complete is False. Pass 0 for the complete, unbounded classification. The default bounds pathological SROIQ inputs so classification can't hang silently. Conversely, on nominal-heavy ontologies (e.g. the W3C wine ontology) the engines never terminate on the hard pairs and only burn the full budget, so a low value like per_pair_timeout_ms=25 is much faster with no completeness loss (wine: 7.5× faster, identical hierarchy, MISSED=0 vs HermiT).
saturation_only — skip the tableau entirely; EL-closure-only under-approximation. Dramatically faster on mostly-EL ontologies, and always complete (no tableau ⇒ no timeout).

classify / classify_bytes return a Classification:

member	type	meaning
`.classes`	`list[str]`	all declared class IRIs
`.unsatisfiable`	`list[str]`	classes proved `⊑ ⊥`
`.inconsistent`	`bool`	whole ontology unsatisfiable
`.complete`	`bool`	`False` if any pair hit the timeout (result may miss edges)
`.timed_out_pairs`	`int`	how many pairs hit the timeout
`.is_subclass(sub, sup)`	`bool`	is `sub ⊑ sup` entailed?
`.subclasses_of(cls)`	`list[str]`	every `D` with `D ⊑ cls`
`.superclasses_of(cls)`	`list[str]`	every `D` with `cls ⊑ D`
`.equivalent_classes(cls)`	`list[str]`	classes equivalent to `cls`
`.direct_subsumers(cls)`	`list[str]`	Hasse-direct parents of `cls`

One-shot queries

Each parses the file, answers one question, and returns:

rustdl.is_consistent(path)                        # -> bool
rustdl.is_class_satisfiable(path, class_iri)      # -> bool
rustdl.is_subclass_of(path, sub_iri, sup_iri)     # -> bool
rustdl.is_instance_of(path, class_iri, indiv_iri) # -> bool
rustdl.instances_of(path, class_iri)              # -> list[str]
rustdl.realize(path)                              # -> dict[str, list[str]]

realize returns each individual IRI mapped to its most-specific entailed class IRIs.

For repeated queries over the same ontology, prefer classify(path) once and query the returned Classification — each top-level function re-parses.

Inference materialization

rustdl.materialize_inferred_subclass_axioms(path)   # -> list[tuple[str, str]]
rustdl.materialize_inferred_class_assertions(path)  # -> list[tuple[str, str]]

materialize_inferred_subclass_axioms yields (sub, sup) pairs for every entailed subsumption (excluding reflexive, owl:Thing/owl:Nothing, and unsatisfiable classes). materialize_inferred_class_assertions yields (class, individual) pairs. Useful for writing an inferred ontology back to disk.

Errors

rustdl.RustdlError            # base — catches everything from the library
rustdl.ParseError             # the OWL file couldn't be parsed
rustdl.UnsupportedAxiomError  # HasKey, role chains > length 2, etc.
rustdl.UnknownClassError      # an IRI argument isn't a declared class

try:
    result = rustdl.classify("ontology.ofn")
except rustdl.ParseError as e:
    print(f"bad input: {e}")
except rustdl.RustdlError as e:
    print(f"reasoning failed: {e}")

Soundness & coverage

rustdl is sound: every reported subsumption is a genuine entailment (FP=0 against Konclude on the validation corpus). Completeness is partial — the default classifier is empirically near-complete across the measured corpus but not provably complete on all of SROIQ. saturation_only and per_pair_timeout_ms are sound-but-incomplete by construction.

Data-property and datatype axioms outside the recognized preprocessing patterns are silently dropped (a sound under-approximation). HasKey and role chains longer than length 2 raise UnsupportedAxiomError. SWRL rules are skipped.

See the project documentation for the full coverage matrix, soundness contract, and architecture notes.

License

Apache-2.0 OR MIT.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rustdl-0.4.0.tar.gz (1.2 MB view details)

Uploaded Jul 24, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

rustdl-0.4.0-cp310-abi3-win_amd64.whl (2.6 MB view details)

Uploaded Jul 24, 2026 CPython 3.10+Windows x86-64

rustdl-0.4.0-cp310-abi3-musllinux_1_2_x86_64.whl (2.5 MB view details)

Uploaded Jul 24, 2026 CPython 3.10+musllinux: musl 1.2+ x86-64

rustdl-0.4.0-cp310-abi3-musllinux_1_2_aarch64.whl (2.3 MB view details)

Uploaded Jul 24, 2026 CPython 3.10+musllinux: musl 1.2+ ARM64

rustdl-0.4.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.4 MB view details)

Uploaded Jul 24, 2026 CPython 3.10+manylinux: glibc 2.17+ x86-64

rustdl-0.4.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.2 MB view details)

Uploaded Jul 24, 2026 CPython 3.10+manylinux: glibc 2.17+ ARM64

rustdl-0.4.0-cp310-abi3-macosx_11_0_arm64.whl (2.2 MB view details)

Uploaded Jul 24, 2026 CPython 3.10+macOS 11.0+ ARM64

File details

Details for the file rustdl-0.4.0.tar.gz.

File metadata

Download URL: rustdl-0.4.0.tar.gz
Upload date: Jul 24, 2026
Size: 1.2 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for rustdl-0.4.0.tar.gz
Algorithm	Hash digest
SHA256	`8bdb7f638346d7fb72c23be9ff2b9fae6aa5b467defc8f9cee2974b803d0744d`
MD5	`60e48e2fb0766f54619236a13600bb58`
BLAKE2b-256	`2913b67b0d1e75d88eed87e938ac24a7b9344ebb0f07dcc71d5422939c780e09`

See more details on using hashes here.

Provenance

The following attestation bundles were made for rustdl-0.4.0.tar.gz:

Publisher: release-python.yml on MaastrichtU-IDS/rustdl

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: rustdl-0.4.0.tar.gz
- Subject digest: 8bdb7f638346d7fb72c23be9ff2b9fae6aa5b467defc8f9cee2974b803d0744d
- Sigstore transparency entry: 2234839602
- Sigstore integration time: Jul 24, 2026
Source repository:
- Permalink: MaastrichtU-IDS/rustdl@b5f3e14e74e24b4104af795135dcd6392fbf9028
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/MaastrichtU-IDS
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-python.yml@b5f3e14e74e24b4104af795135dcd6392fbf9028
- Trigger Event: push

File details

Details for the file rustdl-0.4.0-cp310-abi3-win_amd64.whl.

File metadata

Download URL: rustdl-0.4.0-cp310-abi3-win_amd64.whl
Upload date: Jul 24, 2026
Size: 2.6 MB
Tags: CPython 3.10+, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for rustdl-0.4.0-cp310-abi3-win_amd64.whl
Algorithm	Hash digest
SHA256	`ed34b008979f39c367e4f42879715f43c6b13ad11b5c735617718d310493c6d0`
MD5	`03bda686983052ae3a02b00fdfae7269`
BLAKE2b-256	`1aab6fcc9b10571b1c6e663f47ea6c8953231844b1f9a08179a6a7c9cee741e6`

See more details on using hashes here.

Provenance

The following attestation bundles were made for rustdl-0.4.0-cp310-abi3-win_amd64.whl:

Publisher: release-python.yml on MaastrichtU-IDS/rustdl

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: rustdl-0.4.0-cp310-abi3-win_amd64.whl
- Subject digest: ed34b008979f39c367e4f42879715f43c6b13ad11b5c735617718d310493c6d0
- Sigstore transparency entry: 2234841580
- Sigstore integration time: Jul 24, 2026
Source repository:
- Permalink: MaastrichtU-IDS/rustdl@b5f3e14e74e24b4104af795135dcd6392fbf9028
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/MaastrichtU-IDS
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-python.yml@b5f3e14e74e24b4104af795135dcd6392fbf9028
- Trigger Event: push

File details

Details for the file rustdl-0.4.0-cp310-abi3-musllinux_1_2_x86_64.whl.

File metadata

Download URL: rustdl-0.4.0-cp310-abi3-musllinux_1_2_x86_64.whl
Upload date: Jul 24, 2026
Size: 2.5 MB
Tags: CPython 3.10+, musllinux: musl 1.2+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for rustdl-0.4.0-cp310-abi3-musllinux_1_2_x86_64.whl
Algorithm	Hash digest
SHA256	`56d58d209a6d768f5fc9e85313e4ae9c846cd57d486e7430ec92895b4e2f467d`
MD5	`491895aa438da7a1fa1732bb28b3c21d`
BLAKE2b-256	`990434a78ed8845868b6431648078e6a1f71a08e33fbb8de9edddd7af276d77c`

See more details on using hashes here.

Provenance

The following attestation bundles were made for rustdl-0.4.0-cp310-abi3-musllinux_1_2_x86_64.whl:

Publisher: release-python.yml on MaastrichtU-IDS/rustdl

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: rustdl-0.4.0-cp310-abi3-musllinux_1_2_x86_64.whl
- Subject digest: 56d58d209a6d768f5fc9e85313e4ae9c846cd57d486e7430ec92895b4e2f467d
- Sigstore transparency entry: 2234840538
- Sigstore integration time: Jul 24, 2026
Source repository:
- Permalink: MaastrichtU-IDS/rustdl@b5f3e14e74e24b4104af795135dcd6392fbf9028
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/MaastrichtU-IDS
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-python.yml@b5f3e14e74e24b4104af795135dcd6392fbf9028
- Trigger Event: push

File details

Details for the file rustdl-0.4.0-cp310-abi3-musllinux_1_2_aarch64.whl.

File metadata

Download URL: rustdl-0.4.0-cp310-abi3-musllinux_1_2_aarch64.whl
Upload date: Jul 24, 2026
Size: 2.3 MB
Tags: CPython 3.10+, musllinux: musl 1.2+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for rustdl-0.4.0-cp310-abi3-musllinux_1_2_aarch64.whl
Algorithm	Hash digest
SHA256	`2cd1a8a9c5287e164a18d212489ab365310410b5cb653e9e241c835304d7d6b7`
MD5	`2c4362372b88d8cb8721f81ba45d1bad`
BLAKE2b-256	`c4d26a5b7b0f14a9b31934c52ebd145301a81181ab35dc41001ad4abcf26b606`

See more details on using hashes here.

Provenance

The following attestation bundles were made for rustdl-0.4.0-cp310-abi3-musllinux_1_2_aarch64.whl:

Publisher: release-python.yml on MaastrichtU-IDS/rustdl

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: rustdl-0.4.0-cp310-abi3-musllinux_1_2_aarch64.whl
- Subject digest: 2cd1a8a9c5287e164a18d212489ab365310410b5cb653e9e241c835304d7d6b7
- Sigstore transparency entry: 2234840898
- Sigstore integration time: Jul 24, 2026
Source repository:
- Permalink: MaastrichtU-IDS/rustdl@b5f3e14e74e24b4104af795135dcd6392fbf9028
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/MaastrichtU-IDS
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-python.yml@b5f3e14e74e24b4104af795135dcd6392fbf9028
- Trigger Event: push

File details

Details for the file rustdl-0.4.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

Download URL: rustdl-0.4.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Upload date: Jul 24, 2026
Size: 2.4 MB
Tags: CPython 3.10+, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for rustdl-0.4.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`f681eda262684d6dfb0175c2f42bb71ea96bf2eb955f32d9a33761e2b05cd8e0`
MD5	`6863a786d917d78dc29e16288433a77d`
BLAKE2b-256	`f58be6af0731d5d86f34b7d6385dc3b34a6055afaedad9667b6d97d84de2c0f0`

See more details on using hashes here.

Provenance

The following attestation bundles were made for rustdl-0.4.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release-python.yml on MaastrichtU-IDS/rustdl

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: rustdl-0.4.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Subject digest: f681eda262684d6dfb0175c2f42bb71ea96bf2eb955f32d9a33761e2b05cd8e0
- Sigstore transparency entry: 2234842544
- Sigstore integration time: Jul 24, 2026
Source repository:
- Permalink: MaastrichtU-IDS/rustdl@b5f3e14e74e24b4104af795135dcd6392fbf9028
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/MaastrichtU-IDS
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-python.yml@b5f3e14e74e24b4104af795135dcd6392fbf9028
- Trigger Event: push

File details

Details for the file rustdl-0.4.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

Download URL: rustdl-0.4.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Upload date: Jul 24, 2026
Size: 2.2 MB
Tags: CPython 3.10+, manylinux: glibc 2.17+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for rustdl-0.4.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm	Hash digest
SHA256	`df3c7178d7501c543d697c8f8faa7d44859366d1c369d0d5229bcf8d3a5e88a7`
MD5	`189f8113f71228da7a9429fe8fbd87f1`
BLAKE2b-256	`7a864caa91a543312fd3ef2a5a4f9681152d1e3ce54cc8fce43f966b8db47776`

See more details on using hashes here.

Provenance

The following attestation bundles were made for rustdl-0.4.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: release-python.yml on MaastrichtU-IDS/rustdl

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: rustdl-0.4.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Subject digest: df3c7178d7501c543d697c8f8faa7d44859366d1c369d0d5229bcf8d3a5e88a7
- Sigstore transparency entry: 2234840005
- Sigstore integration time: Jul 24, 2026
Source repository:
- Permalink: MaastrichtU-IDS/rustdl@b5f3e14e74e24b4104af795135dcd6392fbf9028
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/MaastrichtU-IDS
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-python.yml@b5f3e14e74e24b4104af795135dcd6392fbf9028
- Trigger Event: push

File details

Details for the file rustdl-0.4.0-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

Download URL: rustdl-0.4.0-cp310-abi3-macosx_11_0_arm64.whl
Upload date: Jul 24, 2026
Size: 2.2 MB
Tags: CPython 3.10+, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for rustdl-0.4.0-cp310-abi3-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`ebd549b19fddc7d78b9dde067ab03a2c6b8ef004354dfc76691b1e391318ce1f`
MD5	`73de95d0b7ecd35d78cee86979b9a57d`
BLAKE2b-256	`37f254e8abf87163b6f5b6a55979d7727034fbdc9bd9de476cec11dfd7b0d146`

See more details on using hashes here.

Provenance

The following attestation bundles were made for rustdl-0.4.0-cp310-abi3-macosx_11_0_arm64.whl:

Publisher: release-python.yml on MaastrichtU-IDS/rustdl

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: rustdl-0.4.0-cp310-abi3-macosx_11_0_arm64.whl
- Subject digest: ebd549b19fddc7d78b9dde067ab03a2c6b8ef004354dfc76691b1e391318ce1f
- Sigstore transparency entry: 2234840102
- Sigstore integration time: Jul 24, 2026
Source repository:
- Permalink: MaastrichtU-IDS/rustdl@b5f3e14e74e24b4104af795135dcd6392fbf9028
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/MaastrichtU-IDS
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-python.yml@b5f3e14e74e24b4104af795135dcd6392fbf9028
- Trigger Event: push