chore(python): Migrate to ABI3

Signed-off-by: Dmitry Dygalo <dmitry@dygalo.dev>

Author: Stranger6667

.github/workflows/ci.yml

@@ -62,7 +62,7 @@ jobs:
           cache-all-crates: "true"
           key: ${{ matrix.os }}
 
-      - run: cargo test --no-fail-fast --all-features
+      - run: cargo test --no-fail-fast --all-features --workspace --exclude jsonschema-py
 
   test-wasm:
     strategy:
@@ -173,7 +173,7 @@ jobs:
         uses: taiki-e/install-action@cargo-llvm-cov
 
       - name: Run tests
-        run: cargo llvm-cov --no-report --all-features
+        run: cargo llvm-cov --no-report --all-features --workspace --exclude jsonschema-py
 
       - name: Generate coverage reports
         run: cargo llvm-cov report --lcov --output-path lcov.info
@@ -224,7 +224,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-22.04, macos-15, windows-2022]
-        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12', '3.13', '3.14']
+        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
 
     name: Test Python ${{ matrix.python-version }} on ${{ matrix.os }}
     runs-on: ${{ matrix.os }}

.github/workflows/python-release-verify.yml

@@ -0,0 +1,54 @@
+name: Python Release Verify
+
+on:
+  pull_request:
+  push:
+    branches:
+      - master
+
+defaults:
+  run:
+    shell: bash
+
+env:
+  PACKAGE_NAME: jsonschema_rs
+  PYTHON_VERSION: "3.10"
+
+jobs:
+  wheel-smoke-test:
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - uses: Swatinem/rust-cache@v2
+
+      - name: Install maturin
+        run: uv pip install --system --python ${{ env.PYTHON_VERSION }} maturin
+
+      - name: Build wheel
+        run: |
+          maturin build --release -m crates/jsonschema-py/Cargo.toml --out dist --interpreter $PYTHON_VERSION
+
+      - name: Install built wheel
+        run: |
+          uv pip install --system --python ${{ env.PYTHON_VERSION }} dist/${PACKAGE_NAME}-*.whl --force-reinstall
+
+      - name: Test wheel with basic validation
+        run: |
+          python${{ env.PYTHON_VERSION }} -c "
+          import jsonschema_rs
+
+          schema = {'type': 'object', 'properties': {'name': {'type': 'string'}}}
+
+          assert jsonschema_rs.is_valid(schema, {'name': 'test'}), 'Valid instance failed'
+          assert not jsonschema_rs.is_valid(schema, {'name': 123}), 'Invalid instance passed'
+
+          print('Basic validation tests passed!')
+          "

.github/workflows/python-release.yml

@@ -16,6 +16,7 @@ concurrency:
 
 env:
   PACKAGE_NAME: jsonschema_rs
+  PYTHON_ABI_VERSION: "3.10"
 
 jobs:
   sdist:
@@ -27,7 +28,7 @@ jobs:
 
       - uses: Swatinem/rust-cache@v2
 
-      - uses: hynek/setup-cached-uv@v2
+      - uses: astral-sh/setup-uv@v7
 
       - run: uv python install "3.12"
 
@@ -50,104 +51,100 @@ jobs:
 
   macos-x86_64:
     runs-on: macos-13
-    strategy:
-      matrix:
-        python-version: [ '3.8', '3.9', '3.10', '3.11', '3.12', '3.13', '3.14' ]
     steps:
       - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
       - uses: actions/setup-python@v6
         with:
-          python-version: ${{ matrix.python-version }}
+          python-version: ${{ env.PYTHON_ABI_VERSION }}
           architecture: x64
       - uses: dtolnay/rust-toolchain@stable
       - name: Build wheels - x86_64
         uses: messense/maturin-action@v1
         with:
           target: x86_64
-          args: --release -m crates/jsonschema-py/Cargo.toml --out dist --interpreter ${{ matrix.python-version }}
+          args: --release -m crates/jsonschema-py/Cargo.toml --out dist --interpreter ${{ env.PYTHON_ABI_VERSION }}
       - name: Install built wheel - x86_64
         run: |
-          pip install dist/${{ env.PACKAGE_NAME }}-*.whl --force-reinstall
+          uv pip install --python ${{ env.PYTHON_ABI_VERSION }} dist/${{ env.PACKAGE_NAME }}-*.whl --force-reinstall
       - name: Upload wheels
         uses: actions/upload-artifact@v5
         with:
-          name: wheel-macos-x86_64-py${{ matrix.python-version }}
+          name: wheel-macos-x86_64
           path: dist
 
   macos-universal:
     runs-on: macos-13
-    strategy:
-      matrix:
-        python-version: [ '3.8', '3.9', '3.10', '3.11', '3.12', '3.13', '3.14' ]
     steps:
       - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
       - uses: actions/setup-python@v6
         with:
-          python-version: ${{ matrix.python-version }}
+          python-version: ${{ env.PYTHON_ABI_VERSION }}
           architecture: x64
       - uses: dtolnay/rust-toolchain@stable
       - name: Build wheels - universal2
         uses: messense/maturin-action@v1
         with:
-          args: --release -m crates/jsonschema-py/Cargo.toml --target universal2-apple-darwin --out dist --interpreter ${{ matrix.python-version }}
+          args: --release -m crates/jsonschema-py/Cargo.toml --target universal2-apple-darwin --out dist --interpreter ${{ env.PYTHON_ABI_VERSION }}
       - name: Install built wheel - universal2
         run: |
-          pip install dist/${{ env.PACKAGE_NAME }}-*universal2.whl --force-reinstall
+          uv pip install --python ${{ env.PYTHON_ABI_VERSION }} dist/${{ env.PACKAGE_NAME }}-*universal2.whl --force-reinstall
       - name: Upload wheels
         uses: actions/upload-artifact@v5
         with:
-          name: wheel-macos-universal-py${{ matrix.python-version }}
+          name: wheel-macos-universal
           path: dist
 
   windows:
     runs-on: windows-2022
     strategy:
       matrix:
-        python-version: [ '3.8', '3.9', '3.10', '3.11', '3.12', '3.13', '3.14' ]
         target: [ x64, x86 ]
     steps:
       - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
       - uses: actions/setup-python@v6
         with:
-          python-version: ${{ matrix.python-version }}
+          python-version: ${{ env.PYTHON_ABI_VERSION }}
           architecture: ${{ matrix.target }}
       - uses: dtolnay/rust-toolchain@stable
       - name: Build wheels
         uses: messense/maturin-action@v1
         with:
           target: ${{ matrix.target }}
-          args: --release -m crates/jsonschema-py/Cargo.toml --out dist --interpreter ${{ matrix.python-version }}
+          args: --release -m crates/jsonschema-py/Cargo.toml --out dist --interpreter ${{ env.PYTHON_ABI_VERSION }}
       - name: Install built wheel
         shell: bash
         run: |
-          python -m pip install dist/${{ env.PACKAGE_NAME }}-*.whl --force-reinstall
+          uv pip install --python ${{ env.PYTHON_ABI_VERSION }} dist/${{ env.PACKAGE_NAME }}-*.whl --force-reinstall
       - name: Upload wheels
         uses: actions/upload-artifact@v5
         with:
-          name: wheel-windows-${{ matrix.target }}-py${{ matrix.python-version }}
+          name: wheel-windows-${{ matrix.target }}
           path: dist
 
   linux:
     runs-on: ubuntu-22.04
     strategy:
       matrix:
-        python-version: [ '3.8', '3.9', '3.10', '3.11', '3.12', '3.13', '3.14' ]
         target: [ x86_64, i686, aarch64 ]
     steps:
       - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
       - uses: actions/setup-python@v6
         with:
-          python-version: ${{ matrix.python-version }}
+          python-version: ${{ env.PYTHON_ABI_VERSION }}
       - name: Build wheels
         uses: messense/maturin-action@v1
         with:
           target: ${{ matrix.target }}
           manylinux: auto
-          args: --release -m crates/jsonschema-py/Cargo.toml --out dist --interpreter ${{ matrix.python-version }}
+          args: --release -m crates/jsonschema-py/Cargo.toml --out dist --interpreter ${{ env.PYTHON_ABI_VERSION }}
       - name: Install built wheel on native architecture
         if: matrix.target == 'x86_64'
         run: |
-          pip install dist/${{ env.PACKAGE_NAME }}-*.whl --force-reinstall
+          uv pip install --python ${{ env.PYTHON_ABI_VERSION }} dist/${{ env.PACKAGE_NAME }}-*.whl --force-reinstall
       - uses: uraimo/run-on-arch-action@v3
         if: matrix.target == 'aarch64'
         name: Install built wheel on ARM architecture
@@ -161,15 +158,15 @@ jobs:
             apt-get install -y --no-install-recommends software-properties-common gpg gpg-agent curl
             add-apt-repository ppa:deadsnakes/ppa
             apt-get update
-            apt-get install -y python${{ matrix.python-version }}-dev python${{ matrix.python-version }}-venv
+            apt-get install -y python${{ env.PYTHON_ABI_VERSION }}-dev python${{ env.PYTHON_ABI_VERSION }}-venv
           run: |
-            python${{ matrix.python-version }} -m venv venv
+            python${{ env.PYTHON_ABI_VERSION }} -m venv venv
             venv/bin/pip install -U pip wheel
             venv/bin/pip install ${{ env.PACKAGE_NAME }} --no-index --find-links dist/ --force-reinstall
       - name: Upload wheels
         uses: actions/upload-artifact@v5
         with:
-          name: wheel-linux-${{ matrix.target }}-py${{ matrix.python-version }}
+          name: wheel-linux-${{ matrix.target }}
           path: dist
 
   release:

crates/jsonschema-py/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## [Unreleased]
 
+### Changed
+
+- Migrated to abi3 so a single wheel per platform works on all supported 3.10+ interpreters.
+
+### Removed
+
+- Support for Python 3.8 & 3.9.
+
 ## [0.34.0] - 2025-11-14
 
 ### Added

crates/jsonschema-py/Cargo.toml

@@ -17,7 +17,7 @@ crate-type = ["cdylib"]
 
 [dependencies]
 jsonschema = { path = "../jsonschema/" }
-pyo3 = { version = "0.27", features = ["extension-module"] }
+pyo3 = { version = "0.27", features = ["extension-module", "abi3-py310"] }
 pyo3-built = "0.6"
 pythonize = "0.27"
 serde.workspace = true

crates/jsonschema-py/pyproject.toml

@@ -22,8 +22,6 @@ classifiers = [
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.8",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -33,7 +31,7 @@ classifiers = [
     "Programming Language :: Rust",
     "Topic :: File Formats :: JSON :: JSON Schema",
 ]
-requires-python = ">=3.8"
+requires-python = ">=3.10"
 
 [project.optional-dependencies]
 tests = [
@@ -61,7 +59,7 @@ include = [{ path = "rust-toolchain.toml", format = ["sdist", "wheel"] }]
 
 [tool.ruff]
 line-length = 120
-target-version = "py38"
+target-version = "py310"
 
 [tool.ruff.lint]
 select = [

crates/jsonschema-py/python/jsonschema_rs/__init__.py

@@ -1 +1,98 @@
-from .jsonschema_rs import *  # noqa: F403
+from typing import Any
+
+from .jsonschema_rs import (
+    Draft4,
+    Draft4Validator,
+    Draft6,
+    Draft6Validator,
+    Draft7,
+    Draft7Validator,
+    Draft201909,
+    Draft201909Validator,
+    Draft202012,
+    Draft202012Validator,
+    FancyRegexOptions,
+    RegexOptions,
+    Registry,
+    ValidationErrorKind,
+    is_valid,
+    iter_errors,
+    meta,
+    validate,
+    validator_for,
+)
+
+
+class ValidationError(ValueError):
+    """An instance is invalid under a provided schema."""
+
+    message: str
+    verbose_message: str
+    schema_path: list[str | int]
+    instance_path: list[str | int]
+    kind: ValidationErrorKind
+    instance: Any
+
+    def __init__(
+        self,
+        message: str,
+        verbose_message: str,
+        schema_path: list[str | int],
+        instance_path: list[str | int],
+        kind: ValidationErrorKind,
+        instance: Any,
+    ) -> None:
+        super().__init__(verbose_message)
+        self.message = message
+        self.verbose_message = verbose_message
+        self.schema_path = schema_path
+        self.instance_path = instance_path
+        self.kind = kind
+        self.instance = instance
+
+    def __str__(self) -> str:
+        return self.verbose_message
+
+    def __repr__(self) -> str:
+        return f"<ValidationError: '{self.message}'>"
+
+
+class ReferencingError(Exception):
+    """Errors that can occur during reference resolution and resource handling."""
+
+    message: str
+
+    def __init__(self, message: str) -> None:
+        super().__init__(message)
+        self.message = message
+
+    def __str__(self) -> str:
+        return self.message
+
+    def __repr__(self) -> str:
+        return f"<ReferencingError: '{self.message}'>"
+
+
+__all__ = [
+    "ReferencingError",
+    "ValidationError",
+    "ValidationErrorKind",
+    "is_valid",
+    "validate",
+    "iter_errors",
+    "validator_for",
+    "Draft4",
+    "Draft6",
+    "Draft7",
+    "Draft201909",
+    "Draft202012",
+    "Draft4Validator",
+    "Draft6Validator",
+    "Draft7Validator",
+    "Draft201909Validator",
+    "Draft202012Validator",
+    "Registry",
+    "FancyRegexOptions",
+    "RegexOptions",
+    "meta",
+]