nene2-python 1.8.163__tar.gz → 1.8.164__tar.gz

{nene2_python-1.8.163 → nene2_python-1.8.164}/.github/workflows/ci.yml

@@ -51,6 +51,54 @@ jobs:
         # Transitive via mcp>=1.0. Re-evaluate when pyjwt releases a fix. (#280)
         run: uv run pip-audit --ignore-vuln PYSEC-2025-183
 
+  integration-db:
+    name: Real-DB integration tests
+    runs-on: ubuntu-latest
+    # 実 PostgreSQL / MySQL に対してリポジトリ層を検証する（#747）。
+    # SQLite だけでは露見しなかった lastrowid 由来の採番バグを CI で恒常的に防ぐ。
+    services:
+      postgres:
+        image: postgres:16-alpine
+        env:
+          POSTGRES_PASSWORD: nene2
+          POSTGRES_DB: nene2_test
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd "pg_isready -U postgres"
+          --health-interval 5s --health-timeout 5s --health-retries 10
+      mysql:
+        image: mysql:8
+        env:
+          MYSQL_ROOT_PASSWORD: nene2
+          MYSQL_DATABASE: nene2_test
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd "mysqladmin ping -uroot -pnene2"
+          --health-interval 5s --health-timeout 5s --health-retries 20
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.14
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: integration tests (PostgreSQL + MySQL)
+        env:
+          NENE2_TEST_POSTGRES_URL: postgresql+psycopg2://postgres:nene2@127.0.0.1:5432/nene2_test
+          NENE2_TEST_MYSQL_URL: mysql+pymysql://root:nene2@127.0.0.1:3306/nene2_test
+        run: uv run pytest tests/integration/ -v --no-cov
+
   package-build:
     name: Package build verification
     runs-on: ubuntu-latest

{nene2_python-1.8.163 → nene2_python-1.8.164}/CHANGELOG.md

@@ -8,6 +8,27 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ---
 
+## [1.8.164] — 2026-05-29
+
+実データベース（PostgreSQL / MySQL）統合テストを追加し、マルチDB対応を実測で検証 (#747)。
+
+### Fixed
+- `SqlAlchemyQueryExecutor.write()` / `_BoundQueryExecutor.write()` の INSERT 採番を
+  全方言で正しく返すよう修正。psycopg2 は `lastrowid` 非対応のため、PostgreSQL では
+  `lastval()` フォールバックを使う（従来は `rowcount` を返し、`save()` が常に `1` を
+  返す重大バグだった）。SQLite / MySQL は従来どおり `lastrowid`。
+
+### Added
+- 実DB統合テスト `tests/integration/`（PostgreSQL / MySQL）。環境変数
+  `NENE2_TEST_POSTGRES_URL` / `NENE2_TEST_MYSQL_URL` 設定時のみ実行、未設定ならスキップ。
+  スキーマは SQLAlchemy `Table` から方言非依存に生成。
+- CI に `integration-db` ジョブ（postgres:16 / mysql:8 service container）を追加。
+- how-to [`run-integration-tests.md`](docs/how-to/run-integration-tests.md)（EN/JA）を追加。
+- `pymysql` を dev 依存に追加（`mysql+pymysql://` ドライバが未導入だった）。
+
+### Changed
+- リリース手順 how-to を「公開済み」の現実に合わせて訂正（#541 の事後整合）。
+
 ## [1.8.163] — 2026-05-29
 
 v1.8.35〜v1.8.163 の集約リリース。フィールドトライアル網羅スイープの完了と、

{nene2_python-1.8.163 → nene2_python-1.8.164}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nene2-python
-Version: 1.8.163
+Version: 1.8.164
 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.163 → nene2_python-1.8.164}/docs/how-to/release-and-publish.md

@@ -5,21 +5,22 @@ automated publish (TestPyPI → PyPI → GitHub Release)**. The automation lives
 [`.github/workflows/publish.yml`](../../.github/workflows/publish.yml) and triggers
 on `v*` tags via **PyPI Trusted Publishing** (OIDC — no long-lived tokens).
 
-## One-time setup (maintainer, cannot be automated)
+## One-time setup (maintainer — already done)
 
-The publish workflow uses Trusted Publishing and GitHub Environments. These must be
-configured once on the PyPI side and in the repo settings:
+The publish workflow uses Trusted Publishing and GitHub Environments. This is
+**already configured** and operational; it is recorded here for reference and
+recovery:
 
 1. **PyPI / TestPyPI — Trusted Publisher** for `nene2-python`:
    - Owner: `hideyukiMORI`, Repository: `nene2-python`
    - Workflow: `publish.yml`
    - Environment: `pypi` (on pypi.org) and `testpypi` (on test.pypi.org)
-   - Register at https://pypi.org/manage/account/publishing/ and the TestPyPI equivalent.
-2. **GitHub repo → Settings → Environments**: create `testpypi` and `pypi`
-   (optionally add required reviewers on `pypi` for a manual approval gate).
+   - Registered at https://pypi.org/manage/account/publishing/ and the TestPyPI equivalent.
+2. **GitHub repo → Settings → Environments**: `testpypi` and `pypi` exist
+   (add required reviewers on `pypi` for a manual approval gate if desired).
 
-Until step 1 is done, `pip install nene2-python` is unavailable — the package has
-never been published (the FT sandboxes install it from the local wheel / `git+`).
+The package is **published** — `pip install nene2-python` installs the latest
+release (v1.8.163+) directly from PyPI.
 
 ## Release procedure (per release)
 
@@ -67,5 +68,5 @@ excluded by `[tool.hatch.build.targets.wheel] packages = ["src/nene2"]`).
   [`docs/todo/current.md`](../todo/current.md) milestone table; `CHANGELOG.md`
   records release-grained aggregated entries.
 - This procedure corresponds to the **FT7-class "publish flow" trial** (#541): the
-  build is verified and the automation is in place; the only remaining step is the
-  maintainer's one-time Trusted Publishing setup followed by the first `v*` tag.
+  flow is fully operational — v1.8.163 was published to PyPI through it and is
+  installable via `pip install nene2-python`.

nene2_python-1.8.164/docs/how-to/run-integration-tests.md

@@ -0,0 +1,51 @@
+# How to run the real-database integration tests
+
+The default `uv run pytest` runs against SQLite / in-memory only — fast and
+dependency-free. A separate suite under `tests/integration/` exercises the
+repository layer against **real PostgreSQL and MySQL** servers, the dialects the
+framework claims to support. These tests **skip** unless the corresponding URL
+env var is set, so they never slow down the default run.
+
+## Run locally with Docker
+
+Start throwaway databases:
+
+```bash
+docker run -d --name nene2-pg -e POSTGRES_PASSWORD=nene2 -e POSTGRES_DB=nene2_test \
+  -p 5432:5432 postgres:16-alpine
+docker run -d --name nene2-mysql -e MYSQL_ROOT_PASSWORD=nene2 -e MYSQL_DATABASE=nene2_test \
+  -p 3306:3306 mysql:8
+```
+
+Point the suite at them and run:
+
+```bash
+export NENE2_TEST_POSTGRES_URL="postgresql+psycopg2://postgres:nene2@127.0.0.1:5432/nene2_test"
+export NENE2_TEST_MYSQL_URL="mysql+pymysql://root:nene2@127.0.0.1:3306/nene2_test"
+uv run pytest tests/integration/ -v --no-cov
+```
+
+Set only one variable to test a single backend. With neither set, the suite is
+skipped.
+
+Tear down when finished:
+
+```bash
+docker rm -f nene2-pg nene2-mysql
+```
+
+## In CI
+
+The `integration-db` job in [`.github/workflows/ci.yml`](../../.github/workflows/ci.yml)
+provides PostgreSQL and MySQL as service containers and runs this suite on every
+push and PR — so dialect-specific regressions (e.g. PostgreSQL's lack of
+`lastrowid`, which once made `save()` return the wrong PK, #747) are caught
+automatically.
+
+## How the schema is created
+
+The fixture builds the schema from a SQLAlchemy `Table` definition
+(`tests/integration/conftest.py`), so the same `Integer` autoincrement primary
+key becomes `SERIAL` on PostgreSQL, `AUTO_INCREMENT` on MySQL, and `AUTOINCREMENT`
+on SQLite — no hand-written per-dialect DDL. Each test gets a freshly created and
+dropped table.

{nene2_python-1.8.163 → nene2_python-1.8.164}/docs/ja/how-to/release-and-publish.md

@@ -5,21 +5,21 @@
 [`.github/workflows/publish.yml`](../../../.github/workflows/publish.yml) にあり、
 `v*` タグを契機に **PyPI Trusted Publishing**（OIDC・長期トークン不要）で動く。
 
-## 一度だけの設定（メンテナ作業・自動化不可）
+## 一度だけの設定（メンテナ作業・設定済み）
 
-publish ワークフローは Trusted Publishing と GitHub Environments を使う。PyPI 側と
-リポジトリ設定で一度だけ構成する必要がある:
+publish ワークフローは Trusted Publishing と GitHub Environments を使う。これは
+**既に構成済み・稼働中**で、参照・復旧用に記録する:
 
 1. **PyPI / TestPyPI の Trusted Publisher**（`nene2-python`）:
    - Owner: `hideyukiMORI`、Repository: `nene2-python`
    - Workflow: `publish.yml`
    - Environment: `pypi`（pypi.org）と `testpypi`（test.pypi.org）
-   - https://pypi.org/manage/account/publishing/ と TestPyPI の同等画面で登録。
-2. **GitHub repo → Settings → Environments**: `testpypi` と `pypi` を作成
+   - https://pypi.org/manage/account/publishing/ と TestPyPI の同等画面で登録済み。
+2. **GitHub repo → Settings → Environments**: `testpypi` と `pypi` 作成済み
    （`pypi` に必須レビュアーを設定すれば手動承認ゲートになる）。
 
-手順 1 が未了の間は `pip install nene2-python` は不可（未公開。FT サンドボックスは
-ローカル wheel / `git+` で導入している）。
+パッケージは**公開済み**で、`pip install nene2-python` で最新リリース（v1.8.163 以降）
+を PyPI から直接取得できる。
 
 ## リリース手順（毎回）
 
@@ -64,6 +64,5 @@ import 可能、配布物は `src/nene2` のみ（`example`/`tests` は
 - **CHANGELOG の粒度**: 版ごとの一行サマリーは
   [`docs/todo/current.md`](../../todo/current.md) のマイルストーン表に、
   `CHANGELOG.md` にはリリース粒度の集約エントリを記録する。
-- 本手順は **FT7 相当の「公開フロー」トライアル**（#541）に対応する。ビルドは検証済み・
-  自動化は整備済みで、残るはメンテナによる一度きりの Trusted Publishing 設定と
-  最初の `v*` タグ作成のみ。
+- 本手順は **FT7 相当の「公開フロー」トライアル**（#541）に対応する。フローは完全稼働済みで、
+  v1.8.163 を本フローで PyPI に公開済み（`pip install nene2-python` で取得可能）。

nene2_python-1.8.164/docs/ja/how-to/run-integration-tests.md

@@ -0,0 +1,48 @@
+# 実データベース統合テストの実行方法
+
+デフォルトの `uv run pytest` は SQLite / インメモリのみを対象とし、高速で外部依存が
+ない。`tests/integration/` 配下の別スイートは、フレームワークが対応を謳う方言である
+**実 PostgreSQL / MySQL** に対してリポジトリ層を検証する。これらは対応する URL の
+環境変数が設定されている時だけ実行され、未設定なら**スキップ**される — デフォルトの
+実行を遅くしない。
+
+## Docker でローカル実行
+
+捨てDBを起動:
+
+```bash
+docker run -d --name nene2-pg -e POSTGRES_PASSWORD=nene2 -e POSTGRES_DB=nene2_test \
+  -p 5432:5432 postgres:16-alpine
+docker run -d --name nene2-mysql -e MYSQL_ROOT_PASSWORD=nene2 -e MYSQL_DATABASE=nene2_test \
+  -p 3306:3306 mysql:8
+```
+
+スイートを向けて実行:
+
+```bash
+export NENE2_TEST_POSTGRES_URL="postgresql+psycopg2://postgres:nene2@127.0.0.1:5432/nene2_test"
+export NENE2_TEST_MYSQL_URL="mysql+pymysql://root:nene2@127.0.0.1:3306/nene2_test"
+uv run pytest tests/integration/ -v --no-cov
+```
+
+片方だけ設定すれば単一バックエンドのみ検証。どちらも未設定ならスキップ。
+
+後始末:
+
+```bash
+docker rm -f nene2-pg nene2-mysql
+```
+
+## CI での実行
+
+[`.github/workflows/ci.yml`](../../../.github/workflows/ci.yml) の `integration-db`
+ジョブが PostgreSQL / MySQL を service container として提供し、push / PR ごとに本
+スイートを実行する。これにより方言固有のリグレッション（例: PostgreSQL は `lastrowid`
+を持たず、かつて `save()` が誤ったPKを返していた #747）が自動で検出される。
+
+## スキーマの作り方
+
+フィクスチャは SQLAlchemy の `Table` 定義（`tests/integration/conftest.py`）から
+スキーマを生成するため、同じ `Integer` autoincrement 主キーが PostgreSQL では
+`SERIAL`、MySQL では `AUTO_INCREMENT`、SQLite では `AUTOINCREMENT` になる — 方言別の
+手書きDDLは不要。各テストはテーブルを作成→破棄したクリーンな状態で走る。

{nene2_python-1.8.163 → nene2_python-1.8.164}/docs/roadmap.md

@@ -35,11 +35,11 @@ PHP 版 NENE2 との機能同等性を達成し、さらに Python 固有の強
 - Git タグ `v1.8.N` は選択的リリース時に付与（最新タグは [GitHub Releases](https://github.com/hideyukiMORI/nene2-python/releases) 参照）。FT ループ中は pyproject が先行することがある。
 
 ### 残課題（オープン Issue 含む）
-- ~~[#541](https://github.com/hideyukiMORI/nene2-python/issues/541) PyPI 公開フロー未検証~~ — ✅ v1.8.163 で検証（[手順](how-to/release-and-publish.md)）。実公開はメンテナの Trusted Publisher 設定 + `v*` タグ
+- ~~[#541](https://github.com/hideyukiMORI/nene2-python/issues/541) PyPI 公開フロー~~ — ✅ 稼働中。**v1.8.163 を PyPI 公開**（`pip install nene2-python`）。[手順](how-to/release-and-publish.md)
 - ~~[#553](https://github.com/hideyukiMORI/nene2-python/issues/553) example app に `/examples/ping`・`/examples/notes` を追加（parity）~~ — ✅ #578 で実装済み（既存確認の上 close）
 - ~~[#539](https://github.com/hideyukiMORI/nene2-python/issues/539) handler の `response_model` 統一~~ — ✅ v1.8.161 で解消
 - ~~[#540](https://github.com/hideyukiMORI/nene2-python/issues/540) FT ループの目的・終着点の明文化~~ — ✅ [field-trial-methodology.md](explanation/field-trial-methodology.md)
-- PostgreSQL / MySQL 実 DB 統合テスト（CI Docker service）
+- ~~[#747](https://github.com/hideyukiMORI/nene2-python/issues/747) PostgreSQL / MySQL 実 DB 統合テスト~~ — ✅ v1.8.164。CI service container で検証。psycopg2 lastrowid 非対応の採番バグを発見・修正。[手順](how-to/run-integration-tests.md)
 - 並行系 how-to — [concurrency-patterns.md](how-to/concurrency-patterns.md)（FT188–192 知見）
 - WebSocket サポート（検討中）
 - PyJWT 推移的 CVE（PYSEC-2025-183、mcp 経由）— CI で ignore、修正待ち
@@ -132,8 +132,8 @@ PHP 版追跡・Python 固有の強化:
 - [x] Diátaxis 構造のドキュメント整備（tutorial / howto / explanation / reference）(#43)
 - [x] Field Trial 1〜6: InMemory / SQLite / 認証 / MCP / トランザクション / AsyncUseCase 検証完了
 - [x] Field Trial 7〜282: stdlib フルカバレッジ + セキュリティ深掘りスイープ完了 → 保守 + オンデマンドへ（[方法論](explanation/field-trial-methodology.md)）
-- [x] PyPI 公開フロー検証（`uv publish` ワークフロー・ビルド検証・CHANGELOG/タグ連携、#541・[手順](how-to/release-and-publish.md)）— 実公開はメンテナの Trusted Publisher 設定待ち
-- [ ] PostgreSQL / MySQL 実 DB 統合テスト（CI Docker service ジョブ）
+- [x] PyPI 公開（#541）— フロー稼働中・**v1.8.163 公開済み**（`pip install nene2-python`）。[手順](how-to/release-and-publish.md)
+- [x] PostgreSQL / MySQL 実 DB 統合テスト（CI Docker service ジョブ、#747・v1.8.164）— [手順](how-to/run-integration-tests.md)
 - [ ] WebSocket サポート検討
 - [ ] 並行系 how-to ガイド（threading / asyncio / concurrent.futures 比較・選択指針）
 

{nene2_python-1.8.163 → nene2_python-1.8.164}/docs/todo/current.md

@@ -1,26 +1,29 @@
 # TODO — current
 
 最終更新: 2026-05-29
-現状: **v1.8.163 / #541（PyPI 公開フロー）検証 / CI グリーン**
+現状: **v1.8.164 / 実DB統合テスト導入・マルチDB対応を実測検証 / CI グリーン**
 
 ---
 
 ## 状態サマリー
 
-#541 に対応（v1.8.163）。公開フロー（`publish.yml`: build→TestPyPI→PyPI→GitHub Release・
-Trusted Publishing）は既存。本対応で**ビルドの公開準備を検証**し連携を確立した:
-- `uv build` の sdist/wheel が `twine check` PASSED、クリーン venv で import 可能、配布物は
-  `src/nene2` のみ（example/tests は混入しない）を確認
-- CI に `package-build` ジョブを追加（PR ごとに build + twine check + クリーン import を検証）
-- `CHANGELOG.md` が [1.8.34] で止まりリリースノートが空になる問題を、集約エントリ [1.8.163]
-  追加で解消（github-release ステップの抽出が動くことを確認）
-- リリース手順 how-to [`how-to/release-and-publish.md`](../how-to/release-and-publish.md)（EN/JA）を追加
-- **残: 実 PyPI 公開は不可逆でメンテナ作業** — PyPI/TestPyPI の Trusted Publisher 設定 +
-  GitHub Environments（testpypi/pypi）作成 + 最初の `v*` タグ。手順は how-to に記載。
-
-直前の対応: #540（FT ループ目的・終着点明文化・v1.8.162）、#539（response_model 統一・
+#747 に対応（v1.8.164）。「`sqlite/mysql/pgsql` 対応」という未検証の約束を実測で検証し、
+潜んでいたマルチDBバグを修正した:
+- **発見・修正**: `SqlAlchemyQueryExecutor.write()` の INSERT 採番が `result.lastrowid`
+  依存で、psycopg2（PostgreSQL）は lastrowid 非対応のため `rowcount`(=1) にフォールバック。
+  `save()` が常に `id=1` を返す重大バグだった → PostgreSQL では `lastval()` フォールバックに修正
+- **実DB統合テスト** `tests/integration/`（PostgreSQL/MySQL、各9ケース）を追加。環境変数
+  未設定ならskip（デフォルト `uv run pytest` は SQLite のまま高速：466 passed, 9 skipped）
+- **CI** に `integration-db` ジョブ（postgres:16 / mysql:8 service container）追加
+- `pymysql` を dev 依存に追加（`mysql+pymysql://` ドライバが未導入だった）
+- how-to [`run-integration-tests.md`](../how-to/run-integration-tests.md)（EN/JA）追加
+- ついでに #541 のリリース how-to の「未公開・メンテナ待ち」誤記（EN/JA）を訂正
+
+直前の対応: #541（PyPI 公開フロー解消・v1.8.163 を PyPI 公開）、#540（FT ループ目的・
+終着点明文化・v1.8.162）、#539（response_model 統一・
 v1.8.161）、#553（#578 で実装済みを確認し close）、ハウスキーピング（サンドボックス
-5.1G→79M 整理・orphan ブランチ 8 本削除）。**フレームワーク本体 466 tests 据え置き**。
+5.1G→79M 整理・orphan ブランチ 8 本削除）。**フレームワーク本体 466 tests 据え置き。
+オープン Issue ゼロ。**
 
 ---
 
@@ -32,11 +35,8 @@ v1.8.161）、#553（#578 で実装済みを確認し close）、ハウスキー
 
 ## オープン Issue
 
-| # | タイトル | 優先度 | 種別 |
-|---|---|---|---|
-| [#539](https://github.com/hideyukiMORI/nene2-python/issues/539) | handler の response_model を統一して CLAUDE.md ポリシーに準拠 | 中 | enhancement |
-| [#540](https://github.com/hideyukiMORI/nene2-python/issues/540) | FT ループの目的と終着点を明文化する | 中 | docs |
-| [#541](https://github.com/hideyukiMORI/nene2-python/issues/541) | PyPI 公開フロー検証（uv publish ワークフロー） | 中 | enhancement |
+なし（#539 / #540 / #541 / #553 はすべて 2026-05-29 に解消・close）。
+提案 PR #545（nene-style governance）のみ未マージで残置。
 
 ---
 
@@ -44,6 +44,7 @@ v1.8.161）、#553（#578 で実装済みを確認し close）、ハウスキー
 
 | バージョン | 主な内容 |
 |---|---|
+| v1.8.164 | feat: 実DB統合テスト（#747）— PostgreSQL/MySQL を CI service container で検証。psycopg2 lastrowid 非対応による INSERT 採番バグ（`save()` が常に id=1）を発見・修正。pymysql 追加 |
 | v1.8.163 | feat: PyPI 公開フロー検証（#541）— ビルド検証・CI package-build ジョブ・CHANGELOG 連携・リリース how-to |
 | v1.8.162 | docs: FT ループの目的・終着点を明文化（#540）— field-trial-methodology.md（EN/JA） |
 | v1.8.161 | fix: handler の response_model 統一（#539）— Note/Tag/Comment に Response モデル定義・OpenAPI スキーマ出力 |
@@ -153,9 +154,8 @@ v1.8.161）、#553（#578 で実装済みを確認し close）、ハウスキー
 
 | 優先度 | Issue | タスク | 種別 |
 |---|---|---|---|
-| 低 | [#541](https://github.com/hideyukiMORI/nene2-python/issues/541) | 実 PyPI 公開（Trusted Publisher 設定 + v* タグ）— メンテナ作業 | enhancement |
 | — | — | FT は保守 + オンデマンド（4 トリガー時のみ。[方法論](../explanation/field-trial-methodology.md)） | FT |
-| 低 | — | PostgreSQL / MySQL 実 DB 統合テスト | infra |
+| — | — | リリース時は `v*` タグ push → publish.yml が自動公開（[手順](../how-to/release-and-publish.md)） | infra |
 | 低 | — | PyJWT 推移的 CVE（PYSEC-2025-183）— mcp 修正待ち | 保留 |
 
 ---
@@ -166,7 +166,8 @@ v1.8.161）、#553（#578 で実装済みを確認し close）、ハウスキー
 |---|---|---|---|
 | ~~handler response_model 未使用~~ | — | [#539](https://github.com/hideyukiMORI/nene2-python/issues/539) | ✅ 2026-05-29 解消（v1.8.161）。Note/Tag/Comment 全ハンドラーに `XxxResponse`/`XxxListResponse` を定義し `response_model` 明示。OpenAPI に 6 レスポンススキーマが出力されることを確認。466 tests 据え置き |
 | ~~FT ループ目的の明文化~~ | — | [#540](https://github.com/hideyukiMORI/nene2-python/issues/540) | ✅ 2026-05-29 解消（v1.8.162）。explanation/field-trial-methodology.md（EN/JA）に目的・3 フェーズ・終着点（網羅スイープ完了→保守+オンデマンド）を明文化。INDEX/roadmap からリンク |
-| PyPI 公開フロー検証 | — | [#541](https://github.com/hideyukiMORI/nene2-python/issues/541) | ✅ 2026-05-29 検証（v1.8.163）。build/twine check/クリーン import 確認、CI に package-build ジョブ追加、CHANGELOG 連携・how-to 整備。実公開はメンテナの Trusted Publisher 設定 + v* タグ待ち |
+| ~~PyPI 公開フロー検証~~ | — | [#541](https://github.com/hideyukiMORI/nene2-python/issues/541) | ✅ 2026-05-29 解消（v1.8.163）。公開フローは既に稼働中で **v1.8.163 を PyPI へ公開**（pip install で取得可能）。CI package-build ジョブ・CHANGELOG 連携・how-to 整備 |
+| ~~マルチDB対応が未検証~~ | — | [#747](https://github.com/hideyukiMORI/nene2-python/issues/747) | ✅ 2026-05-29 解消（v1.8.164）。実DB統合テスト（PostgreSQL/MySQL・CI service container）を追加。psycopg2 lastrowid 非対応で `save()` が常に id=1 を返す重大バグを発見・修正（lastval フォールバック）。pymysql 追加・how-to（EN/JA） |
 | ~~古い FT サンドボックス肥大化~~ | — | — | ✅ 2026-05-29 整理（5.1G→79M）。`ft-status.sh --clean-sandbox` を追加（.venv/キャッシュ削除・ソース保持・uv sync で再生可）。`--clean` は dist/ のみで誤記だった |
 | ~~マージ済み orphan リモートブランチ~~ | — | — | ✅ 2026-05-29 削除（merged 8 本）。未マージの提案 PR #545 のブランチのみ残置 |
 | ログ秘匿 Filter は形式依存の best-effort | 低 | — | FT220 D3。主防御は `SecretStr`。how-to に「秘匿は多層防御の保険」を明記予定 |

{nene2_python-1.8.163 → nene2_python-1.8.164}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nene2-python"
-version = "1.8.163"
+version = "1.8.164"
 description = "NENE2 Python — minimal API framework following NENE2's design philosophy"
 readme = "README.md"
 license = {text = "MIT"}
@@ -62,6 +62,7 @@ dev = [
     "ruff>=0.9",
     "pip-audit>=2.7",
     "psycopg2-binary>=2.9.12",
+    "pymysql>=1.1",
 ]
 
 # ---------------------------------------------------------------------------

{nene2_python-1.8.163 → nene2_python-1.8.164}/src/nene2/database/sqlalchemy_executor.py

@@ -6,13 +6,33 @@ Supports SQLite, MySQL, and PostgreSQL via SQLAlchemy's engine URL.
 from collections.abc import Callable
 from typing import Any
 
-from sqlalchemy import Connection, Engine, text
-from sqlalchemy.exc import IntegrityError, OperationalError
+from sqlalchemy import Connection, CursorResult, Engine, text
+from sqlalchemy.exc import IntegrityError, OperationalError, ProgrammingError
 
 from .exceptions import DatabaseConnectionException, DatabaseIntegrityException
 from .interfaces import DatabaseQueryExecutorInterface, DatabaseTransactionManagerInterface
 
 
+def _insert_id(conn: Connection, result: CursorResult[Any]) -> int:
+    """Return the new row's PK after an INSERT, portably across dialects.
+
+    SQLite and MySQL expose the value via DBAPI ``lastrowid``. PostgreSQL
+    (psycopg2) does not, so fall back to ``lastval()`` on the same connection
+    (valid for SERIAL/IDENTITY columns within the current transaction). If no
+    sequence was touched, fall back to ``rowcount``.
+    """
+    if result.lastrowid:
+        return result.lastrowid
+    if conn.dialect.name == "postgresql":
+        try:
+            value = conn.execute(text("SELECT lastval()")).scalar()
+        except (OperationalError, ProgrammingError):
+            return result.rowcount
+        if value is not None:
+            return int(value)
+    return result.rowcount
+
+
 class SqlAlchemyQueryExecutor(DatabaseQueryExecutorInterface):
     """Execute queries using SQLAlchemy Core (connection-per-call, no ORM).
 
@@ -75,7 +95,7 @@ class SqlAlchemyQueryExecutor(DatabaseQueryExecutorInterface):
             with self._engine.begin() as conn:
                 result = conn.execute(text(sql), params or {})
                 if sql.strip().upper().startswith("INSERT"):
-                    return result.lastrowid or result.rowcount
+                    return _insert_id(conn, result)
                 return result.rowcount
         except IntegrityError as exc:
             raise DatabaseIntegrityException(str(exc)) from exc
@@ -112,7 +132,7 @@ class _BoundQueryExecutor(DatabaseQueryExecutorInterface):
         except OperationalError as exc:
             raise DatabaseConnectionException(str(exc)) from exc
         if sql.strip().upper().startswith("INSERT"):
-            return result.lastrowid or result.rowcount
+            return _insert_id(self._conn, result)
         return result.rowcount
 
 

nene2_python-1.8.164/tests/integration/conftest.py

@@ -0,0 +1,58 @@
+"""Fixtures for real-database integration tests.
+
+These tests exercise SqlAlchemyQueryExecutor against actual PostgreSQL / MySQL
+servers — the dialects the framework claims to support but only ever tested on
+SQLite. They run only when the corresponding URL env var is set, so the default
+``uv run pytest`` stays SQLite-only and fast. CI sets the env vars via service
+containers (see .github/workflows/ci.yml).
+"""
+
+import os
+from collections.abc import Iterator
+
+import pytest
+from sqlalchemy import Column, Integer, MetaData, Table, Text, create_engine
+
+from nene2.database import SqlAlchemyQueryExecutor
+
+# backend name -> env var holding its SQLAlchemy URL
+_BACKEND_ENV: dict[str, str] = {
+    "postgresql": "NENE2_TEST_POSTGRES_URL",
+    "mysql": "NENE2_TEST_MYSQL_URL",
+}
+
+# Dialect-portable schema. SQLAlchemy emits SERIAL (PostgreSQL) / AUTO_INCREMENT
+# (MySQL) from the same Integer autoincrement PK — no hand-written per-dialect DDL.
+_metadata = MetaData()
+Table(
+    "notes",
+    _metadata,
+    Column("id", Integer, primary_key=True, autoincrement=True),
+    Column("title", Text, nullable=False),
+    Column("body", Text, nullable=False),
+)
+
+
+def _configured_backends() -> list[str]:
+    return [name for name, env in _BACKEND_ENV.items() if os.environ.get(env)]
+
+
+def _params() -> list[object]:
+    backends = _configured_backends()
+    if backends:
+        return list(backends)
+    reason = "no real DB configured (set NENE2_TEST_POSTGRES_URL / NENE2_TEST_MYSQL_URL)"
+    return [pytest.param(None, marks=pytest.mark.skip(reason=reason))]
+
+
+@pytest.fixture(params=_params())
+def real_db_executor(request: pytest.FixtureRequest) -> Iterator[SqlAlchemyQueryExecutor]:
+    backend: str = request.param
+    engine = create_engine(os.environ[_BACKEND_ENV[backend]])
+    _metadata.drop_all(engine)
+    _metadata.create_all(engine)
+    try:
+        yield SqlAlchemyQueryExecutor(engine)
+    finally:
+        _metadata.drop_all(engine)
+        engine.dispose()

nene2_python-1.8.164/tests/integration/test_repository_real_db.py

@@ -0,0 +1,65 @@
+"""Note repository contract verified against real PostgreSQL / MySQL servers.
+
+Mirrors the SQLite contract in tests/example/note/test_note_repository.py, plus a
+regression for the multi-DB INSERT-PK bug: psycopg2 exposes no ``lastrowid``, so
+``save()`` must derive the new PK another way (lastval) rather than returning
+``rowcount`` (#747).
+"""
+
+import pytest
+
+from nene2.database import SqlAlchemyQueryExecutor
+from src.example.note.entity import Note
+from src.example.note.sqlalchemy_repository import SqlAlchemyNoteRepository
+
+
+@pytest.fixture
+def repo(real_db_executor: SqlAlchemyQueryExecutor) -> SqlAlchemyNoteRepository:
+    return SqlAlchemyNoteRepository(real_db_executor)
+
+
+def test_save_returns_sequential_pks(repo: SqlAlchemyNoteRepository) -> None:
+    first = repo.save("A", "a")
+    second = repo.save("B", "b")
+    assert (first.id, second.id) == (1, 2)
+
+
+def test_save_and_find_round_trip(repo: SqlAlchemyNoteRepository) -> None:
+    note = repo.save("Hello", "World")
+    assert repo.find_by_id(note.id) == note
+
+
+def test_find_by_id_returns_none_when_missing(repo: SqlAlchemyNoteRepository) -> None:
+    assert repo.find_by_id(9999) is None
+
+
+def test_find_all_respects_limit_and_offset(repo: SqlAlchemyNoteRepository) -> None:
+    for i in range(5):
+        repo.save(f"Note {i}", "body")
+    page = repo.find_all(limit=2, offset=2)
+    assert [n.title for n in page] == ["Note 2", "Note 3"]
+
+
+def test_count_reflects_saved_notes(repo: SqlAlchemyNoteRepository) -> None:
+    repo.save("T", "B")
+    repo.save("T2", "B2")
+    assert repo.count() == 2
+
+
+def test_update_changes_title_and_body(repo: SqlAlchemyNoteRepository) -> None:
+    note = repo.save("Old", "old body")
+    assert repo.update(note.id, "New", "new body") == Note(id=note.id, title="New", body="new body")
+
+
+def test_update_returns_none_for_missing_id(repo: SqlAlchemyNoteRepository) -> None:
+    assert repo.update(9999, "T", "B") is None
+
+
+def test_delete_removes_note(repo: SqlAlchemyNoteRepository) -> None:
+    note = repo.save("T", "B")
+    repo.delete(note.id)
+    assert repo.find_by_id(note.id) is None
+
+
+def test_delete_returns_false_for_missing_id(repo: SqlAlchemyNoteRepository) -> None:
+    assert repo.delete(9999) is False

{nene2_python-1.8.163 → nene2_python-1.8.164}/uv.lock

@@ -925,7 +925,7 @@ wheels = [
 
 [[package]]
 name = "nene2-python"
-version = "1.8.163"
+version = "1.8.164"
 source = { editable = "." }
 dependencies = [
     { name = "alembic" },
@@ -958,6 +958,7 @@ dev = [
     { name = "mypy" },
     { name = "pip-audit" },
     { name = "psycopg2-binary" },
+    { name = "pymysql" },
     { name = "pytest" },
     { name = "pytest-asyncio" },
     { name = "pytest-cov" },
@@ -993,6 +994,7 @@ dev = [
     { name = "mypy", specifier = ">=1.13" },
     { name = "pip-audit", specifier = ">=2.7" },
     { name = "psycopg2-binary", specifier = ">=2.9.12" },
+    { name = "pymysql", specifier = ">=1.1" },
     { name = "pytest", specifier = ">=8.3" },
     { name = "pytest-asyncio", specifier = ">=0.24" },
     { name = "pytest-cov", specifier = ">=6.0" },
@@ -1288,6 +1290,15 @@ crypto = [
     { name = "cryptography" },
 ]
 
+[[package]]
+name = "pymysql"
+version = "1.2.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c9/bc/1c6a92f385940f727daeecf3bacaf186e03875dff57197801046c583bcf0/pymysql-1.2.0.tar.gz", hash = "sha256:6c7b17ca686988104d7426c27895b455cdeea3e9d3ceb1270f0c3704fead8c33", size = 49021, upload-time = "2026-05-19T08:26:22.302Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c4/bd/2534e130295c8cfd4f0a2e31623baab7502278f1e97bcfe61db75656a77f/pymysql-1.2.0-py3-none-any.whl", hash = "sha256:62169ce6d5510f08e140c5e7990ee884a9764024e4a9a27b2cc11f1099322ae0", size = 45716, upload-time = "2026-05-19T08:26:20.974Z" },
+]
+
 [[package]]
 name = "pyparsing"
 version = "3.3.2"