Rust backend

Author: p1c2u

.github/workflows/python-tests.yml

@@ -10,12 +10,20 @@ on:
 
 jobs:
   tests:
-    name: "py${{ matrix.python-version }}-${{ matrix.os }}"
+    name: "py${{ matrix.python-version }}-${{ matrix.os }}-${{ matrix.backend }}"
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
         python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
         os: [windows-latest, ubuntu-latest]
+        backend: ['jsonschema']
+        include:
+          - python-version: '3.12'
+            os: ubuntu-latest
+            backend: 'jsonschema-rs'
+          - python-version: '3.13'
+            os: windows-latest
+            backend: 'jsonschema-rs'
       fail-fast: false
     steps:
       - uses: actions/checkout@v4
@@ -49,9 +57,14 @@ jobs:
       - name: Install dependencies
         run: poetry install --all-extras
 
+      - name: Install jsonschema-rs
+        if: matrix.backend != 'jsonschema'
+        run: poetry run pip install ${{ matrix.backend }}
+
       - name: Test
         env:
           PYTEST_ADDOPTS: "--color=yes"
+          OPENAPI_SPEC_VALIDATOR_SCHEMA_VALIDATOR_BACKEND: ${{ matrix.backend }}
         run: poetry run pytest
 
       - name: Static type check

README.rst

@@ -131,6 +131,16 @@ Rules:
 * Set ``0`` to disable the resolved cache.
 * Invalid values (non-integer or negative) fall back to ``128``.
 
+You can also choose schema validator backend:
+
+.. code-block:: bash
+
+    OPENAPI_SPEC_VALIDATOR_SCHEMA_VALIDATOR_BACKEND=jsonschema-rs
+
+Allowed values are ``auto`` (default), ``jsonschema``, and
+``jsonschema-rs``.
+Invalid values raise a warning and fall back to ``auto``.
+
 Related projects
 ################
 

docs/cli.rst

@@ -73,3 +73,7 @@ Performance note:
    You can tune resolved-path caching with
    ``OPENAPI_SPEC_VALIDATOR_RESOLVED_CACHE_MAXSIZE``.
    Default is ``128``; set ``0`` to disable.
+   
+   You can also select schema validator backend with
+   ``OPENAPI_SPEC_VALIDATOR_SCHEMA_VALIDATOR_BACKEND``
+   (``auto``/``jsonschema``/``jsonschema-rs``).

docs/python.rst

@@ -75,3 +75,13 @@ Rules:
 * Default is ``128``.
 * Set ``0`` to disable the resolved cache.
 * Invalid values (non-integer or negative) fall back to ``128``.
+
+Schema validator backend can be selected with:
+
+.. code-block:: bash
+
+   OPENAPI_SPEC_VALIDATOR_SCHEMA_VALIDATOR_BACKEND=jsonschema-rs
+
+Allowed values are ``auto`` (default), ``jsonschema``, and
+``jsonschema-rs``.
+Invalid values raise a warning and fall back to ``auto``.

openapi_spec_validator/__main__.py

@@ -8,6 +8,7 @@
 from jsonschema.exceptions import best_match
 
 from openapi_spec_validator import __version__
+from openapi_spec_validator import schemas
 from openapi_spec_validator.readers import read_from_filename
 from openapi_spec_validator.readers import read_from_stdin
 from openapi_spec_validator.shortcuts import get_validator_cls
@@ -38,6 +39,7 @@ def print_validationerror(
     exc: ValidationError,
     subschema_errors: str = "best-match",
     index: int | None = None,
+    supports_subschema_details: bool = True,
 ) -> None:
     if index is None:
         print(f"{filename}: Validation Error: {exc}")
@@ -46,6 +48,13 @@ def print_validationerror(
     if exc.cause:
         print("\n# Cause\n")
         print(exc.cause)
+    if not supports_subschema_details:
+        print("\n\n# Subschema details\n")
+        print(
+            "Subschema error details are not available "
+            "with jsonschema-rs backend."
+        )
+        return
     if not exc.context:
         return
     if subschema_errors == "all":
@@ -139,6 +148,10 @@ def main(args: Sequence[str] | None = None) -> None:
     if subschema_errors is None:
         subschema_errors = "best-match"
 
+    supports_subschema_details = (
+        schemas.get_validator_backend() != "rust (jsonschema-rs)"
+    )
+
     for filename in args_parsed.file:
         # choose source
         reader = read_from_filename
@@ -181,6 +194,9 @@ def main(args: Sequence[str] | None = None) -> None:
                             err,
                             subschema_errors,
                             index=idx,
+                            supports_subschema_details=(
+                                supports_subschema_details
+                            ),
                         )
                     print(f"{filename}: {len(errors)} validation errors found")
                     sys.exit(1)
@@ -189,7 +205,12 @@ def main(args: Sequence[str] | None = None) -> None:
 
             validate(spec, base_uri=base_uri, cls=validator_cls)
         except ValidationError as exc:
-            print_validationerror(filename, exc, subschema_errors)
+            print_validationerror(
+                filename,
+                exc,
+                subschema_errors,
+                supports_subschema_details=supports_subschema_details,
+            )
             sys.exit(1)
         except Exception as exc:
             print_error(filename, exc)

openapi_spec_validator/schemas/__init__.py

@@ -1,14 +1,63 @@
 """OpenAIP spec validator schemas module."""
 
 from functools import partial
+from typing import Any
 
 from jsonschema.validators import Draft4Validator
 from jsonschema.validators import Draft202012Validator
 from lazy_object_proxy import Proxy
 
 from openapi_spec_validator.schemas.utils import get_schema_content
+from openapi_spec_validator.settings import get_schema_validator_backend
 
-__all__ = ["schema_v2", "schema_v3", "schema_v30", "schema_v31", "schema_v32"]
+_create_jsonschema_rs_validator_impl: Any = None
+
+# Import jsonschema-rs adapters
+try:
+    from openapi_spec_validator.schemas.jsonschema_rs_adapters import (
+        create_validator as _create_jsonschema_rs_validator_impl,
+    )
+    from openapi_spec_validator.schemas.jsonschema_rs_adapters import (
+        has_jsonschema_rs_validators,
+    )
+
+    _USE_JSONSCHEMA_RS = has_jsonschema_rs_validators()
+except ImportError:
+    _create_jsonschema_rs_validator_impl = None
+    _USE_JSONSCHEMA_RS = False
+
+    def has_jsonschema_rs_validators() -> bool:
+        return False
+
+    pass
+
+
+_BACKEND_MODE = get_schema_validator_backend()
+
+if _BACKEND_MODE == "jsonschema":
+    _USE_JSONSCHEMA_RS = False
+elif _BACKEND_MODE == "jsonschema-rs" and not _USE_JSONSCHEMA_RS:
+    raise ImportError(
+        "OPENAPI_SPEC_VALIDATOR_SCHEMA_VALIDATOR_BACKEND=jsonschema-rs "
+        "is set but jsonschema-rs is not available. "
+        "Install it with: pip install jsonschema-rs"
+    )
+
+
+def get_validator_backend() -> str:
+    if _USE_JSONSCHEMA_RS:
+        return "rust (jsonschema-rs)"
+    return "python (jsonschema)"
+
+
+__all__ = [
+    "schema_v2",
+    "schema_v3",
+    "schema_v30",
+    "schema_v31",
+    "schema_v32",
+    "get_validator_backend",
+]
 
 get_schema_content_v2 = partial(get_schema_content, "2.0")
 get_schema_content_v30 = partial(get_schema_content, "3.0")
@@ -23,10 +72,53 @@
 # alias to the latest v3 version
 schema_v3 = schema_v32
 
-get_openapi_v2_schema_validator = partial(Draft4Validator, schema_v2)
-get_openapi_v30_schema_validator = partial(Draft4Validator, schema_v30)
-get_openapi_v31_schema_validator = partial(Draft202012Validator, schema_v31)
-get_openapi_v32_schema_validator = partial(Draft202012Validator, schema_v32)
+
+def _create_jsonschema_rs_schema_validator(
+    schema: dict[str, Any],
+    draft: str,
+) -> Any:
+    if _create_jsonschema_rs_validator_impl is None:
+        raise ImportError(
+            "jsonschema-rs is not available. "
+            "Install it with: pip install jsonschema-rs"
+        )
+    return _create_jsonschema_rs_validator_impl(schema, draft)
+
+
+# Validator factory functions with Rust/Python selection
+def get_openapi_v2_schema_validator() -> Any:
+    """Create OpenAPI 2.0 schema validator (Draft4)."""
+    if _USE_JSONSCHEMA_RS:
+        return _create_jsonschema_rs_schema_validator(dict(schema_v2), draft="draft4")
+    return Draft4Validator(schema_v2)
+
+
+def get_openapi_v30_schema_validator() -> Any:
+    """Create OpenAPI 3.0 schema validator (Draft4)."""
+    if _USE_JSONSCHEMA_RS:
+        return _create_jsonschema_rs_schema_validator(dict(schema_v30), draft="draft4")
+    return Draft4Validator(schema_v30)
+
+
+def get_openapi_v31_schema_validator() -> Any:
+    """Create OpenAPI 3.1 schema validator (Draft 2020-12)."""
+    if _USE_JSONSCHEMA_RS:
+        return _create_jsonschema_rs_schema_validator(
+            dict(schema_v31),
+            draft="draft202012",
+        )
+    return Draft202012Validator(schema_v31)
+
+
+def get_openapi_v32_schema_validator() -> Any:
+    """Create OpenAPI 3.2 schema validator (Draft 2020-12)."""
+    if _USE_JSONSCHEMA_RS:
+        return _create_jsonschema_rs_schema_validator(
+            dict(schema_v32),
+            draft="draft202012",
+        )
+    return Draft202012Validator(schema_v32)
+
 
 openapi_v2_schema_validator = Proxy(get_openapi_v2_schema_validator)
 openapi_v30_schema_validator = Proxy(get_openapi_v30_schema_validator)