fastapi-error-map 0.9.8__tar.gz → 0.9.9__tar.gz

{fastapi_error_map-0.9.8 → fastapi_error_map-0.9.9}/.github/workflows/ci.yaml

@@ -7,21 +7,22 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout
+        uses: actions/checkout@v6
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.9"
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
 
       - name: Install dependencies
         run: uv sync --locked --group all
 
       - name: Lint code
-        run: uv run make code.lint
+        run: uv run make lint
 
       - name: Run tests for Codecov
         run: uv run pytest --cov=fastapi_error_map --cov-branch --cov-report=xml

fastapi_error_map-0.9.9/.github/workflows/publish.yaml

@@ -0,0 +1,59 @@
+name: Publish to PyPI on GitHub Release
+
+on:
+  release:
+    types: [ published ]
+
+env:
+  UV_PYTHON_DOWNLOADS: 0
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    permissions: { }
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Build
+        run: uv build
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v6
+        with:
+          name: python-package-distributions
+          path: dist/*
+
+  publish:
+    name: Publish to PyPI (OIDC)
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+      - name: Download artifact
+        uses: actions/download-artifact@v7
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Publish
+        run: uv publish

{fastapi_error_map-0.9.8 → fastapi_error_map-0.9.9}/.github/workflows/test-compatibility.yaml

@@ -23,14 +23,16 @@ jobs:
           - "3.14"
 
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout
+        uses: actions/checkout@v6
+
       - name: Set up ${{ matrix.python-version }} on ${{ matrix.os }}
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
 
       - name: Run tests
         run: uvx nox -s compatibility

{fastapi_error_map-0.9.8 → fastapi_error_map-0.9.9}/.pre-commit-config.yaml

@@ -1,9 +1,9 @@
 repos:
   - repo: local
     hooks:
-      - id: make-check
-        name: source-code-check
-        entry: make code.check
+      - id: code-check
+        name: code-check (local)
+        entry: uv run make check
         language: system
         pass_filenames: false
         always_run: true

fastapi_error_map-0.9.9/Makefile

@@ -0,0 +1,24 @@
+# Make config
+.SILENT:
+MAKEFLAGS += --no-print-directory
+
+# Code quality
+.PHONY: lint test check coverage
+lint:
+	ruff check --fix
+	ruff format
+	mypy
+
+test:
+	pytest -v
+
+check: lint test
+
+coverage: check
+	coverage html
+
+# Project structure visualization
+.PHONY: pycache-del
+pycache-del:
+	find . -type d -name '__pycache__' -prune -exec rm -rf {} +; \
+	find . -type f \( -name '*.pyc' -o -name '*.pyo' \) -delete

{fastapi_error_map-0.9.8 → fastapi_error_map-0.9.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-error-map
-Version: 0.9.8
+Version: 0.9.9
 Summary: Elegant per-endpoint error handling for FastAPI that keeps OpenAPI in sync
 Project-URL: Homepage, https://github.com/ivan-borovets/fastapi-error-map
 Project-URL: Repository, https://github.com/ivan-borovets/fastapi-error-map
@@ -169,10 +169,13 @@ Parameters of `rule(...)`, * — required:
 
 #### 🧩 Matching semantics
 
-`error_map` matches **exact** exception types only (no inheritance).
-If you map `BaseError` and raise `ChildError(BaseError)`, the rule won’t apply.
-This is by design to keep routing explicit.
-If there’s demand, inheritance-based resolving may be added later as an opt-in.
+`error_map` resolves exceptions using Python's Method Resolution Order (MRO).
+The most specific exception type is matched first.
+If no exact match is found, parent classes are checked in MRO order.
+
+For example, if you map `BaseError` and raise `ChildError(BaseError)`,
+the rule for `BaseError` will apply — unless a specific rule for
+`ChildError` is defined, in which case it takes precedence.
 
 ### 🧰 Custom Translators
 
@@ -271,6 +274,7 @@ In addition to `error_map`, you can also pass:
     warn_on_unmapped=...,
     default_client_error_translator=...,
     default_server_error_translator=...,
+    exclude_none=...,
 )
 ```
 
@@ -299,6 +303,11 @@ When an error occurs, `fastapi-error-map` processes it as follows:
     - Otherwise, `default_on_error` is used if provided
     - If neither is set, nothing is called
 
+4. `exclude_none`:
+    - If `True`, fields with value `None` are omitted from the serialized
+      error response body
+    - If `False` (default), `None` values are included as `null`
+
 #### 🧾 OpenAPI: `responses` Takes Priority
 
 If you explicitly pass the `responses=...` parameter to `.get(...)` / `.post(...)`, it overrides the schema generation

{fastapi_error_map-0.9.8 → fastapi_error_map-0.9.9}/README.md

@@ -142,10 +142,13 @@ Parameters of `rule(...)`, * — required:
 
 #### 🧩 Matching semantics
 
-`error_map` matches **exact** exception types only (no inheritance).
-If you map `BaseError` and raise `ChildError(BaseError)`, the rule won’t apply.
-This is by design to keep routing explicit.
-If there’s demand, inheritance-based resolving may be added later as an opt-in.
+`error_map` resolves exceptions using Python's Method Resolution Order (MRO).
+The most specific exception type is matched first.
+If no exact match is found, parent classes are checked in MRO order.
+
+For example, if you map `BaseError` and raise `ChildError(BaseError)`,
+the rule for `BaseError` will apply — unless a specific rule for
+`ChildError` is defined, in which case it takes precedence.
 
 ### 🧰 Custom Translators
 
@@ -244,6 +247,7 @@ In addition to `error_map`, you can also pass:
     warn_on_unmapped=...,
     default_client_error_translator=...,
     default_server_error_translator=...,
+    exclude_none=...,
 )
 ```
 
@@ -272,6 +276,11 @@ When an error occurs, `fastapi-error-map` processes it as follows:
     - Otherwise, `default_on_error` is used if provided
     - If neither is set, nothing is called
 
+4. `exclude_none`:
+    - If `True`, fields with value `None` are omitted from the serialized
+      error response body
+    - If `False` (default), `None` values are included as `null`
+
 #### 🧾 OpenAPI: `responses` Takes Priority
 
 If you explicitly pass the `responses=...` parameter to `.get(...)` / `.post(...)`, it overrides the schema generation

{fastapi_error_map-0.9.8 → fastapi_error_map-0.9.9}/fastapi_error_map/error_handling.py

@@ -19,6 +19,7 @@ def wrap_with_error_handling(
     default_client_error_translator: ErrorTranslator[Any],
     default_server_error_translator: ErrorTranslator[Any],
     default_on_error: Optional[Callable[[Exception], Union[Awaitable[None], None]]],
+    exclude_none: bool = False,
 ) -> Callable[..., Any]:
     is_coro = inspect.iscoroutinefunction(func)
 
@@ -27,7 +28,7 @@ def wrap_with_error_handling(
         try:
             if is_coro:
                 return await func(*args, **kwargs)
-            return func(*args, **kwargs)
+            return await run_in_threadpool(func, *args, **kwargs)
         except Exception as error:
             return await handle_with_error_map(
                 error=error,
@@ -36,6 +37,7 @@ def wrap_with_error_handling(
                 default_client_error_translator=default_client_error_translator,
                 default_server_error_translator=default_server_error_translator,
                 default_on_error=default_on_error,
+                exclude_none=exclude_none,
             )
 
     return wrapped
@@ -49,6 +51,7 @@ async def handle_with_error_map(
     default_client_error_translator: ErrorTranslator[Any],
     default_server_error_translator: ErrorTranslator[Any],
     default_on_error: Optional[Callable[[Exception], Union[Awaitable[None], None]]],
+    exclude_none: bool,
 ) -> ORJSONResponse:
     try:
         rule = resolve_rule_for_error(
@@ -75,5 +78,8 @@ async def handle_with_error_map(
     content = rule.translator.from_error(error)
     return ORJSONResponse(
         status_code=rule.status,
-        content=jsonable_encoder(content),
+        content=jsonable_encoder(
+            content,
+            exclude_none=exclude_none,
+        ),
     )

{fastapi_error_map-0.9.8 → fastapi_error_map-0.9.9}/fastapi_error_map/routing.py

@@ -48,6 +48,7 @@ class ErrorAwareRoute(APIRoute):
         warn_on_unmapped: bool = True,
         default_client_error_translator: Optional[ErrorTranslator[Any]] = None,
         default_server_error_translator: Optional[ErrorTranslator[Any]] = None,
+        exclude_none: bool = False,
         # --- FastAPI ---
         response_model: Any = Default(None),
         status_code: Optional[int] = None,
@@ -98,6 +99,7 @@ class ErrorAwareRoute(APIRoute):
                 default_on_error=self.default_on_error,
                 default_client_error_translator=self.default_client_error_translator,
                 default_server_error_translator=self.default_server_error_translator,
+                exclude_none=exclude_none,
             )
         responses = {
             **build_openapi_responses(
@@ -405,6 +407,7 @@ class ErrorAwareRouter(APIRouter):
         warn_on_unmapped: bool = True,
         default_client_error_translator: Optional[ErrorTranslator[Any]] = None,
         default_server_error_translator: Optional[ErrorTranslator[Any]] = None,
+        exclude_none: bool = False,
         # --- FastAPI ---
         response_model: Any = Default(None),
         status_code: Optional[int] = None,
@@ -462,6 +465,7 @@ class ErrorAwareRouter(APIRouter):
                 default_on_error=default_on_error,
                 default_client_error_translator=default_client_error_translator,
                 default_server_error_translator=default_server_error_translator,
+                exclude_none=exclude_none,
                 response_model=response_model,
                 status_code=status_code,
                 tags=current_tags,
@@ -528,6 +532,7 @@ class ErrorAwareRouter(APIRouter):
         warn_on_unmapped: bool = True,
         default_client_error_translator: Optional[ErrorTranslator[Any]] = None,
         default_server_error_translator: Optional[ErrorTranslator[Any]] = None,
+        exclude_none: bool = False,
         # --- FastAPI ---
         response_model: Any = Default(None),
         status_code: Optional[int] = None,
@@ -564,6 +569,7 @@ class ErrorAwareRouter(APIRouter):
                 default_on_error=default_on_error,
                 default_client_error_translator=default_client_error_translator,
                 default_server_error_translator=default_server_error_translator,
+                exclude_none=exclude_none,
                 response_model=response_model,
                 status_code=status_code,
                 tags=tags,
@@ -612,6 +618,7 @@ class ErrorAwareRouter(APIRouter):
         warn_on_unmapped: bool = True,
         default_client_error_translator: Optional[ErrorTranslator[Any]] = None,
         default_server_error_translator: Optional[ErrorTranslator[Any]] = None,
+        exclude_none: bool = False,
         # --- FastAPI ---
         response_model: Annotated[
             Any,
@@ -957,6 +964,7 @@ class ErrorAwareRouter(APIRouter):
             default_on_error=default_on_error,
             default_client_error_translator=default_client_error_translator,
             default_server_error_translator=default_server_error_translator,
+            exclude_none=exclude_none,
             response_model=response_model,
             status_code=status_code,
             tags=tags,
@@ -1002,6 +1010,7 @@ class ErrorAwareRouter(APIRouter):
         warn_on_unmapped: bool = True,
         default_client_error_translator: Optional[ErrorTranslator[Any]] = None,
         default_server_error_translator: Optional[ErrorTranslator[Any]] = None,
+        exclude_none: bool = False,
         # --- FastAPI ---
         response_model: Annotated[
             Any,
@@ -1352,6 +1361,7 @@ class ErrorAwareRouter(APIRouter):
             default_on_error=default_on_error,
             default_client_error_translator=default_client_error_translator,
             default_server_error_translator=default_server_error_translator,
+            exclude_none=exclude_none,
             response_model=response_model,
             status_code=status_code,
             tags=tags,
@@ -1397,6 +1407,7 @@ class ErrorAwareRouter(APIRouter):
         warn_on_unmapped: bool = True,
         default_client_error_translator: Optional[ErrorTranslator[Any]] = None,
         default_server_error_translator: Optional[ErrorTranslator[Any]] = None,
+        exclude_none: bool = False,
         # --- FastAPI ---
         response_model: Annotated[
             Any,
@@ -1747,6 +1758,7 @@ class ErrorAwareRouter(APIRouter):
             default_on_error=default_on_error,
             default_client_error_translator=default_client_error_translator,
             default_server_error_translator=default_server_error_translator,
+            exclude_none=exclude_none,
             response_model=response_model,
             status_code=status_code,
             tags=tags,
@@ -1792,6 +1804,7 @@ class ErrorAwareRouter(APIRouter):
         warn_on_unmapped: bool = True,
         default_client_error_translator: Optional[ErrorTranslator[Any]] = None,
         default_server_error_translator: Optional[ErrorTranslator[Any]] = None,
+        exclude_none: bool = False,
         # --- FastAPI ---
         response_model: Annotated[
             Any,
@@ -2142,6 +2155,7 @@ class ErrorAwareRouter(APIRouter):
             default_on_error=default_on_error,
             default_client_error_translator=default_client_error_translator,
             default_server_error_translator=default_server_error_translator,
+            exclude_none=exclude_none,
             response_model=response_model,
             status_code=status_code,
             tags=tags,
@@ -2187,6 +2201,7 @@ class ErrorAwareRouter(APIRouter):
         warn_on_unmapped: bool = True,
         default_client_error_translator: Optional[ErrorTranslator[Any]] = None,
         default_server_error_translator: Optional[ErrorTranslator[Any]] = None,
+        exclude_none: bool = False,
         # --- FastAPI ---
         response_model: Annotated[
             Any,
@@ -2532,6 +2547,7 @@ class ErrorAwareRouter(APIRouter):
             default_on_error=default_on_error,
             default_client_error_translator=default_client_error_translator,
             default_server_error_translator=default_server_error_translator,
+            exclude_none=exclude_none,
             response_model=response_model,
             status_code=status_code,
             tags=tags,

{fastapi_error_map-0.9.8 → fastapi_error_map-0.9.9}/fastapi_error_map/rules.py

@@ -63,9 +63,14 @@ def resolve_rule_for_error(
         Callable[[Exception], Union[Awaitable[None], None]]
     ] = None,
 ) -> ResolvedRule:
-    try:
-        status_or_rule = error_map[type(error)]
-    except KeyError:
+    status_or_rule: Union[int, Rule, None] = None
+    for cls in type(error).mro():
+        if not issubclass(cls, Exception):
+            continue
+        if cls in error_map:
+            status_or_rule = error_map[cls]
+            break
+    if status_or_rule is None:
         raise RuntimeError(f"No rule defined for {type(error).__name__}") from error
 
     if isinstance(status_or_rule, int):

{fastapi_error_map-0.9.8 → fastapi_error_map-0.9.9}/noxfile.py

@@ -11,4 +11,4 @@ def compatibility(session, fastapi):
     else:
         session.run("uv", "add", f"fastapi=={fastapi}", "--active", external=True)
 
-    session.run("uv", "run", "--active", "make", "code.test", external=True)
+    session.run("uv", "run", "--active", "make", "test", external=True)

{fastapi_error_map-0.9.8 → fastapi_error_map-0.9.9}/pyproject.toml

@@ -7,7 +7,7 @@ sources = ["src"]
 
 [project]
 name = "fastapi-error-map"
-version = "0.9.8"
+version = "0.9.9"
 description = "Elegant per-endpoint error handling for FastAPI that keeps OpenAPI in sync"
 readme = "README.md"
 license = { text = "Apache-2.0" }
@@ -44,7 +44,7 @@ dev = [
 test = [
     "coverage==7.10.1",
     "httpx==0.28.1",
-    "nox==2025.5.1",
+    "nox==2025.11.12",
     "pytest==8.4.1",
     "pytest-asyncio==1.1.0",
     "pytest-cov==6.2.1",
@@ -92,6 +92,7 @@ parallel = true
 branch = true
 
 [tool.mypy]
+python_version = "3.9"
 files = [
     "examples",
     "src",
@@ -110,9 +111,11 @@ testpaths = ["tests", ]
 markers = ["slow", ]
 addopts = "-m 'not slow'"
 asyncio_default_fixture_loop_scope = "function"
+asyncio_mode = "auto"
 
 [tool.ruff]
 line-length = 88
+target-version = "py39"
 preview = true  # experimental
 
 [tool.ruff.format]

fastapi_error_map-0.9.9/tests/integration/conftest.py

@@ -0,0 +1,19 @@
+from collections.abc import AsyncIterator
+
+import httpx
+import pytest
+from fastapi import FastAPI
+
+
+@pytest.fixture
+def app() -> FastAPI:
+    return FastAPI()
+
+
+@pytest.fixture
+async def client(app: FastAPI) -> AsyncIterator[httpx.AsyncClient]:
+    async with httpx.AsyncClient(
+        transport=httpx.ASGITransport(app=app),
+        base_url="http://test",
+    ) as client:
+        yield client

{fastapi_error_map-0.9.8 → fastapi_error_map-0.9.9}/tests/integration/test_example.py

@@ -1,22 +1,19 @@
-from typing import TYPE_CHECKING
-
+import httpx
 import pytest
 
 from examples.main import create_app
-from tests.integration.conftest import AsgiClientFactory
-
-if TYPE_CHECKING:
-    import httpx
 
 
 @pytest.mark.asyncio
 async def test_check_stock(
-    asgi_client_factory: AsgiClientFactory,
     capsys: pytest.CaptureFixture[str],
 ) -> None:
     app = create_app()
 
-    async with asgi_client_factory(app) as client:
+    async with httpx.AsyncClient(
+        transport=httpx.ASGITransport(app=app),
+        base_url="http://test",
+    ) as client:
         authz_err_response: httpx.Response = await client.get("/stock?user_id=0")
         out_of_stock_err_response: httpx.Response = await client.get("/stock?user_id=1")
         openapi_response: httpx.Response = await client.get("/openapi.json")

fastapi_error_map-0.9.9/tests/integration/test_exclude_none.py

@@ -0,0 +1,85 @@
+import asyncio
+from dataclasses import dataclass
+from typing import Optional
+
+import httpx
+import pytest
+from fastapi import FastAPI
+
+from fastapi_error_map import ErrorAwareRouter, rule
+from fastapi_error_map.translators import ErrorTranslator
+
+
+class CustomError(Exception):
+    pass
+
+
+@dataclass
+class ClientErrorWithOptionalDetails:
+    error: str
+    details: Optional[str] = None
+
+
+class OptionalDetailsTranslator(ErrorTranslator[ClientErrorWithOptionalDetails]):
+    @property
+    def error_response_model_cls(self) -> type[ClientErrorWithOptionalDetails]:
+        return ClientErrorWithOptionalDetails
+
+    def from_error(self, err: Exception) -> ClientErrorWithOptionalDetails:
+        return ClientErrorWithOptionalDetails(error=str(err), details=None)
+
+
+@pytest.mark.asyncio
+@pytest.mark.parametrize("method", ["get", "post", "put", "patch", "delete"])
+async def test_exclude_none_false_keeps_null_fields(
+    method: str,
+    app: FastAPI,
+    client: httpx.AsyncClient,
+) -> None:
+    router = ErrorAwareRouter()
+    translator = OptionalDetailsTranslator()
+
+    async def failing_endpoint() -> None:
+        await asyncio.sleep(0)
+        raise CustomError("boom")
+
+    getattr(router, method)(
+        "/fail",
+        error_map={CustomError: rule(status=418, translator=translator)},
+        exclude_none=False,
+    )(failing_endpoint)
+    app.include_router(router)
+
+    response: httpx.Response = await getattr(client, method)("/fail")
+
+    assert response.status_code == 418
+    assert response.headers["content-type"].startswith("application/json")
+    assert response.json() == {"error": "boom", "details": None}
+
+
+@pytest.mark.asyncio
+@pytest.mark.parametrize("method", ["get", "post", "put", "patch", "delete"])
+async def test_exclude_none_true_drops_null_fields(
+    method: str,
+    app: FastAPI,
+    client: httpx.AsyncClient,
+) -> None:
+    router = ErrorAwareRouter()
+    translator = OptionalDetailsTranslator()
+
+    async def failing_endpoint() -> None:
+        await asyncio.sleep(0)
+        raise CustomError("boom")
+
+    getattr(router, method)(
+        "/fail",
+        error_map={CustomError: rule(status=418, translator=translator)},
+        exclude_none=True,
+    )(failing_endpoint)
+    app.include_router(router)
+
+    response: httpx.Response = await getattr(client, method)("/fail")
+
+    assert response.status_code == 418
+    assert response.headers["content-type"].startswith("application/json")
+    assert response.json() == {"error": "boom"}

{fastapi_error_map-0.9.8 → fastapi_error_map-0.9.9}/tests/integration/test_routing.py

@@ -1,15 +1,11 @@
 import asyncio
-from typing import TYPE_CHECKING
 from unittest.mock import Mock
 
+import httpx
 import pytest
 from fastapi import FastAPI
 
 from fastapi_error_map import ErrorAwareRouter, rule
-from tests.integration.conftest import AsgiClientFactory
-
-if TYPE_CHECKING:
-    import httpx
 
 
 class CustomError(Exception):
@@ -21,7 +17,7 @@ class CustomError(Exception):
 async def test_error_aware_router_routes(
     method: str,
     app: FastAPI,
-    asgi_client_factory: AsgiClientFactory,
+    client: httpx.AsyncClient,
 ) -> None:
     router = ErrorAwareRouter()
     router_path = "/fail"
@@ -41,9 +37,8 @@ async def test_error_aware_router_routes(
     )(failing_endpoint)
     app.include_router(router)
 
-    async with asgi_client_factory(app) as client:
-        response: httpx.Response = await getattr(client, method)(router_path)
-        openapi_response: httpx.Response = await client.get("/openapi.json")
+    response: httpx.Response = await getattr(client, method)(router_path)
+    openapi_response: httpx.Response = await client.get("/openapi.json")
 
     response_data = response.json()
     assert response.status_code == error_status_code

{fastapi_error_map-0.9.8 → fastapi_error_map-0.9.9}/tests/integration/test_threadpool.py

@@ -1,14 +1,10 @@
 import asyncio
-from typing import TYPE_CHECKING
 
+import httpx
 import pytest
-from fastapi import FastAPI
+from fastapi import APIRouter, FastAPI
 
 from fastapi_error_map import ErrorAwareRouter, rule
-from tests.integration.conftest import AsgiClientFactory
-
-if TYPE_CHECKING:
-    import httpx
 
 
 def has_running_loop_in_this_thread() -> bool:
@@ -20,16 +16,19 @@ def has_running_loop_in_this_thread() -> bool:
 
 
 @pytest.mark.asyncio
-async def test_fastapi_sync_handler_runs_in_threadpool(
+async def test_fastapi_api_router_sync_handler_runs_in_threadpool(
     app: FastAPI,
-    asgi_client_factory: AsgiClientFactory,
+    client: httpx.AsyncClient,
 ) -> None:
-    @app.get("/")
+    router = APIRouter()
+
+    @router.get("/")
     def index():
         return {"in_loop": has_running_loop_in_this_thread()}
 
-    async with asgi_client_factory(app) as client:
-        index_response: httpx.Response = await client.get("/")
+    app.include_router(router)
+
+    index_response: httpx.Response = await client.get("/")
 
     assert index_response.status_code == 200
     assert index_response.json() == {"in_loop": False}
@@ -38,18 +37,17 @@ async def test_fastapi_sync_handler_runs_in_threadpool(
 @pytest.mark.asyncio
 async def test_error_aware_router_sync_handler_runs_in_threadpool(
     app: FastAPI,
-    asgi_client_factory: AsgiClientFactory,
+    client: httpx.AsyncClient,
 ) -> None:
     router = ErrorAwareRouter()
 
-    @app.get("/")
+    @router.get("/", error_map={ValueError: 400})
     def index():
         return {"in_loop": has_running_loop_in_this_thread()}
 
     app.include_router(router)
 
-    async with asgi_client_factory(app) as client:
-        index_response: httpx.Response = await client.get("/")
+    index_response: httpx.Response = await client.get("/")
 
     assert index_response.status_code == 200
     assert index_response.json() == {"in_loop": False}
@@ -58,7 +56,7 @@ async def test_error_aware_router_sync_handler_runs_in_threadpool(
 @pytest.mark.asyncio
 async def test_error_aware_router_sync_on_error_runs_in_threadpool(
     app: FastAPI,
-    asgi_client_factory: AsgiClientFactory,
+    client: httpx.AsyncClient,
 ) -> None:
     router = ErrorAwareRouter()
     seen: dict[str, bool] = {}
@@ -72,8 +70,7 @@ async def test_error_aware_router_sync_on_error_runs_in_threadpool(
 
     app.include_router(router)
 
-    async with asgi_client_factory(app) as client:
-        index_response: httpx.Response = await client.get("/err")
+    index_response: httpx.Response = await client.get("/err")
 
     assert index_response.status_code == 400
     assert seen["in_loop"] is False

{fastapi_error_map-0.9.8 → fastapi_error_map-0.9.9}/tests/unit/test_error_handling.py

@@ -145,6 +145,7 @@ async def test_handles_sync_on_error_from_map() -> None:
         default_client_error_translator=DefaultClientErrorTranslator(),
         default_server_error_translator=DefaultServerErrorTranslator(),
         default_on_error=None,
+        exclude_none=False,
     )
 
     assert sut.status_code == 422
@@ -163,6 +164,7 @@ async def test_handles_default_on_error_from_defaults() -> None:
         default_client_error_translator=DefaultClientErrorTranslator(),
         default_server_error_translator=DefaultServerErrorTranslator(),
         default_on_error=mock_on_error,
+        exclude_none=False,
     )
 
     assert sut.status_code == 422
@@ -181,6 +183,7 @@ async def test_handles_async_on_error() -> None:
         default_client_error_translator=DefaultClientErrorTranslator(),
         default_server_error_translator=DefaultServerErrorTranslator(),
         default_on_error=None,
+        exclude_none=False,
     )
 
     assert sut.status_code == 422
@@ -200,6 +203,7 @@ async def test_handles_async_on_error_partial() -> None:
         default_client_error_translator=DefaultClientErrorTranslator(),
         default_server_error_translator=DefaultServerErrorTranslator(),
         default_on_error=None,
+        exclude_none=False,
     )
 
     assert sut.status_code == 422
@@ -221,6 +225,7 @@ async def test_handles_sync_on_error_returning_awaitable() -> None:
         default_client_error_translator=DefaultClientErrorTranslator(),
         default_server_error_translator=DefaultServerErrorTranslator(),
         default_on_error=None,
+        exclude_none=False,
     )
 
     assert sut.status_code == 422

{fastapi_error_map-0.9.8 → fastapi_error_map-0.9.9}/tests/unit/test_rules.py

@@ -14,6 +14,22 @@ from tests.unit.translator_stubs import (
 ErrorMap = dict[type[Exception], Union[int, Rule]]
 
 
+class ParentError(Exception):
+    pass
+
+
+class ChildError(ParentError):
+    pass
+
+
+class OtherParentError(Exception):
+    pass
+
+
+class MultipleInheritanceError(ChildError, OtherParentError):
+    pass
+
+
 @pytest.mark.parametrize(
     "rule",
     [
@@ -105,3 +121,54 @@ def test_unmapped_error_raises_runtime_error() -> None:
             default_server_error_translator=DummyServerErrorTranslator(),
             default_on_error=None,
         )
+
+
+def test_resolves_child_over_parent() -> None:
+    sut = resolve_rule_for_error(
+        error=ChildError(),
+        error_map={
+            ParentError: 400,
+            ChildError: 409,
+        },
+        default_client_error_translator=DummyClientErrorTranslator(),
+        default_server_error_translator=DummyServerErrorTranslator(),
+    )
+
+    assert sut.status == 409
+
+
+def test_falls_back_to_parent_when_child_missing() -> None:
+    sut = resolve_rule_for_error(
+        error=ChildError(),
+        error_map={
+            ParentError: 400,
+        },
+        default_client_error_translator=DummyClientErrorTranslator(),
+        default_server_error_translator=DummyServerErrorTranslator(),
+    )
+
+    assert sut.status == 400
+
+
+def test_multiple_inheritance_prefers_first_match_in_mro() -> None:
+    sut = resolve_rule_for_error(
+        error=MultipleInheritanceError(),
+        error_map={
+            OtherParentError: 402,
+            ChildError: 409,
+        },
+        default_client_error_translator=DummyClientErrorTranslator(),
+        default_server_error_translator=DummyServerErrorTranslator(),
+    )
+
+    assert sut.status == 409
+
+
+def test_does_not_resolve_base_exception_subclasses() -> None:
+    with pytest.raises(RuntimeError):
+        resolve_rule_for_error(
+            error=KeyboardInterrupt(),  # type: ignore
+            error_map={},
+            default_client_error_translator=DummyClientErrorTranslator(),
+            default_server_error_translator=DummyServerErrorTranslator(),
+        )

{fastapi_error_map-0.9.8 → fastapi_error_map-0.9.9}/uv.lock

@@ -405,7 +405,7 @@ wheels = [
 
 [[package]]
 name = "fastapi-error-map"
-version = "0.9.8"
+version = "0.9.9"
 source = { editable = "." }
 dependencies = [
     { name = "fastapi" },
@@ -464,7 +464,7 @@ all = [
     { name = "hatch", specifier = "==1.14.1" },
     { name = "httpx", specifier = "==0.28.1" },
     { name = "mypy", specifier = "==1.8.0" },
-    { name = "nox", specifier = "==2025.5.1" },
+    { name = "nox", specifier = "==2025.11.12" },
     { name = "pre-commit", specifier = "==4.2.0" },
     { name = "pytest", specifier = "==8.4.1" },
     { name = "pytest-asyncio", specifier = "==1.1.0" },
@@ -476,7 +476,7 @@ dev = [
     { name = "coverage", specifier = "==7.10.1" },
     { name = "httpx", specifier = "==0.28.1" },
     { name = "mypy", specifier = "==1.8.0" },
-    { name = "nox", specifier = "==2025.5.1" },
+    { name = "nox", specifier = "==2025.11.12" },
     { name = "pre-commit", specifier = "==4.2.0" },
     { name = "pytest", specifier = "==8.4.1" },
     { name = "pytest-asyncio", specifier = "==1.1.0" },
@@ -488,7 +488,7 @@ publish = [{ name = "hatch", specifier = "==1.14.1" }]
 test = [
     { name = "coverage", specifier = "==7.10.1" },
     { name = "httpx", specifier = "==0.28.1" },
-    { name = "nox", specifier = "==2025.5.1" },
+    { name = "nox", specifier = "==2025.11.12" },
     { name = "pytest", specifier = "==8.4.1" },
     { name = "pytest-asyncio", specifier = "==1.1.0" },
     { name = "pytest-cov", specifier = "==6.2.1" },
@@ -600,6 +600,30 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
 ]
 
+[[package]]
+name = "humanize"
+version = "4.13.0"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.10'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/98/1d/3062fcc89ee05a715c0b9bfe6490c00c576314f27ffee3a704122c6fd259/humanize-4.13.0.tar.gz", hash = "sha256:78f79e68f76f0b04d711c4e55d32bebef5be387148862cb1ef83d2b58e7935a0", size = 81884, upload-time = "2025-08-25T09:39:20.04Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1e/c7/316e7ca04d26695ef0635dc81683d628350810eb8e9b2299fc08ba49f366/humanize-4.13.0-py3-none-any.whl", hash = "sha256:b810820b31891813b1673e8fec7f1ed3312061eab2f26e3fa192c393d11ed25f", size = 128869, upload-time = "2025-08-25T09:39:18.54Z" },
+]
+
+[[package]]
+name = "humanize"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.10'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/ba/66/a3921783d54be8a6870ac4ccffcd15c4dc0dd7fcce51c6d63b8c63935276/humanize-4.15.0.tar.gz", hash = "sha256:1dd098483eb1c7ee8e32eb2e99ad1910baefa4b75c3aff3a82f4d78688993b10", size = 83599, upload-time = "2025-12-20T20:16:13.19Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c5/7b/bca5613a0c3b542420cf92bd5e5fb8ebd5435ce1011a091f66bb7693285e/humanize-4.15.0-py3-none-any.whl", hash = "sha256:b1186eb9f5a9749cd9cb8565aee77919dd7c8d076161cf44d70e59e3301e1769", size = 132203, upload-time = "2025-12-20T20:16:11.67Z" },
+]
+
 [[package]]
 name = "hyperlink"
 version = "21.0.0"
@@ -832,20 +856,22 @@ wheels = [
 
 [[package]]
 name = "nox"
-version = "2025.5.1"
+version = "2025.11.12"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "argcomplete" },
     { name = "attrs" },
     { name = "colorlog" },
     { name = "dependency-groups" },
+    { name = "humanize", version = "4.13.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.10'" },
+    { name = "humanize", version = "4.15.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.10'" },
     { name = "packaging" },
     { name = "tomli", marker = "python_full_version < '3.11'" },
     { name = "virtualenv" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/b4/80/47712208c410defec169992e57c179f0f4d92f5dd17ba8daca50a8077e23/nox-2025.5.1.tar.gz", hash = "sha256:2a571dfa7a58acc726521ac3cd8184455ebcdcbf26401c7b737b5bc6701427b2", size = 4023334, upload-time = "2025-05-01T16:35:48.056Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/b4/a8/e169497599266d176832e2232c08557ffba97eef87bf8a18f9f918e0c6aa/nox-2025.11.12.tar.gz", hash = "sha256:3d317f9e61f49d6bde39cf2f59695bb4e1722960457eee3ae19dacfe03c07259", size = 4030561, upload-time = "2025-11-12T18:39:03.319Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/a6/be/7b423b02b09eb856beffe76fe8c4121c99852db74dd12a422dcb72d1134e/nox-2025.5.1-py3-none-any.whl", hash = "sha256:56abd55cf37ff523c254fcec4d152ed51e5fe80e2ab8317221d8b828ac970a31", size = 71753, upload-time = "2025-05-01T16:35:46.037Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/34/434c594e0125a16b05a7bedaea33e63c90abbfbe47e5729a735a8a8a90ea/nox-2025.11.12-py3-none-any.whl", hash = "sha256:707171f9f63bc685da9d00edd8c2ceec8405b8e38b5fb4e46114a860070ef0ff", size = 74447, upload-time = "2025-11-12T18:39:01.575Z" },
 ]
 
 [[package]]

fastapi_error_map-0.9.8/Makefile

@@ -1,23 +0,0 @@
-# Code quality
-.PHONY: code.format code.lint code.test code.cov code.cov.html code.check
-code.format:
-	ruff format
-
-code.lint: code.format
-	ruff check --exit-non-zero-on-fix
-	mypy
-
-code.test:
-	pytest -v
-
-code.cov:
-	coverage run -m pytest
-	coverage combine
-	coverage report
-
-code.cov.html:
-	coverage run -m pytest
-	coverage combine
-	coverage html
-
-code.check: code.lint code.test

fastapi_error_map-0.9.8/tests/integration/conftest.py

@@ -1,25 +0,0 @@
-from collections.abc import AsyncIterator
-from contextlib import AbstractAsyncContextManager, asynccontextmanager
-from typing import Callable
-
-import pytest
-from fastapi import FastAPI
-from httpx import ASGITransport, AsyncClient
-
-AsgiClientFactory = Callable[[FastAPI], AbstractAsyncContextManager[AsyncClient]]
-
-
-@pytest.fixture
-def app() -> FastAPI:
-    return FastAPI()
-
-
-@pytest.fixture
-def asgi_client_factory() -> AsgiClientFactory:
-    @asynccontextmanager
-    async def _make(app: FastAPI) -> AsyncIterator[AsyncClient]:
-        transport = ASGITransport(app=app)
-        async with AsyncClient(transport=transport, base_url="http://test") as client:
-            yield client
-
-    return _make