Add OpenAPI 3.2 support

OAS 3.2 uses the same JSON Schema dialect (Draft 2020-12) as 3.1,
so OAS32Validator and oas32_format_checker are aliases.

Author: philfreo

AGENTS.md

@@ -17,7 +17,7 @@ Use this as the default operating playbook when making changes.
 ## Source Layout
 
 - `openapi_schema_validator/__init__.py`: public exports + package metadata.
-- `openapi_schema_validator/validators.py`: validator class setup for OAS 3.0/3.1.
+- `openapi_schema_validator/validators.py`: validator class setup for OAS 3.0/3.1/3.2.
 - `openapi_schema_validator/_keywords.py`: custom keyword handlers and ValidationError generation.
 - `openapi_schema_validator/_format.py`: format checker functions and registrations.
 - `openapi_schema_validator/_types.py`: custom type checker setup.

README.rst

@@ -22,6 +22,7 @@ Openapi-schema-validator is a Python library that validates schema against:
 
 * `OpenAPI Schema Specification v3.0 <https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#schemaObject>`__ which is an extended subset of the `JSON Schema Specification Wright Draft 00 <http://json-schema.org/>`__.
 * `OpenAPI Schema Specification v3.1 <https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#schemaObject>`__ which is an extended superset of the `JSON Schema Specification Draft 2020-12 <http://json-schema.org/>`__.
+* `OpenAPI Schema Specification v3.2 <https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.2.0.md#schemaObject>`__ which uses the same JSON Schema dialect as v3.1.
 
 
 Documentation

docs/index.rst

@@ -14,6 +14,7 @@ Openapi-schema-validator is a Python library that validates schema against:
 
 * `OpenAPI Schema Specification v3.0 <https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#schemaObject>`__ which is an extended subset of the `JSON Schema Specification Wright Draft 00 <http://json-schema.org/>`__.
 * `OpenAPI Schema Specification v3.1 <https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#schemaObject>`__ which is an extended superset of the `JSON Schema Specification Draft 2020-12 <http://json-schema.org/>`__.
+* `OpenAPI Schema Specification v3.2 <https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.2.0.md#schemaObject>`__ which uses the same JSON Schema dialect as v3.1.
 
 Installation
 ------------

docs/validation.rst

@@ -67,6 +67,8 @@ if you want to disambiguate the expected schema version, import and use ``OAS31V
 
    validate({"name": "John", "age": 23}, schema, cls=OAS31Validator)
 
+For OpenAPI 3.2, use ``OAS32Validator`` (an alias for ``OAS31Validator``, since 3.2 uses the same JSON Schema dialect).
+
 In order to validate OpenAPI 3.0 schema, import and use ``OAS30Validator`` instead of ``OAS31Validator``.
 
 .. code-block:: python

openapi_schema_validator/__init__.py

@@ -1,12 +1,14 @@
 from openapi_schema_validator._format import oas30_format_checker
 from openapi_schema_validator._format import oas30_strict_format_checker
 from openapi_schema_validator._format import oas31_format_checker
+from openapi_schema_validator._format import oas32_format_checker
 from openapi_schema_validator.shortcuts import validate
 from openapi_schema_validator.validators import OAS30ReadValidator
 from openapi_schema_validator.validators import OAS30StrictValidator
 from openapi_schema_validator.validators import OAS30Validator
 from openapi_schema_validator.validators import OAS30WriteValidator
 from openapi_schema_validator.validators import OAS31Validator
+from openapi_schema_validator.validators import OAS32Validator
 
 __author__ = "Artur Maciag"
 __email__ = "maciag.artur@gmail.com"
@@ -24,4 +26,6 @@
     "oas30_strict_format_checker",
     "OAS31Validator",
     "oas31_format_checker",
+    "OAS32Validator",
+    "oas32_format_checker",
 ]

openapi_schema_validator/_format.py

@@ -105,3 +105,5 @@ def is_password(instance: object) -> bool:
 oas31_format_checker.checks("float")(is_float)
 oas31_format_checker.checks("double")(is_double)
 oas31_format_checker.checks("password")(is_password)
+
+oas32_format_checker = oas31_format_checker

openapi_schema_validator/validators.py

@@ -121,3 +121,6 @@ def _oas30_id_of(schema: Any) -> str:
     type_checker=oas31_type_checker,
     format_checker=oas_format.oas31_format_checker,
 )
+
+# OAS 3.2 uses the same JSON Schema dialect (Draft 2020-12) as OAS 3.1
+OAS32Validator = OAS31Validator

tests/integration/test_validators.py

@@ -19,9 +19,11 @@
 from openapi_schema_validator import OAS30Validator
 from openapi_schema_validator import OAS30WriteValidator
 from openapi_schema_validator import OAS31Validator
+from openapi_schema_validator import OAS32Validator
 from openapi_schema_validator import oas30_format_checker
 from openapi_schema_validator import oas30_strict_format_checker
 from openapi_schema_validator import oas31_format_checker
+from openapi_schema_validator import oas32_format_checker
 
 
 class TestOAS30ValidatorFormatChecker:
@@ -1003,6 +1005,29 @@ def test_array_prefixitems_invalid(self, validator_class, value):
         assert any(error in str(excinfo.value) for error in errors)
 
 
+class TestOAS32ValidatorAliases:
+    """OAS 3.2 uses the same JSON Schema dialect as 3.1, so the validators are aliases."""
+
+    def test_validator_is_oas31(self):
+        assert OAS32Validator is OAS31Validator
+
+    def test_format_checker_is_oas31(self):
+        assert oas32_format_checker is oas31_format_checker
+
+    def test_basic_validation(self):
+        schema = {
+            "type": "object",
+            "required": ["name"],
+            "properties": {"name": {"type": "string"}},
+        }
+        validator = OAS32Validator(schema, format_checker=oas32_format_checker)
+
+        assert validator.validate({"name": "test"}) is None
+
+        with pytest.raises(ValidationError):
+            validator.validate({"not_name": "test"})
+
+
 class TestOAS30StrictValidator:
     """
     Tests for OAS30StrictValidator which follows OAS spec strictly: