nene2-python 1.8.18__tar.gz → 1.8.20__tar.gz

{nene2_python-1.8.18 → nene2_python-1.8.20}/CHANGELOG.md

@@ -5,6 +5,31 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ---
 
+## [1.8.20] — 2026-05-20
+
+FT72 フィールドトライアル — DatabaseIntegrityException + ErrorHandlerMiddleware.install() 改善。
+
+### Added
+- `ErrorHandlerMiddleware.install(app)` クラスメソッドを追加 (#315) (FT72)
+  — `add_middleware` と `add_exception_handler(RequestValidationError)` を一度に設定し、
+  Pydantic の 422 バリデーションエラーも nene2 Problem Details 形式に自動統一する
+- Field trial reports: `docs/field-trials/2026-05-field-trial-70.md` 〜 `2026-05-field-trial-72.md` (FT70〜FT72)
+
+---
+
+## [1.8.19] — 2026-05-20
+
+FT68 フィールドトライアル — SimpleDomainHandler + extra_factory 実運用検証。
+
+### Changed
+- `problem_details_response` の docstring に `extra` がトップレベルにフラットマージされることを明記 (#308) (FT68)
+- `SimpleDomainHandler` の docstring に `extra_factory` のフラットマージ動作を例示 (#308) (FT68)
+
+### Added
+- Field trial report: `docs/field-trials/2026-05-field-trial-68.md`
+
+---
+
 ## [1.8.18] — 2026-05-20
 
 FT67 フィールドトライアル — SqlAlchemyTransactionManager 実運用検証。

{nene2_python-1.8.18 → nene2_python-1.8.20}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nene2-python
-Version: 1.8.18
+Version: 1.8.20
 Summary: NENE2 Python — minimal API framework following NENE2's design philosophy
 Project-URL: Homepage, https://github.com/hideyukiMORI/nene2-python
 Project-URL: Repository, https://github.com/hideyukiMORI/nene2-python

nene2_python-1.8.20/docs/field-trials/2026-05-field-trial-68.md

@@ -0,0 +1,67 @@
+# FT68: SimpleDomainHandler + extra_factory 実運用検証
+
+**日付**: 2026-05-20  
+**テーマ**: ドメイン例外ハンドラー (`SimpleDomainHandler`) + `extra_factory` の実運用確認  
+**バージョン**: v1.8.18 → v1.8.19 (ドキュメント追加)  
+**FTディレクトリ**: `/home/xi/docker/nene2-python-FT/ft68-domain-handler/`
+
+---
+
+## 概要
+
+`nene2.middleware.SimpleDomainHandler` を使って複数のドメイン例外クラスをそれぞれの
+HTTP レスポンスにマッピングし、`extra_factory` による動的フィールドを検証した。
+
+---
+
+## 実装内容
+
+- `ArticleNotFoundError`, `ArticleAccessDeniedError`, `ArticleTitleConflictError`: 独自例外クラス
+- 各例外に `SimpleDomainHandler` + `detail_factory` + `extra_factory` を設定
+- `ErrorHandlerMiddleware(domain_handlers=[...])` に渡して自動ハンドリング
+
+---
+
+## テスト結果
+
+**7/7 passed** (テスト修正後)
+
+| テスト | 結果 |
+|---|---|
+| `test_existing_article_returns_200` | PASSED |
+| `test_not_found_returns_404_with_article_id` | PASSED |
+| `test_access_denied_returns_403` | PASSED |
+| `test_title_conflict_returns_409` | PASSED |
+| `test_detail_factory_populates_detail_field` | PASSED |
+| `test_problem_details_format_compliant` | PASSED |
+| `test_successful_create_returns_201` | PASSED |
+
+---
+
+## Friction Points
+
+### FP-1: `extra_factory` のフィールドがトップレベルにフラットマージされることが不明瞭
+
+**発生箇所**: テストで `data["extra"]["article_id"]` とアクセスして `KeyError: 'extra'`
+
+**症状**:
+```python
+# 期待していた構造
+assert data["extra"]["article_id"] == 999  # → KeyError: 'extra'
+
+# 実際の構造（RFC 9457 extension members = トップレベル）
+assert data["article_id"] == 999  # ← 正しいアクセス方法
+```
+
+**原因**: `extra` という引数名が「ネストされた辞書」を連想させるが、
+実際は RFC 9457 仕様の extension members としてトップレベルにフラットマージされる。
+
+**修正**: `problem_details_response` と `SimpleDomainHandler` の docstring に
+フラットマージである旨とRFC 9457 extension members との関係を明記 (Issue #308, v1.8.19)
+
+---
+
+## 結論
+
+`SimpleDomainHandler` + `extra_factory` は実運用で問題なく使用できる。
+extra フィールドのフラットマージ動作が docstring に明記され、今後は混同を防げる。

nene2_python-1.8.20/docs/field-trials/2026-05-field-trial-69.md

@@ -0,0 +1,58 @@
+# FT69: PaginationQueryParser + PaginationResponse 実運用検証
+
+**日付**: 2026-05-20  
+**テーマ**: ページネーション機能 (`PaginationQueryParser` + `PaginationResponse`) の実運用確認  
+**バージョン**: v1.8.19  
+**FTディレクトリ**: `/home/xi/docker/nene2-python-FT/ft69-pagination/`
+
+---
+
+## 概要
+
+`nene2.http.PaginationQueryParser` を FastAPI の `Depends()` で使い、
+`PaginationResponse` でレスポンスを組み立てるパターンを検証した。
+dataclass アイテムの自動シリアライズも確認。
+
+---
+
+## 実装内容
+
+- `PaginationQueryParser` を `Annotated[..., Depends()]` で受け取り
+- `pagination.limit` / `pagination.offset` でスライス
+- `PaginationResponse(items, limit, offset, total)` で標準レスポンス
+- `total=None` 時に `total` フィールドが省略されることを確認
+
+---
+
+## テスト結果
+
+**8/8 passed**
+
+| テスト | 結果 |
+|---|---|
+| `test_default_pagination_returns_first_20` | PASSED |
+| `test_custom_limit_and_offset` | PASSED |
+| `test_limit_too_large_returns_422` | PASSED |
+| `test_limit_zero_returns_422` | PASSED |
+| `test_negative_offset_returns_422` | PASSED |
+| `test_no_total_omits_total_field` | PASSED |
+| `test_last_page_returns_remaining_items` | PASSED |
+| `test_dataclass_items_serialized_to_dict` | PASSED |
+
+---
+
+## Friction Points
+
+なし。`PaginationQueryParser` + `PaginationResponse` はすべて直感的に動作した。
+
+**特筆点**:
+- `limit=0` や `limit>100` は FastAPI の Query バリデーションが自動で 422 を返す
+- `PaginationResponse.to_dict()` が dataclass インスタンスを自動でシリアライズするのが便利
+- `total=None` 時に `total` フィールドが省略されるため、カーソルページネーションにも対応可能
+
+---
+
+## 結論
+
+`PaginationQueryParser` + `PaginationResponse` は実運用で問題なく使用できる。
+FastAPI の Depends と自然に連携し、デフォルト値 (limit=20, max=100) も適切。

nene2_python-1.8.20/docs/field-trials/2026-05-field-trial-70.md

@@ -0,0 +1,67 @@
+# FT70: 複数ドメイン連携 実運用検証
+
+**日付**: 2026-05-20  
+**テーマ**: 複数ドメイン連携（Post + Comment ネストリソース API）の実運用確認  
+**バージョン**: v1.8.19  
+**FTディレクトリ**: `/home/xi/docker/nene2-python-FT/ft70-multi-domain/`
+
+---
+
+## 概要
+
+Post ドメインと Comment ドメインを組み合わせたネストリソース API を実装し、
+複数のフレームワーク機能を同時に使用した際の統合動作を検証した。
+
+---
+
+## 実装内容
+
+- `GET /posts` — `PaginationQueryParser` + `PaginationResponse` でページネーション
+- `POST /posts` — `SqlAlchemyTransactionManager.transactional()` でインサート
+- `GET /posts/{post_id}` — 存在しない場合 404 (Problem Details)
+- `GET /posts/{post_id}/comments` — 親リソース存在チェック付きページネーション
+- `POST /posts/{post_id}/comments` — 親リソース存在チェック付きインサート
+- `RequestIdMiddleware` + `ErrorHandlerMiddleware` をスタック
+- `StaticPool` を使ったインメモリ SQLite（接続共有）
+- `dataclass(frozen=True, slots=True)` を Post / Comment の値オブジェクトに使用
+
+---
+
+## テスト結果
+
+**10/10 passed**
+
+| テスト | 結果 |
+|---|---|
+| `test_list_posts_returns_paginated` | PASSED |
+| `test_get_post_returns_200` | PASSED |
+| `test_get_nonexistent_post_returns_404` | PASSED |
+| `test_create_post_returns_201` | PASSED |
+| `test_list_comments_for_post` | PASSED |
+| `test_list_comments_for_nonexistent_post_returns_404` | PASSED |
+| `test_create_comment_returns_201` | PASSED |
+| `test_create_comment_for_nonexistent_post_returns_404` | PASSED |
+| `test_request_id_header_present` | PASSED |
+| `test_comment_count_increases_after_create` | PASSED |
+
+---
+
+## Friction Points
+
+なし。複数ドメインを組み合わせた際もすべてのフレームワーク機能が正常に動作した。
+
+**特筆点**:
+- `StaticPool` は FT67 で習得済みのため、インメモリ SQLite の設定は迷わず実施できた
+- `PaginationQueryParser` + `PaginationResponse` のネストリソース（`/posts/{id}/comments`）への適用も自然
+- `SqlAlchemyTransactionManager.transactional()` で Post と Comment の両インサートが問題なく動作
+- `RequestIdMiddleware` は `ErrorHandlerMiddleware` と共存可能（ミドルウェアスタック順序の制約なし）
+- `problem_details_response()` の 404 応答は親リソース (`post-not-found`) に統一可能
+
+---
+
+## 結論
+
+nene2-python の主要機能（Pagination, Transaction, RequestId, ErrorHandler, Problem Details）を
+複数ドメイン連携シナリオで組み合わせても一切の摩擦がなかった。
+FT57〜FT69 で修正・ドキュメント化された機能がすべて期待通り動作し、
+フレームワークの統合品質が高いことを確認できた。

nene2_python-1.8.20/docs/field-trials/2026-05-field-trial-71.md

@@ -0,0 +1,83 @@
+# FT71: 完全レイヤードアーキテクチャ実運用検証
+
+**日付**: 2026-05-20  
+**テーマ**: UseCaseProtocol + Repository パターンによる完全レイヤードアーキテクチャ検証  
+**バージョン**: v1.8.19  
+**FTディレクトリ**: `/home/xi/docker/nene2-python-FT/ft71-layered-arch/`
+
+---
+
+## 概要
+
+NENE2 の核心設計パターン（HTTP Handler → UseCase → Repository の完全分離）を
+Todo ドメインで実装し、`UseCaseProtocol`・`ValidationException`・`InMemoryRepository` 注入が
+実運用で問題なく動作することを確認した。
+
+---
+
+## 実装内容
+
+### ドメイン層（HTTP・DB 非依存）
+- `Todo(id, title, done)` — `dataclass(frozen=True, slots=True)` 値オブジェクト
+- Input/Output DTO 群 — `CreateTodoInput/Output`, `GetTodoInput/Output`, `ListTodosInput/Output`, `CompleteTodoInput/Output`
+- `TodoRepositoryInterface` — `abc.ABC` 抽象インターフェース
+- UseCase 群: `CreateTodoUseCase`, `GetTodoUseCase`, `ListTodosUseCase`, `CompleteTodoUseCase`
+
+### インフラ層
+- `InMemoryTodoRepository` — テスト用インメモリ実装
+- `SqlAlchemyTodoRepository` — 本番用 SQLAlchemy 実装
+
+### HTTP 層（thin handler）
+- `create_app(repository=None)` — `repository` が None の場合 SQLAlchemy を使用、注入された場合はそのまま使用
+- Handler は parse → use-case → response の 3 ステップのみ
+
+---
+
+## テスト結果
+
+**15/15 passed**
+
+| テスト | 結果 | 種別 |
+|---|---|---|
+| `test_create_todo_use_case_returns_new_todo` | PASSED | UseCase 単体 |
+| `test_create_todo_use_case_raises_validation_error_on_blank_title` | PASSED | UseCase 単体 |
+| `test_get_todo_use_case_returns_existing_todo` | PASSED | UseCase 単体 |
+| `test_list_todos_use_case_returns_all_items` | PASSED | UseCase 単体 |
+| `test_complete_todo_use_case_marks_done` | PASSED | UseCase 単体 |
+| `test_list_todos_returns_paginated` | PASSED | HTTP 統合 |
+| `test_get_todo_returns_200` | PASSED | HTTP 統合 |
+| `test_get_nonexistent_todo_returns_404` | PASSED | HTTP 統合 |
+| `test_create_todo_returns_201` | PASSED | HTTP 統合 |
+| `test_create_todo_with_blank_title_returns_422` | PASSED | HTTP 統合 |
+| `test_complete_todo_marks_done` | PASSED | HTTP 統合 |
+| `test_complete_nonexistent_todo_returns_404` | PASSED | HTTP 統合 |
+| `test_list_todos_pagination_offset` | PASSED | HTTP 統合 |
+| `test_request_id_header_present` | PASSED | HTTP 統合 |
+| `test_in_memory_repo_used_for_unit_tests_without_db` | PASSED | DI 注入 |
+
+---
+
+## Friction Points
+
+なし。
+
+**特筆点**:
+- `ValidationException` を UseCase 内（ドメイン層）で raise しても、
+  `ErrorHandlerMiddleware` が自動で 422 Problem Details に変換する。
+  ドメイン層が HTTP を知らなくてよい。
+- `create_app(repository=InMemoryTodoRepository(...))` の DI 注入パターンで
+  HTTP テストも DB なしで実行できる。5 つの UseCase 単体テストは完全に DB 非依存。
+- `UseCaseProtocol[I, O]` の静的型チェックは `isinstance()` ではなく型注釈で行う。
+  `def _assert_protocols() -> None: _: UseCaseProtocol[...] = SomeUseCase(...)` のパターンで
+  mypy が protocol 適合を静的に保証する。
+- `InMemoryTodoRepository` の `mark_done()` 実装で `done=True` に更新するため
+  リスト全体を再構築するパターン（frozen dataclass なので in-place 変更不可）が自然に強制される。
+
+---
+
+## 結論
+
+`UseCaseProtocol` + `Repository Interface` + `InMemoryRepository` の三点セットで
+NENE2 の完全レイヤードアーキテクチャが機能する。
+UseCase 単体テスト（DB なし）と HTTP 統合テスト（SQLAlchemy 経由）を
+同一 `create_app()` ファクトリで切り替えられる DI パターンが特に有用。

nene2_python-1.8.20/docs/field-trials/2026-05-field-trial-72.md

@@ -0,0 +1,72 @@
+# FT72: DatabaseIntegrityException + write() 戻り値パターン実運用検証
+
+**日付**: 2026-05-20  
+**テーマ**: ユニーク制約違反 (409) と UPDATE/DELETE の rowcount=0 (404) パターン検証  
+**バージョン**: v1.8.19  
+**FTディレクトリ**: `/home/xi/docker/nene2-python-FT/ft72-db-integrity/`
+
+---
+
+## 概要
+
+ユーザー登録 API でユニーク制約違反 → `DatabaseIntegrityException` → 409 のマッピングと、
+`write()` 戻り値 0 を使った UPDATE/DELETE の「対象なし → 404」パターンを実運用で検証した。
+あわせて `request_validation_error_handler` による Pydantic 422 → nene2 形式変換も確認した。
+
+---
+
+## 実装内容
+
+- `users` テーブル（`username UNIQUE`, `email UNIQUE`）
+- `POST /users` — INSERT、重複時 `DatabaseIntegrityException` → 409
+- `GET /users/{id}` — 存在しない場合 404
+- `PUT /users/{id}/email` — UPDATE、`write()` 戻り値 0 → 404
+- `DELETE /users/{id}` — DELETE、`write()` 戻り値 0 → 404、成功時 204
+- `SimpleDomainHandler(DatabaseIntegrityException, "user-conflict", "Conflict", 409)` で自動変換
+- `app.add_exception_handler(RequestValidationError, request_validation_error_handler)` で Pydantic 422 形式統一
+
+---
+
+## テスト結果
+
+**11/11 passed**
+
+| テスト | 結果 |
+|---|---|
+| `test_register_user_returns_201` | PASSED |
+| `test_register_duplicate_username_returns_409` | PASSED |
+| `test_register_duplicate_email_returns_409` | PASSED |
+| `test_get_user_returns_200` | PASSED |
+| `test_get_nonexistent_user_returns_404` | PASSED |
+| `test_update_email_returns_200` | PASSED |
+| `test_update_email_for_nonexistent_user_returns_404` | PASSED |
+| `test_update_to_duplicate_email_returns_409` | PASSED |
+| `test_delete_user_returns_204` | PASSED |
+| `test_delete_nonexistent_user_returns_404` | PASSED |
+| `test_register_invalid_body_returns_422_nene2_format` | PASSED |
+
+---
+
+## Friction Points
+
+なし。
+
+**特筆点**:
+- `SimpleDomainHandler(DatabaseIntegrityException, ...)` で SQLAlchemy の IntegrityError を
+  透過的に 409 に変換できる。ハンドラー側のコードに `try/except` が不要。
+- `write()` の戻り値セマンティクス（UPDATE/DELETE は rowcount、INSERT は lastrowid）により、
+  `if affected == 0: return 404` パターンが自然に書ける。
+- `JSONResponse(None, status_code=204)` が 204 No Content として正しく動作する。
+- `request_validation_error_handler` を `add_exception_handler(RequestValidationError, ...)` で
+  登録することで、Pydantic の 422 バリデーションエラーも nene2 の `validation-failed`
+  Problem Details 形式に統一できる。`ErrorHandlerMiddleware` だけではこのケースをカバーできないため、
+  完全な 422 形式統一には両方の登録が必要。
+
+---
+
+## 結論
+
+`DatabaseIntegrityException` は `SimpleDomainHandler` で宣言的に 409 にマッピングでき、
+`write()` の 0 戻り値で UPDATE/DELETE の「対象なし → 404」も慣用的に書ける。
+Pydantic バリデーション 422 の形式統一には `request_validation_error_handler` の追加登録が必要な点は
+覚えておく価値がある。

{nene2_python-1.8.18 → nene2_python-1.8.20}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nene2-python"
-version = "1.8.18"
+version = "1.8.20"
 description = "NENE2 Python — minimal API framework following NENE2's design philosophy"
 readme = "README.md"
 license = {text = "MIT"}

{nene2_python-1.8.18 → nene2_python-1.8.20}/src/nene2/http/problem_details.py

@@ -60,6 +60,19 @@ def problem_details_response(
 ) -> JSONResponse:
     """Build an RFC 9457 Problem Details JSON response.
 
+    Args:
+        problem_type: Short identifier appended to ``base_url`` for the ``type`` URI.
+        title:        Human-readable summary of the error.
+        status:       HTTP status code.
+        detail:       Optional human-readable explanation.
+        extra:        Additional fields merged **at the top level** of the response body
+                      (RFC 9457 extension members).  They are NOT nested under an
+                      ``"extra"`` key.  For example, ``extra={"item_id": 42}`` produces
+                      ``{"type": "...", "status": 404, "item_id": 42}``.
+                      Raises ``ValueError`` if any key shadows a reserved field
+                      (``type``, ``title``, ``status``, ``detail``).
+        base_url:     Override the base URL for this call only.
+
     ``base_url`` resolution order:
     1. Explicit ``base_url`` argument
     2. Value set by :func:`configure_problem_details`

{nene2_python-1.8.18 → nene2_python-1.8.20}/src/nene2/middleware/domain_exception.py

@@ -35,8 +35,11 @@ class SimpleDomainHandler:
         ]
         app.add_middleware(ErrorHandlerMiddleware, domain_handlers=handlers)
 
-    When you need a dynamic ``detail`` or ``extra`` fields derived from the exception,
-    pass an ``extra_factory`` callable::
+    When you need a dynamic ``detail`` or extra fields derived from the exception,
+    pass an ``extra_factory`` callable.  The dict returned by ``extra_factory`` is merged
+    **at the top level** of the Problem Details response (RFC 9457 extension members) —
+    the keys appear directly alongside ``type``, ``title``, etc., NOT nested under
+    an ``"extra"`` key::
 
         SimpleDomainHandler(
             PostNotFoundError,
@@ -46,6 +49,8 @@ class SimpleDomainHandler:
             detail_factory=lambda exc: str(exc),
             extra_factory=lambda exc: {"post_id": exc.post_id},
         )
+        # Response: {"type": "...", "status": 404, ..., "post_id": 123}
+        #       NOT: {"type": "...", ..., "extra": {"post_id": 123}}
     """
 
     def __init__(

{nene2_python-1.8.18 → nene2_python-1.8.20}/src/nene2/middleware/error_handler.py

@@ -11,6 +11,7 @@ from typing import Any
 from fastapi import Request
 from fastapi.exceptions import RequestValidationError
 from fastapi.responses import JSONResponse
+from starlette.applications import Starlette
 from starlette.middleware.base import BaseHTTPMiddleware, RequestResponseEndpoint
 from starlette.responses import Response
 
@@ -32,7 +33,20 @@ logger = logging.getLogger(__name__)
 
 
 class ErrorHandlerMiddleware(BaseHTTPMiddleware):
-    """Catch-all error handler that maps exceptions to Problem Details responses."""
+    """Catch-all error handler that maps exceptions to Problem Details responses.
+
+    **Recommended usage** — use :meth:`install` instead of ``add_middleware`` directly.
+    ``install`` also registers ``request_validation_error_handler`` so that
+    FastAPI's Pydantic validation errors (422) are formatted as nene2 Problem Details::
+
+        ErrorHandlerMiddleware.install(app)
+        # Equivalent to:
+        #   app.add_middleware(ErrorHandlerMiddleware)
+        #   app.add_exception_handler(RequestValidationError, request_validation_error_handler)
+
+    Using ``add_middleware`` directly works, but FastAPI's ``RequestValidationError``
+    will be returned in Pydantic's default format rather than nene2 Problem Details.
+    """
 
     def __init__(
         self,
@@ -45,6 +59,35 @@ class ErrorHandlerMiddleware(BaseHTTPMiddleware):
         self.debug = debug
         self._domain_handlers: list[DomainExceptionHandlerProtocol] = domain_handlers or []
 
+    @classmethod
+    def install(
+        cls,
+        app: object,
+        *,
+        debug: bool = False,
+        domain_handlers: list[DomainExceptionHandlerProtocol] | None = None,
+    ) -> None:
+        """Add this middleware and register the nene2 validation error handler.
+
+        Registers both ``ErrorHandlerMiddleware`` and ``request_validation_error_handler``
+        so that all 422 responses (Pydantic body validation and ``ValidationException``)
+        are formatted as nene2 Problem Details::
+
+            from nene2.middleware import ErrorHandlerMiddleware
+
+            app = FastAPI()
+            ErrorHandlerMiddleware.install(app)
+
+        Equivalent to::
+
+            app.add_middleware(ErrorHandlerMiddleware, debug=debug, domain_handlers=domain_handlers)
+            app.add_exception_handler(RequestValidationError, request_validation_error_handler)
+        """
+        if not isinstance(app, Starlette):
+            raise TypeError(f"app must be a Starlette/FastAPI instance, got {type(app)!r}")
+        app.add_middleware(cls, debug=debug, domain_handlers=domain_handlers)
+        app.add_exception_handler(RequestValidationError, request_validation_error_handler)
+
     async def dispatch(self, request: Request, call_next: RequestResponseEndpoint) -> Response:
         try:
             return await call_next(request)

{nene2_python-1.8.18 → nene2_python-1.8.20}/tests/nene2/middleware/test_error_handler.py

@@ -1,5 +1,6 @@
 """Tests for ErrorHandlerMiddleware."""
 
+import pytest
 from fastapi import FastAPI
 from fastapi.exceptions import RequestValidationError
 from fastapi.responses import JSONResponse
@@ -127,3 +128,42 @@ def test_pydantic_validation_error_field_names_are_extracted() -> None:
     assert r.status_code == 422
     fields = [e["field"] for e in r.json()["errors"]]
     assert "rating" in fields
+
+
+def _make_app_via_install() -> FastAPI:
+    class _Body(BaseModel):
+        score: int = Field(ge=0, le=100)
+
+    app = FastAPI()
+    ErrorHandlerMiddleware.install(app)
+
+    @app.post("/scores")
+    async def create_score(body: _Body) -> JSONResponse:
+        return JSONResponse({"score": body.score})
+
+    @app.get("/boom")
+    async def boom() -> JSONResponse:
+        raise RuntimeError("error via install")
+
+    return app
+
+
+def test_install_registers_both_middleware_and_validation_handler() -> None:
+    client = TestClient(_make_app_via_install(), raise_server_exceptions=False)
+    r = client.post("/scores", json={"score": 999})
+    assert r.status_code == 422
+    body = r.json()
+    assert body["type"].endswith("validation-failed")
+    assert "errors" in body
+
+
+def test_install_middleware_still_catches_runtime_errors() -> None:
+    client = TestClient(_make_app_via_install(), raise_server_exceptions=False)
+    r = client.get("/boom")
+    assert r.status_code == 500
+    assert r.json()["type"].endswith("internal-server-error")
+
+
+def test_install_raises_type_error_for_non_starlette_app() -> None:
+    with pytest.raises(TypeError, match="Starlette/FastAPI"):
+        ErrorHandlerMiddleware.install(object())

{nene2_python-1.8.18 → nene2_python-1.8.20}/uv.lock

@@ -925,7 +925,7 @@ wheels = [
 
 [[package]]
 name = "nene2-python"
-version = "1.8.18"
+version = "1.8.20"
 source = { editable = "." }
 dependencies = [
     { name = "alembic" },