nene2-python 1.8.9__tar.gz → 1.8.11__tar.gz

{nene2_python-1.8.9 → nene2_python-1.8.11}/.github/workflows/ci.yml

@@ -47,4 +47,6 @@ jobs:
         run: uv run ruff format --check src/ tests/
 
       - name: pip-audit
-        run: uv run pip-audit
+        # PYSEC-2025-183: pyjwt weak-key-length — disputed by supplier, no fix version available.
+        # Transitive via mcp>=1.0. Re-evaluate when pyjwt releases a fix. (#280)
+        run: uv run pip-audit --ignore-vuln PYSEC-2025-183

{nene2_python-1.8.9 → nene2_python-1.8.11}/CHANGELOG.md

@@ -5,6 +5,27 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ---
 
+## [1.8.11] — 2026-05-20
+
+FT51 フィールドトライアル — SimpleDomainHandler 実運用検証 + problem_details_response バグ修正。
+
+### Fixed
+- `problem_details_response()` — `extra` に RFC 9457 予約済みフィールド (`type`, `title`, `status`, `detail`) が含まれる場合に `ValueError` を raise するよう修正 (#282) (FT51)
+
+### Added
+- Field trial report: `docs/field-trials/2026-05-field-trial-51.md`
+
+---
+
+## [1.8.10] — 2026-05-20
+
+FT50 フィールドトライアル — ValidationException + ValidationCode(StrEnum) 実運用検証。
+
+### Added
+- Field trial report: `docs/field-trials/2026-05-field-trial-50.md`
+
+---
+
 ## [1.8.9] — 2026-05-20
 
 FT46〜FT49 フィールドトライアル — ドキュメント改善。

{nene2_python-1.8.9 → nene2_python-1.8.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nene2-python
-Version: 1.8.9
+Version: 1.8.11
 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.11/docs/field-trials/2026-05-field-trial-50.md

@@ -0,0 +1,108 @@
+# Field Trial 50: ValidationException + ValidationCode(StrEnum) 実運用検証
+
+**Date**: 2026-05-20
+**Theme**: `ValidationException` + `ValidationCode(StrEnum)` の実運用パターン検証
+**Version under test**: v1.8.9
+**FT App**: `/home/xi/docker/nene2-python-FT/ft50-validation/`
+
+---
+
+## 概要
+
+複数フィールドバリデーション (`ValidationException` + `ValidationError` リスト) と
+`ValidationCode(StrEnum)` による型安全なエラーコードの組み合わせを、
+商品作成 API で実運用した。
+
+---
+
+## 実装内容
+
+### `ProductCode(StrEnum)` によるエラーコード定義
+
+```python
+class ProductCode(StrEnum):
+    required = "required"
+    out_of_range = "out_of_range"
+    invalid_format = "invalid_format"
+    duplicate = "duplicate"
+```
+
+`StrEnum` を継承することで、エラーコードが静的解析で型チェックされる。
+レスポンスの `code` フィールドには文字列値（`"required"` 等）がそのまま出力される。
+
+### 複数フィールドバリデーション
+
+```python
+def validate_product(name: str, price: int, sku: str, stock: int) -> None:
+    errors: list[ValidationError] = []
+    if not name.strip():
+        errors.append(ValidationError("name", "Name is required.", ProductCode.required))
+    if price < 0:
+        errors.append(ValidationError("price", "Price must be non-negative.", ProductCode.out_of_range))
+    # ...
+    if errors:
+        raise ValidationException(errors)
+```
+
+エラーを収集してから一括で `raise ValidationException(errors)` するパターン。
+
+### 単一フィールド専用例外
+
+```python
+if body.sku in _existing_skus:
+    raise ValidationException.single("sku", f"SKU '{body.sku}' already exists.", ProductCode.duplicate)
+```
+
+`ValidationException.single()` classmethod で 1 行で単一エラーを raise できる。
+
+---
+
+## テスト結果
+
+12 tests, all passed.
+
+| テスト | 結果 |
+|---|---|
+| 正常系: 商品作成成功 | ✅ |
+| 単一フィールドエラー (price < 0) | ✅ |
+| 複数フィールドエラー | ✅ |
+| price 上限チェック (> 1,000,000) | ✅ |
+| SKU フォーマット検証 | ✅ |
+| 重複 SKU (ValidationException.single) | ✅ |
+| ValidationCode 値が文字列として返る | ✅ |
+| 422 Problem Details 構造確認 | ✅ |
+| StrEnum 値がレスポンスで文字列になる | ✅ |
+| message フィールドがレスポンスに含まれる | ✅ |
+| 同一フィールド複数エラー | ✅ |
+| エラーリストの順序が検証順と一致 | ✅ |
+
+---
+
+## 摩擦ポイント
+
+摩擦なし。以下の点がすべて期待通りに動作した:
+
+- **FP50-1 (確認済み)**: `ValidationCode(StrEnum)` の値はレスポンスの `code` フィールドに文字列として正しく出力される。`StrEnum` は `str` のサブクラスなので JSON シリアライズ時に文字列化される。
+- **FP50-2 (確認済み)**: `ValidationError` の `message` フィールドがレスポンスの各エラーオブジェクトに含まれる。
+- **FP50-3 (確認済み)**: 同一フィールドへの複数エラー収集は設計上サポートされており、正常に動作する。
+- **FP50-4 (確認済み)**: `ValidationException(errors)` はエラーリストの順序を保持する。
+
+---
+
+## フレームワーク変更
+
+なし。
+
+---
+
+## 結論
+
+`ValidationException` + `ValidationCode(StrEnum)` の組み合わせは実運用で摩擦なく使える。
+エラーコードを `StrEnum` で定義することで:
+
+1. IDE/mypy による型補完・チェックが得られる
+2. レスポンスには文字列値がそのまま出力される（追加設定不要）
+3. `validate_product()` 関数でエラーを収集して一括 raise するパターンが自然に書ける
+4. 単一フィールドの場合は `ValidationException.single()` で 1 行で済む
+
+API クライアントは `code` 文字列でエラー種別を判定できる。

nene2_python-1.8.11/docs/field-trials/2026-05-field-trial-51.md

@@ -0,0 +1,127 @@
+# Field Trial 51: SimpleDomainHandler 実運用検証
+
+**Date**: 2026-05-20
+**Theme**: `SimpleDomainHandler` + `detail_factory` / `extra_factory` の実運用パターン検証
+**Version under test**: v1.8.10
+**FT App**: `/home/xi/docker/nene2-python-FT/ft51-domain-handler/`
+
+---
+
+## 概要
+
+複数のドメイン例外を `SimpleDomainHandler` で Problem Details に変換するパターンを
+記事 API で実運用した。404 / 403 / 409 の 3 種類のエラーを検証。
+
+---
+
+## 実装内容
+
+### ドメイン例外クラス
+
+```python
+class ArticleNotFoundError(Exception):
+    def __init__(self, article_id: int) -> None:
+        self.article_id = article_id
+
+class ArticleAccessDeniedError(Exception):
+    def __init__(self, article_id: int, user_id: str) -> None:
+        self.article_id = article_id
+        self.user_id = user_id
+
+class ArticleTitleConflictError(Exception):
+    def __init__(self, title: str) -> None:
+        self.title = title
+```
+
+### SimpleDomainHandler による登録
+
+```python
+handlers = [
+    SimpleDomainHandler(
+        ArticleNotFoundError,
+        "article-not-found",
+        "Article Not Found",
+        404,
+        detail_factory=lambda exc: str(exc),
+        extra_factory=lambda exc: {"article_id": exc.article_id},
+    ),
+    SimpleDomainHandler(
+        ArticleAccessDeniedError,
+        "article-access-denied",
+        "Access Denied",
+        403,
+        detail_factory=lambda exc: str(exc),
+        extra_factory=lambda exc: {"article_id": exc.article_id, "user_id": exc.user_id},
+    ),
+    SimpleDomainHandler(
+        ArticleTitleConflictError,
+        "article-title-conflict",
+        "Article Title Conflict",
+        409,
+        detail_factory=lambda exc: str(exc),
+        extra_factory=lambda exc: {"article_title": exc.title},  # ← "title" ではなく "article_title"
+    ),
+]
+app.add_middleware(ErrorHandlerMiddleware, domain_handlers=handlers)
+```
+
+---
+
+## テスト結果
+
+6 tests, all passed (after fixing FP51-1).
+
+---
+
+## 摩擦ポイント
+
+### FP51-1: `extra_factory` に `title` キーを返すと Problem Details の `title` が上書きされる
+
+**状況**: `ArticleTitleConflictError` の `extra_factory` で `{"title": exc.title}` を返したところ、
+Problem Details レスポンスの `title` フィールド（`"Article Title Conflict"`）が `exc.title`（`"Dup"`）に
+上書きされた。
+
+```json
+{
+  "type": "...",
+  "title": "Dup",      // ← "Article Title Conflict" のはずが上書きされた
+  "status": 409,
+  "detail": "Article with title 'Dup' already exists"
+}
+```
+
+**原因**: `problem_details_response()` が `body.update(extra)` で `extra` を後から適用するため、
+RFC 9457 の予約済みフィールド (`type`, `title`, `status`, `detail`) を含む `extra` が
+意図せずフィールドを上書きする。
+
+**修正**: `problem_details_response()` が `extra` に予約済みフィールドが含まれている場合に
+`ValueError` を raise するよう修正 (#282)。
+
+```python
+# 修正後のコード
+_RESERVED_FIELDS = frozenset({"type", "title", "status", "detail"})
+if extra:
+    overlap = _RESERVED_FIELDS & extra.keys()
+    if overlap:
+        raise ValueError(f"extra contains reserved Problem Details fields: {sorted(overlap)}")
+    body.update(extra)
+```
+
+**ワークアラウンド（修正前）**: `extra` に予約済みキーと衝突しない名前を使う（例: `"article_title"`）。
+
+---
+
+## フレームワーク変更
+
+### `nene2.http.problem_details_response()` — extra reserved fields 保護 (#282)
+
+`extra` に RFC 9457 予約済みフィールド (`type`, `title`, `status`, `detail`) が含まれる場合に
+`ValueError` を raise するようになった。
+
+---
+
+## 結論
+
+`SimpleDomainHandler` + `detail_factory` / `extra_factory` の組み合わせは実運用で使いやすい。
+ただし `extra_factory` の返り値に RFC 9457 予約済みフィールドと同名のキーを入れると
+サイレントに上書きされる危険があった。`ValueError` による早期検知で問題を防止できる。

{nene2_python-1.8.9 → nene2_python-1.8.11}/pyproject.toml

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

{nene2_python-1.8.9 → nene2_python-1.8.11}/src/nene2/http/problem_details.py

@@ -8,6 +8,7 @@ from typing import Any
 from fastapi.responses import JSONResponse
 
 PROBLEM_DETAILS_BASE_URL = "https://nene2.dev/problems/"
+_RESERVED_FIELDS = frozenset({"type", "title", "status", "detail"})
 
 _configured_base_url: str | None = None
 
@@ -73,6 +74,9 @@ def problem_details_response(
     if detail:
         body["detail"] = detail
     if extra:
+        overlap = _RESERVED_FIELDS & extra.keys()
+        if overlap:
+            raise ValueError(f"extra contains reserved Problem Details fields: {sorted(overlap)}")
         body.update(extra)
 
     return JSONResponse(

{nene2_python-1.8.9 → nene2_python-1.8.11}/tests/nene2/http/test_problem_details.py

@@ -74,3 +74,18 @@ def test_reset_problem_details_is_idempotent() -> None:
     reset_problem_details()
     r = problem_details_response("not-found", "Not Found", 404)
     assert b"nene2.dev/problems/not-found" in r.body
+
+
+def test_extra_with_reserved_field_raises_value_error() -> None:
+    with pytest.raises(ValueError, match="reserved Problem Details fields"):
+        problem_details_response("x", "X", 400, extra={"title": "bad"})
+
+
+def test_extra_with_type_reserved_raises_value_error() -> None:
+    with pytest.raises(ValueError, match="reserved Problem Details fields"):
+        problem_details_response("x", "X", 400, extra={"type": "overridden"})
+
+
+def test_extra_with_status_reserved_raises_value_error() -> None:
+    with pytest.raises(ValueError, match="reserved Problem Details fields"):
+        problem_details_response("x", "X", 400, extra={"status": 500})

{nene2_python-1.8.9 → nene2_python-1.8.11}/uv.lock

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