fastapi-router-versioning 0.1.2__tar.gz → 0.2.1__tar.gz

{fastapi_router_versioning-0.1.2 → fastapi_router_versioning-0.2.1}/.github/workflows/pre-commit.yml

@@ -21,7 +21,7 @@ jobs:
         run: echo "$GITHUB_CONTEXT"
 
       - name: Checkout code
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
           # Full history required for --from-ref/--to-ref diff in prek

{fastapi_router_versioning-0.1.2 → fastapi_router_versioning-0.2.1}/.github/workflows/prepare-release.yml

@@ -31,7 +31,7 @@ jobs:
       issues: write
       pull-requests: write
     steps:
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: true
       - name: Set up Python

{fastapi_router_versioning-0.1.2 → fastapi_router_versioning-0.2.1}/.github/workflows/publish.yml

@@ -20,7 +20,7 @@ jobs:
         env:
           GITHUB_CONTEXT: ${{ toJson(github) }}
         run: echo "$GITHUB_CONTEXT"
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
       - name: Set up Python

{fastapi_router_versioning-0.1.2 → fastapi_router_versioning-0.2.1}/.github/workflows/test-redistribute.yml

@@ -20,7 +20,7 @@ jobs:
     outputs:
       src: ${{ steps.filter.outputs.src }}
     steps:
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
       - uses: dorny/paths-filter@fbd0ab8f3e69293af611ebaee6363fc25e6d187d # v4.0.1
@@ -48,7 +48,7 @@ jobs:
         env:
           GITHUB_CONTEXT: ${{ toJson(github) }}
         run: echo "$GITHUB_CONTEXT"
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
       - name: Set up Python

{fastapi_router_versioning-0.1.2 → fastapi_router_versioning-0.2.1}/.github/workflows/test.yml

@@ -25,7 +25,7 @@ jobs:
     outputs:
       src: ${{ steps.filter.outputs.src }}
     steps:
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
       - uses: dorny/paths-filter@fbd0ab8f3e69293af611ebaee6363fc25e6d187d # v4.0.1
@@ -70,7 +70,7 @@ jobs:
           GITHUB_CONTEXT: ${{ toJson(github) }}
         run: echo "$GITHUB_CONTEXT"
 
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
 
@@ -122,7 +122,7 @@ jobs:
     permissions:
       contents: read
     steps:
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
 

{fastapi_router_versioning-0.1.2 → fastapi_router_versioning-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-router-versioning
-Version: 0.1.2
+Version: 0.2.1
 Summary: Router-based API versioning for FastAPI, with per-version docs and a declarative route lifecycle.
 Project-URL: Homepage, https://github.com/mat81black/fastapi-router-versioning
 Project-URL: Repository, https://github.com/mat81black/fastapi-router-versioning
@@ -19,6 +19,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
@@ -46,6 +47,7 @@ FastAPI has no built-in versioning mechanism. The common workaround — duplicat
 - **Latest alias** — serve the newest version under a stable `/latest` prefix
 - **Self-hosted docs** — point Swagger UI and ReDoc at your own assets for air-gapped environments
 - **Reverse proxy aware** — doc URLs include the ASGI `root_path` at request time, so sub-app mounting works out of the box
+- **Configurable validation error code** — return `400` (or any code) instead of `422` for request validation errors, with the OpenAPI schema updated automatically
 - **Broad compatibility** — works with nested routers, WebSockets, `Depends`, and OpenAPI Callbacks
 
 ---
@@ -168,6 +170,8 @@ Routes without `@api_version` fall back to `default_version` (default: `(1, 0)`
 | `redoc_js_url` | `str \| None` | FastAPI CDN | Custom URL for the ReDoc JS bundle |
 | `redoc_favicon_url` | `str \| None` | FastAPI favicon | Custom URL for the ReDoc favicon |
 | `redoc_with_google_fonts` | `bool` | `True` | If `False`, ReDoc will not load Google Fonts |
+| `validation_error_code` | `int` | `422` | HTTP status code returned for request validation errors; also replaces the `422` entry in the OpenAPI schema |
+| `handle_validation_exceptions` | `bool` | `True` | If `False`, only the schema is updated — register your own `RequestValidationError` handler to control the response body |
 
 Call `.versionize()` after constructing the object. It returns the list of active versions.
 
@@ -361,6 +365,41 @@ RouterVersioner(
 
 See [`examples/download_static_assets.py`](examples/download_static_assets.py) for a script that downloads all required assets in one step, and [`examples/self_hosted_docs_app.py`](examples/self_hosted_docs_app.py) for a complete working example.
 
+### Validation error code
+
+By default FastAPI returns `422 Unprocessable Entity` for request validation errors.
+Use `validation_error_code` to change the code returned both at runtime and in the OpenAPI schema:
+
+```python
+RouterVersioner(
+    app=app,
+    routers=router,
+    version_format=VersionFormat.SEMVER,
+    validation_error_code=400,
+).versionize()
+# Validation errors now return 400; the schema shows 400 instead of 422
+```
+
+To keep full control over the response body, set `handle_validation_exceptions=False` and register your own handler:
+
+```python
+from fastapi import Request
+from fastapi.exceptions import RequestValidationError
+from fastapi.responses import JSONResponse
+
+@app.exception_handler(RequestValidationError)
+async def my_handler(request: Request, exc: RequestValidationError) -> JSONResponse:
+    return JSONResponse(status_code=400, content={"errors": exc.errors()})
+
+RouterVersioner(
+    app=app,
+    routers=router,
+    version_format=VersionFormat.SEMVER,
+    validation_error_code=400,
+    handle_validation_exceptions=False,  # schema updated; handler is yours
+).versionize()
+```
+
 ### Reverse proxy / sub-app mounting
 
 When the app runs behind a reverse proxy or is mounted as a sub-application, the ASGI `root_path` is included in all per-version doc URLs automatically — no extra configuration needed:
@@ -401,6 +440,8 @@ Runnable examples are available in the [`examples/`](examples/) directory:
 | [`webhook_versioning_app.py`](examples/webhook_versioning_app.py) | Per-version webhook definitions via `webhook_routers` |
 | [`multi_router_app.py`](examples/multi_router_app.py) | Multiple routers versioned together |
 | [`self_hosted_docs_app.py`](examples/self_hosted_docs_app.py) | Swagger UI and ReDoc from local static assets |
+| [`validation_error_code_app.py`](examples/validation_error_code_app.py) | Return `400` instead of `422` for validation errors (automatic handler via `RouterVersioner`) |
+| [`validation_error_code_custom_handler_app.py`](examples/validation_error_code_custom_handler_app.py) | Same, but with `handle_validation_exceptions=False` and a user-defined exception handler |
 
 ---
 

{fastapi_router_versioning-0.1.2 → fastapi_router_versioning-0.2.1}/README.md

@@ -18,6 +18,7 @@ FastAPI has no built-in versioning mechanism. The common workaround — duplicat
 - **Latest alias** — serve the newest version under a stable `/latest` prefix
 - **Self-hosted docs** — point Swagger UI and ReDoc at your own assets for air-gapped environments
 - **Reverse proxy aware** — doc URLs include the ASGI `root_path` at request time, so sub-app mounting works out of the box
+- **Configurable validation error code** — return `400` (or any code) instead of `422` for request validation errors, with the OpenAPI schema updated automatically
 - **Broad compatibility** — works with nested routers, WebSockets, `Depends`, and OpenAPI Callbacks
 
 ---
@@ -140,6 +141,8 @@ Routes without `@api_version` fall back to `default_version` (default: `(1, 0)`
 | `redoc_js_url` | `str \| None` | FastAPI CDN | Custom URL for the ReDoc JS bundle |
 | `redoc_favicon_url` | `str \| None` | FastAPI favicon | Custom URL for the ReDoc favicon |
 | `redoc_with_google_fonts` | `bool` | `True` | If `False`, ReDoc will not load Google Fonts |
+| `validation_error_code` | `int` | `422` | HTTP status code returned for request validation errors; also replaces the `422` entry in the OpenAPI schema |
+| `handle_validation_exceptions` | `bool` | `True` | If `False`, only the schema is updated — register your own `RequestValidationError` handler to control the response body |
 
 Call `.versionize()` after constructing the object. It returns the list of active versions.
 
@@ -333,6 +336,41 @@ RouterVersioner(
 
 See [`examples/download_static_assets.py`](examples/download_static_assets.py) for a script that downloads all required assets in one step, and [`examples/self_hosted_docs_app.py`](examples/self_hosted_docs_app.py) for a complete working example.
 
+### Validation error code
+
+By default FastAPI returns `422 Unprocessable Entity` for request validation errors.
+Use `validation_error_code` to change the code returned both at runtime and in the OpenAPI schema:
+
+```python
+RouterVersioner(
+    app=app,
+    routers=router,
+    version_format=VersionFormat.SEMVER,
+    validation_error_code=400,
+).versionize()
+# Validation errors now return 400; the schema shows 400 instead of 422
+```
+
+To keep full control over the response body, set `handle_validation_exceptions=False` and register your own handler:
+
+```python
+from fastapi import Request
+from fastapi.exceptions import RequestValidationError
+from fastapi.responses import JSONResponse
+
+@app.exception_handler(RequestValidationError)
+async def my_handler(request: Request, exc: RequestValidationError) -> JSONResponse:
+    return JSONResponse(status_code=400, content={"errors": exc.errors()})
+
+RouterVersioner(
+    app=app,
+    routers=router,
+    version_format=VersionFormat.SEMVER,
+    validation_error_code=400,
+    handle_validation_exceptions=False,  # schema updated; handler is yours
+).versionize()
+```
+
 ### Reverse proxy / sub-app mounting
 
 When the app runs behind a reverse proxy or is mounted as a sub-application, the ASGI `root_path` is included in all per-version doc URLs automatically — no extra configuration needed:
@@ -373,6 +411,8 @@ Runnable examples are available in the [`examples/`](examples/) directory:
 | [`webhook_versioning_app.py`](examples/webhook_versioning_app.py) | Per-version webhook definitions via `webhook_routers` |
 | [`multi_router_app.py`](examples/multi_router_app.py) | Multiple routers versioned together |
 | [`self_hosted_docs_app.py`](examples/self_hosted_docs_app.py) | Swagger UI and ReDoc from local static assets |
+| [`validation_error_code_app.py`](examples/validation_error_code_app.py) | Return `400` instead of `422` for validation errors (automatic handler via `RouterVersioner`) |
+| [`validation_error_code_custom_handler_app.py`](examples/validation_error_code_custom_handler_app.py) | Same, but with `handle_validation_exceptions=False` and a user-defined exception handler |
 
 ---
 

{fastapi_router_versioning-0.1.2 → fastapi_router_versioning-0.2.1}/RELEASE_NOTES.md

@@ -2,6 +2,23 @@
 
 ## Latest Changes
 
+## 0.2.1 (2026-06-26)
+
+### Fixes
+
+* 🐛 Fix `api_version` signature to enforce `deprecate_in` and `remove_in` as keyword-only arguments, aligning the implementation with the documented signature. PR [#18](https://github.com/mat81black/fastapi-router-versioning/pull/18) by [@mat81black](https://github.com/mat81black).
+
+## 0.2.0 (2026-06-26)
+
+### Features
+
+* ✨ Add `validation_error_code` parameter to `RouterVersioner` to override the HTTP status code returned for request validation errors (default: `422`). The OpenAPI schema is updated automatically to reflect the custom code. PR [#16](https://github.com/mat81black/fastapi-router-versioning/pull/16) by [@mat81black](https://github.com/mat81black).
+* ✨ Add `handle_validation_exceptions` parameter to `RouterVersioner`: when `False`, only the OpenAPI schema is updated, leaving the exception handler to the user. PR [#16](https://github.com/mat81black/fastapi-router-versioning/pull/16) by [@mat81black](https://github.com/mat81black).
+
+### Fixes
+
+* 🐛 Fix Python 3.14 classifier not actually added to `pyproject.toml` in 0.1.2. PR [#15](https://github.com/mat81black/fastapi-router-versioning/pull/15) by [@mat81black](https://github.com/mat81black).
+
 ## 0.1.2 (2026-06-25)
 
 ### Internal

{fastapi_router_versioning-0.1.2 → fastapi_router_versioning-0.2.1}/examples/openapi_hook_app.py

@@ -58,4 +58,4 @@ versioner.versionize()
 if __name__ == "__main__":
     import uvicorn
 
-    uvicorn.run(app, host="127.0.0.1", port=8003)
+    uvicorn.run(app, host="127.0.0.1", port=8004)

{fastapi_router_versioning-0.1.2 → fastapi_router_versioning-0.2.1}/examples/self_hosted_docs_app.py

@@ -54,4 +54,4 @@ versioner.versionize()
 if __name__ == "__main__":
     import uvicorn
 
-    uvicorn.run(app, host="127.0.0.1", port=8004)
+    uvicorn.run(app, host="127.0.0.1", port=8005)

fastapi_router_versioning-0.2.1/examples/validation_error_code_app.py

@@ -0,0 +1,57 @@
+"""Demonstrate overriding the HTTP status code returned for request validation errors.
+
+By default FastAPI returns 422 Unprocessable Entity for validation errors.
+``validation_error_code=400`` makes RouterVersioner register an exception handler
+and update the OpenAPI schema to reflect the custom code automatically.
+
+Run:
+    python examples/validation_error_code_app.py
+
+Then open http://127.0.0.1:8007/v1_0/docs and try ``POST /v1_0/items`` with body
+``{"name": "widget", "quantity": "not-a-number"}`` to see the 400 response from
+the server (not a Swagger client-side message).
+"""
+
+from fastapi import APIRouter, FastAPI
+from pydantic import BaseModel
+
+from fastapi_router_versioning import RouterVersioner, VersionFormat, api_version
+
+
+class CreateItemRequest(BaseModel):
+    name: str
+    quantity: int
+
+
+app = FastAPI(
+    title="Validation Error Code — Automatic Handler",
+    description=(
+        "Validation errors return **400 Bad Request** instead of 422.\n\n"
+        'Try `POST /v1_0/items` with body `{"name": "widget", "quantity": "not-a-number"}` '
+        "to see the 400 response from the server."
+    ),
+)
+
+router = APIRouter()
+
+
+@router.post("/items")
+@api_version((1, 0))
+def create_item(body: CreateItemRequest) -> dict[str, str]:
+    """Create an item. ``name`` must be a string, ``quantity`` must be an integer."""
+    return {"name": body.name, "quantity": str(body.quantity)}
+
+
+RouterVersioner(
+    app=app,
+    routers=router,
+    version_format=VersionFormat.SEMVER,
+    validation_error_code=400,
+    # handle_validation_exceptions=True is the default: no extra code needed.
+).versionize()
+
+
+if __name__ == "__main__":
+    import uvicorn
+
+    uvicorn.run(app, host="127.0.0.1", port=8007)

fastapi_router_versioning-0.2.1/examples/validation_error_code_custom_handler_app.py

@@ -0,0 +1,70 @@
+"""Demonstrate using a custom validation exception handler alongside validation_error_code.
+
+Setting ``handle_validation_exceptions=False`` tells RouterVersioner to update the
+OpenAPI schema (so it shows 400 instead of 422) without registering any handler.
+You then register your own handler for full control over the response body.
+
+Run:
+    python examples/validation_error_code_custom_handler_app.py
+
+Then open http://127.0.0.1:8008/v1_0/docs and try ``POST /v1_0/orders`` with body
+``{"name": "widget", "quantity": "not-a-number"}`` to see the custom 400 response
+with field-level error messages.
+"""
+
+from fastapi import APIRouter, FastAPI, Request
+from fastapi.exceptions import RequestValidationError
+from fastapi.responses import JSONResponse
+from pydantic import BaseModel
+
+from fastapi_router_versioning import RouterVersioner, VersionFormat, api_version
+
+
+class CreateOrderRequest(BaseModel):
+    name: str
+    quantity: int
+
+
+app = FastAPI(
+    title="Validation Error Code — Custom Handler",
+    description=(
+        "Validation errors return **400 Bad Request** with a custom response body.\n\n"
+        'Try `POST /v1_0/orders` with body `{"name": "widget", "quantity": "not-a-number"}` '
+        "to see the custom handler response."
+    ),
+)
+
+router = APIRouter()
+
+
+@router.post("/orders")
+@api_version((1, 0))
+def create_order(body: CreateOrderRequest) -> dict[str, str]:
+    """Create an order. ``name`` must be a string, ``quantity`` must be an integer."""
+    return {"name": body.name, "quantity": str(body.quantity)}
+
+
+@app.exception_handler(RequestValidationError)
+async def my_validation_handler(request: Request, exc: RequestValidationError) -> JSONResponse:
+    """Returns field-level error messages under an 'errors' key."""
+    return JSONResponse(
+        status_code=400,
+        content={
+            "errors": [{"field": e["loc"][-1], "message": e["msg"]} for e in exc.errors()],
+        },
+    )
+
+
+RouterVersioner(
+    app=app,
+    routers=router,
+    version_format=VersionFormat.SEMVER,
+    validation_error_code=400,
+    handle_validation_exceptions=False,  # OpenAPI schema shows 400; handler is yours.
+).versionize()
+
+
+if __name__ == "__main__":
+    import uvicorn
+
+    uvicorn.run(app, host="127.0.0.1", port=8008)

{fastapi_router_versioning-0.1.2 → fastapi_router_versioning-0.2.1}/examples/webhook_versioning_app.py

@@ -88,4 +88,4 @@ versioner.versionize()
 if __name__ == "__main__":
     import uvicorn
 
-    uvicorn.run(app, host="127.0.0.1", port=8004)
+    uvicorn.run(app, host="127.0.0.1", port=8006)

{fastapi_router_versioning-0.1.2 → fastapi_router_versioning-0.2.1}/fastapi_router_versioning/__init__.py

@@ -1,5 +1,5 @@
 from .versioner import RouterVersioner, VersionFormat, VersionT, api_version
 
-__version__ = "0.1.2"
+__version__ = "0.2.1"
 
 __all__ = ["RouterVersioner", "api_version", "VersionFormat", "VersionT"]

{fastapi_router_versioning-0.1.2 → fastapi_router_versioning-0.2.1}/fastapi_router_versioning/versioner.py

@@ -9,6 +9,8 @@ import fastapi.openapi.utils
 import fastapi.routing
 
 from fastapi import APIRouter, FastAPI
+from fastapi.encoders import jsonable_encoder
+from fastapi.exceptions import RequestValidationError
 from fastapi.openapi.docs import (
     get_redoc_html,
     get_swagger_ui_html,
@@ -83,6 +85,7 @@ def _validate_api_version_arg(value: Any, param_name: str) -> None:
 
 def api_version(
     version: VersionT,
+    *,
     deprecate_in: VersionT | None = None,
     remove_in: VersionT | None = None,
 ) -> Callable[[CallableT], CallableT]:
@@ -137,6 +140,8 @@ class RouterVersioner:
         redoc_js_url: str | None = None,
         redoc_favicon_url: str | None = None,
         redoc_with_google_fonts: bool = True,
+        validation_error_code: int = 422,
+        handle_validation_exceptions: bool = True,
     ):
         """
         Versionize your FastAPI application in-place, organizing routes based on their API version.
@@ -171,6 +176,10 @@ class RouterVersioner:
         :param redoc_js_url: Custom URL for the ReDoc JS bundle. Defaults to FastAPI's CDN URL.
         :param redoc_favicon_url: Custom URL for the ReDoc favicon. Defaults to FastAPI's favicon.
         :param redoc_with_google_fonts: If False, ReDoc will not load Google Fonts. Defaults to True.
+        :param validation_error_code: HTTP status code returned for request validation errors. Defaults to 422.
+        :param handle_validation_exceptions: If True (default), registers an exception handler that returns
+            validation errors with the given ``validation_error_code``. Set to False to register your own
+            handler while still having the OpenAPI schema reflect the custom code.
         """
         self._app = app
         self._routers = [routers] if isinstance(routers, APIRouter) else routers
@@ -214,6 +223,12 @@ class RouterVersioner:
         self._docs_url = getattr(app, "docs_url", "/docs")
         self._redoc_url = getattr(app, "redoc_url", "/redoc")
 
+        self._validation_error_code = validation_error_code
+        self._handle_validation_exceptions = handle_validation_exceptions
+
+        if self._validation_error_code != 422 and self._handle_validation_exceptions:
+            self._register_validation_exception_handler()
+
     def _validate_version_type(self, version: Any, route_path: str) -> None:
         if self._version_format == VersionFormat.SEMVER:
             if not isinstance(version, tuple) or len(version) != 2 or not all(isinstance(i, int) for i in version):
@@ -456,6 +471,9 @@ class RouterVersioner:
                     separate_input_output_schemas=self._app.separate_input_output_schemas,
                     external_docs=self._app.openapi_external_docs,
                 )
+
+                self._patch_validation_error_openapi(schema)
+
                 if self._openapi_hook is not None:
                     schema = self._openapi_hook(schema, version)
                 self._openapi_schemas_cache[version] = schema
@@ -582,3 +600,57 @@ class RouterVersioner:
             filtered_kwargs.pop("name")
 
         add_method(**filtered_kwargs)
+
+    def _register_validation_exception_handler(self) -> None:
+        if getattr(self._app.state, "_validation_overridden", False):
+            return
+
+        @self._app.exception_handler(RequestValidationError)
+        async def custom_validation_exception_handler(_request: Request, exc: RequestValidationError) -> JSONResponse:
+            return JSONResponse(
+                status_code=self._validation_error_code,
+                content={"detail": jsonable_encoder(exc.errors())},
+            )
+
+        self._app.state._validation_overridden = True
+
+    def _patch_validation_error_openapi(self, schema: dict[str, Any]) -> None:
+        if self._validation_error_code == 422:
+            return
+
+        target_code = str(self._validation_error_code)
+        http_methods = {"get", "put", "post", "delete", "options", "head", "patch", "trace"}
+
+        for _path, path_item in schema.get("paths", {}).items():
+            for _method, operation in path_item.items():
+                if _method not in http_methods:
+                    continue
+
+                responses = operation.get("responses", {})
+                if "422" in responses:
+                    response_422 = responses["422"]
+                    content_422 = response_422.get("content", {}).get("application/json", {})
+                    schema_422 = content_422.get("schema", {})
+                    ref = schema_422.get("$ref", "")
+
+                    if ref.endswith("HTTPValidationError"):
+                        if target_code in responses:
+                            existing_response = responses[target_code]
+                            existing_content = existing_response.setdefault("content", {}).setdefault(
+                                "application/json", {}
+                            )
+                            existing_schema = existing_content.setdefault("schema", {})
+
+                            if "anyOf" in existing_schema:
+                                existing_schema["anyOf"].append(schema_422)
+                            elif existing_schema:
+                                existing_content["schema"] = {"anyOf": [existing_schema, schema_422]}
+                            else:
+                                existing_content["schema"] = schema_422
+
+                            old_desc = existing_response.get("description", "Error")
+                            existing_response["description"] = f"{old_desc} / Validation Error"
+
+                            del responses["422"]
+                        else:
+                            responses[target_code] = responses.pop("422")

{fastapi_router_versioning-0.1.2 → fastapi_router_versioning-0.2.1}/pyproject.toml

@@ -25,6 +25,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Internet :: WWW/HTTP",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Typing :: Typed"