Skip to content

Migrate from v0.8.x to v1.0.0

This guide covers the full jump from v0.8.x to v1.0.0. For incremental steps, see:

  • v0.8.x to v0.9.0 — Python ecosystem API (Ontology, explain(), incremental mutations)
  • v0.9.x to v1.0.0 — HermiT parity gate, stable ontologos-dl, hybrid routing

Summary

Milestone Focus
v0.9.0 Python bindings and in-memory ontology JSON (format_version 3)
v1.0.0 Full OWL 2 DL (ontologos-dl), HermiT conformance harness, stable classify --profile dl

Version bumps

ontologos-core = "1.0.0"
ontologos-facade = "1.0.0"
ontologos-dl = "1.0.0"
# … remaining workspace crates at 1.0.0

Python: pip install ontologos==1.0.0

JSON ontology snapshots

Ontology.to_json() now emits format_version: 3. Readers still accept versions 2 and 3. Re-serialize persisted snapshots after upgrade if you rely on the latest fields.

Breaking changes from v0.8.x

  1. Workspace 1.0.0 — all published crates share the 1.0 semver line.
  2. Profile::Dl — routes through ontologos-dl (datatype + tableau consistency), not ALC-only preview.
  3. Python format_version — round-trip tests expect version 3 on write.

See the linked step guides for API details and the ROADMAP for 1.0 release gate criteria.