nene2-python 1.8.13__tar.gz → 1.8.15__tar.gz

{nene2_python-1.8.13 → nene2_python-1.8.15}/CHANGELOG.md

@@ -5,6 +5,24 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ---
 
+## [1.8.15] — 2026-05-20
+
+FT55 フィールドトライアル — parse_db_datetime 実運用検証。
+
+### Added
+- Field trial report: `docs/field-trials/2026-05-field-trial-55.md`
+
+---
+
+## [1.8.14] — 2026-05-20
+
+FT54 フィールドトライアル — RequestSizeLimitMiddleware + path_limits 実運用検証。
+
+### Added
+- Field trial report: `docs/field-trials/2026-05-field-trial-54.md`
+
+---
+
 ## [1.8.13] — 2026-05-20
 
 FT53 フィールドトライアル — ApiKeyAuthMiddleware 実運用検証 + header_name パラメータ追加。

{nene2_python-1.8.13 → nene2_python-1.8.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nene2-python
-Version: 1.8.13
+Version: 1.8.15
 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.15/docs/field-trials/2026-05-field-trial-54.md

@@ -0,0 +1,71 @@
+# Field Trial 54: RequestSizeLimitMiddleware + path_limits 実運用検証
+
+**Date**: 2026-05-20
+**Theme**: `RequestSizeLimitMiddleware` + `path_limits` の実運用パターン検証
+**Version under test**: v1.8.13
+**FT App**: `/home/xi/docker/nene2-python-FT/ft54-size-limit/`
+
+---
+
+## 概要
+
+ファイルアップロード API で `RequestSizeLimitMiddleware` の `path_limits` を使い、
+エンドポイントごとに異なるサイズ上限を設定した。
+
+---
+
+## 実装内容
+
+```python
+app.add_middleware(
+    RequestSizeLimitMiddleware,
+    max_bytes=10 * KB,          # デフォルト: 10KB
+    path_limits={
+        "/upload/avatar":   50 * KB,   # プロフィール画像
+        "/upload/document": 200 * KB,  # ドキュメント
+    },
+    exclude_paths=["/health"],
+)
+```
+
+`path_limits` の値はデフォルト `max_bytes` を上書きする。
+`/upload/avatar` は `10KB` 超過でも `50KB` 以下なら受け入れる。
+
+---
+
+## テスト結果
+
+9 tests, all passed.
+
+| テスト | 結果 |
+|---|---|
+| /health は除外 | ✅ |
+| /data の 5KB はデフォルト内 | ✅ |
+| /data の 11KB がデフォルト超過 → 413 | ✅ |
+| 413 が Problem Details 形式 (max_bytes フィールド含む) | ✅ |
+| /upload/avatar の 40KB は path_limits 内 | ✅ |
+| /upload/avatar の 51KB が path_limits 超過 → 413 | ✅ |
+| /upload/document の 150KB は path_limits 内 | ✅ |
+| /upload/document の 201KB が path_limits 超過 → 413 | ✅ |
+| path_limits がデフォルトを上書きすることを確認 | ✅ |
+
+---
+
+## 摩擦ポイント
+
+摩擦なし。`path_limits` の設定は直感的で期待通りに動作した。
+
+413 レスポンスに `max_bytes` フィールドが含まれるため、クライアントが上限値を把握できる。
+
+---
+
+## フレームワーク変更
+
+なし。
+
+---
+
+## 結論
+
+`RequestSizeLimitMiddleware` の `path_limits` はファイルアップロード API の実運用で
+摩擦なく使える。デフォルト + パスごとのオーバーライドという設計が直感的。

nene2_python-1.8.15/docs/field-trials/2026-05-field-trial-55.md

@@ -0,0 +1,65 @@
+# Field Trial 55: parse_db_datetime 実運用検証
+
+**Date**: 2026-05-20
+**Theme**: `nene2.database.utils.parse_db_datetime` の実運用パターン検証
+**Version under test**: v1.8.14
+**FT App**: `/home/xi/docker/nene2-python-FT/ft55-parse-datetime/`
+
+---
+
+## 概要
+
+SQLite に DATETIME 値を保存・読み出しし、`parse_db_datetime` で UTC-aware datetime に
+変換するパターンをイベント管理 API で実運用した。
+
+---
+
+## 実装内容
+
+```python
+from nene2.database.utils import parse_db_datetime
+
+event = Event(
+    id=row[0],
+    title=row[1],
+    scheduled_at=parse_db_datetime(row[2]),  # SQLite 文字列 → UTC-aware datetime
+)
+```
+
+SQLite は DATETIME を `"2026-06-01 12:00:00"` のような文字列で返すが、
+`parse_db_datetime` が透過的に UTC-aware `datetime` に変換する。
+
+---
+
+## テスト結果
+
+7 tests, all passed.
+
+| テスト | 結果 |
+|---|---|
+| イベント作成・取得 | ✅ |
+| UTC-aware datetime で返ること | ✅ |
+| SQLite 文字列形式の変換 (`"2026-06-01 12:00:00"`) | ✅ |
+| MySQL 形式の naive datetime を UTC-aware に変換 | ✅ |
+| すでに timezone-aware な datetime は保持 | ✅ |
+| ISO 8601 の T 区切り形式のサポート | ✅ |
+| 存在しないイベントで 404 | ✅ |
+
+---
+
+## 摩擦ポイント
+
+摩擦なし。`parse_db_datetime` の API は直感的で、SQLite / MySQL の差異を透過的に吸収する。
+
+---
+
+## フレームワーク変更
+
+なし。
+
+---
+
+## 結論
+
+`parse_db_datetime` は SQLite (文字列) と MySQL (naive datetime) の両方を透過的に処理し、
+常に UTC-aware `datetime` を返す。実運用で摩擦なく使える。

{nene2_python-1.8.13 → nene2_python-1.8.15}/pyproject.toml

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

{nene2_python-1.8.13 → nene2_python-1.8.15}/uv.lock

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