nanasqlite 1.4.1.dev2__tar.gz → 1.5.0.dev2__tar.gz

nanasqlite-1.5.0.dev2/MANIFEST.in

@@ -0,0 +1,2 @@
+include src/nanasqlite/py.typed
+recursive-include src/nanasqlite *.py

{nanasqlite-1.4.1.dev2 → nanasqlite-1.5.0.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nanasqlite
-Version: 1.4.1.dev2
+Version: 1.5.0.dev2
 Summary: A dict-like SQLite wrapper with APSW for instant persistence and memory caching
 Author-email: Disnana <support@disnana.com>
 License-Expression: MIT
@@ -145,15 +145,43 @@ with NanaSQLite("mydata.db") as db:
 - [Benchmark Trends 📊](https://nanasqlite.disnana.com/dev/bench/)
 - [Migration Guide (v1.1.x to v1.2.0)](MIGRATION_GUIDE.md)
 
-### ✨ v1.4.x New Features (v2 Architecture)
+### ✨ v1.5.x New Features (Ultimate Hooks)
+
+**Ultimate Hooks: Flexible Validation & External Constraints**
+Intercept database operations with custom hooks or built-in constraints. Easily validate data, enforce uniqueness, check foreign keys, or flawlessly integrate with Pydantic.
+
+```python
+from nanasqlite import NanaSQLite
+from nanasqlite.hooks import UniqueHook, CheckHook, PydanticHook
+from pydantic import BaseModel
+
+class UserConfig(BaseModel):
+    version: int
+    theme: str
+
+db = NanaSQLite("config.db")
+db.add_hook(UniqueHook("email"))
+db.add_hook(CheckHook(lambda k, v: v.get("age", 0) >= 18, "Age must be >= 18"))
+db.add_hook(PydanticHook(UserConfig))
+
+# Write a dict, reads back as a Pydantic Model automatically!
+db["user_conf"] = {"version": 1, "theme": "dark", "email": "test@example.com", "age": 20}
+config = db["user_conf"]
+print(config.theme)  # 'dark'
+```
 
-**v2 Architecture: Non-blocking Background Persistance**
+### ✨ v1.4.x New Features (v2 Architecture)
 Introduced an optional "Write-Back Cache" architecture where all KVS writes are instantly available in memory but saved to SQLite asynchronously in the background. Read latency remains exactly zero.
 
 ```python
 # Enable v2 mode with automatic background flushing
 db = NanaSQLite("high_load.db", v2_mode=True, flush_mode="time", flush_interval=1.0)
 
+# Optional: Use V2Config for cleaner initialization (v1.4.1+)
+from nanasqlite import V2Config
+cfg = V2Config(flush_mode="time", flush_interval=5.0, enable_metrics=True)
+db = NanaSQLite("mydata.db", v2_mode=True, v2_config=cfg)
+
 # The main thread is NEVER blocked by disk I/O!
 db["heavy_key"] = validate_and_compute_data()
 ```
@@ -169,6 +197,8 @@ db["heavy_key"] = validate_and_compute_data()
 - **Backup & Restore** (v1.3.4b1): Online backup via APSW's SQLite backup API and one-call restore from any backup file.
 - **Security Audit & Hardening** (v1.3.4): Whitelist-based column type validation, AEAD nonce validation, closed-instance safety on all dict methods. See [CHANGELOG](CHANGELOG.md) for full details.
 - **Security Audit & v2 Bug Fixes** (v1.4.0): Fixed SQL injection in `create_table()` column types, V2Engine callback ordering, async child attribute inheritance, and v2 mode read-query bypass. See [CHANGELOG](CHANGELOG.md) for full details.
+- **Critical Bug Fix** (v1.4.1): Fixed `AttributeError` in `upsert()` / `aupsert()` when using specific call patterns with `conflict_columns`. Added negative caching for LRU/TTL to improve performance.
+- **Refactoring & Quality** (v1.4.1): Introduced `V2Config` to group engine parameters and resolve SonarCloud warnings. Improved Docker CI robustness. See [CHANGELOG](CHANGELOG.md) for full details.
 
 ```python
 # Lock Timeout
@@ -344,6 +374,31 @@ with NanaSQLite("mydata.db") as db:
 - [ベンチマーク履歴 📊](https://nanasqlite.disnana.com/dev/bench/)
 - [移行ガイド (v1.1.x から v1.2.0)](MIGRATION_GUIDE.md)
 
+### ✨ v1.5.x 新機能 (Ultimate Hooks)
+
+**Ultimate Hooks: 柔軟なバリデーションと外部制約アーキテクチャ**
+データベースの読み書き・削除をカスタムフックや組み込み制約でインターセプトできます。データの検証、一意性の保証、外部キー制約のチェック、Pydantic とのシームレスな統合などが容易に行えます。
+
+```python
+from nanasqlite import NanaSQLite
+from nanasqlite.hooks import UniqueHook, CheckHook, PydanticHook
+from pydantic import BaseModel
+
+class UserConfig(BaseModel):
+    version: int
+    theme: str
+
+db = NanaSQLite("config.db")
+db.add_hook(UniqueHook("email"))
+db.add_hook(CheckHook(lambda k, v: v.get("age", 0) >= 18, "Age must be >= 18"))
+db.add_hook(PydanticHook(UserConfig))
+
+# dict を書き込むと、自動的に検証され Pydantic モデルとして読み出せます！
+db["user_conf"] = {"version": 1, "theme": "dark", "email": "test@example.com", "age": 20}
+config = db["user_conf"]
+print(config.theme)  # 'dark'
+```
+
 ### ✨ v1.4.x 新機能 (v2 アーキテクチャ)
 
 **v2 アーキテクチャ: ノンブロッキング・バックグラウンド永続化**
@@ -353,6 +408,11 @@ KVSの書き込みをすべて「Write-Back Cache（メモリ優先更新）」
 # v2モードを有効化（1秒ごとのバックグラウンドフラッシュ）
 db = NanaSQLite("high_load.db", v2_mode=True, flush_mode="time", flush_interval=1.0)
 
+# オプション: V2Configを使用して設定をひとまとめに（v1.4.1+）
+from nanasqlite import V2Config
+cfg = V2Config(flush_mode="time", flush_interval=5.0, enable_metrics=True)
+db = NanaSQLite("mydata.db", v2_mode=True, v2_config=cfg)
+
 # どんなに重いI/Oが発生しても、メインスレッドは一切ブロックされません！
 db["heavy_key"] = validate_and_compute_data()
 ```
@@ -368,6 +428,8 @@ db["heavy_key"] = validate_and_compute_data()
 - **バックアップ / リストア** (v1.3.4b1): APSW の SQLite バックアップ API によるオンラインバックアップと、一発でのリストアをサポート。
 - **セキュリティ監査・強化** (v1.3.4): column_type ホワイトリスト検証、AEAD nonce 検証、全 dict メソッドのクローズ済みインスタンス安全性。詳細は [CHANGELOG](CHANGELOG.md) を参照。
 - **セキュリティ監査・v2 バグ修正** (v1.4.0): `create_table()` カラム型SQLインジェクション修正、V2Engineコールバック順序修正、非同期子インスタンス属性継承修正、v2モード読み取りクエリバイパス修正。詳細は [CHANGELOG](CHANGELOG.md) を参照。
+- **致命的バグ修正・性能向上** (v1.4.1): `upsert()` / `aupsert()` における `AttributeError` を修正。LRU/TTL キャッシュへのネガティブキャッシュ導入による性能向上。詳細は [CHANGELOG](CHANGELOG.md) を参照。
+- **リファクタリング・品質向上** (v1.4.1): `V2Config` の導入による引数管理の整理と、Docker CI環境の安定化を実施。
 
 ```python
 # ロックタイムアウト

{nanasqlite-1.4.1.dev2 → nanasqlite-1.5.0.dev2}/README.md

@@ -90,15 +90,43 @@ with NanaSQLite("mydata.db") as db:
 - [Benchmark Trends 📊](https://nanasqlite.disnana.com/dev/bench/)
 - [Migration Guide (v1.1.x to v1.2.0)](MIGRATION_GUIDE.md)
 
-### ✨ v1.4.x New Features (v2 Architecture)
+### ✨ v1.5.x New Features (Ultimate Hooks)
+
+**Ultimate Hooks: Flexible Validation & External Constraints**
+Intercept database operations with custom hooks or built-in constraints. Easily validate data, enforce uniqueness, check foreign keys, or flawlessly integrate with Pydantic.
+
+```python
+from nanasqlite import NanaSQLite
+from nanasqlite.hooks import UniqueHook, CheckHook, PydanticHook
+from pydantic import BaseModel
+
+class UserConfig(BaseModel):
+    version: int
+    theme: str
+
+db = NanaSQLite("config.db")
+db.add_hook(UniqueHook("email"))
+db.add_hook(CheckHook(lambda k, v: v.get("age", 0) >= 18, "Age must be >= 18"))
+db.add_hook(PydanticHook(UserConfig))
+
+# Write a dict, reads back as a Pydantic Model automatically!
+db["user_conf"] = {"version": 1, "theme": "dark", "email": "test@example.com", "age": 20}
+config = db["user_conf"]
+print(config.theme)  # 'dark'
+```
 
-**v2 Architecture: Non-blocking Background Persistance**
+### ✨ v1.4.x New Features (v2 Architecture)
 Introduced an optional "Write-Back Cache" architecture where all KVS writes are instantly available in memory but saved to SQLite asynchronously in the background. Read latency remains exactly zero.
 
 ```python
 # Enable v2 mode with automatic background flushing
 db = NanaSQLite("high_load.db", v2_mode=True, flush_mode="time", flush_interval=1.0)
 
+# Optional: Use V2Config for cleaner initialization (v1.4.1+)
+from nanasqlite import V2Config
+cfg = V2Config(flush_mode="time", flush_interval=5.0, enable_metrics=True)
+db = NanaSQLite("mydata.db", v2_mode=True, v2_config=cfg)
+
 # The main thread is NEVER blocked by disk I/O!
 db["heavy_key"] = validate_and_compute_data()
 ```
@@ -114,6 +142,8 @@ db["heavy_key"] = validate_and_compute_data()
 - **Backup & Restore** (v1.3.4b1): Online backup via APSW's SQLite backup API and one-call restore from any backup file.
 - **Security Audit & Hardening** (v1.3.4): Whitelist-based column type validation, AEAD nonce validation, closed-instance safety on all dict methods. See [CHANGELOG](CHANGELOG.md) for full details.
 - **Security Audit & v2 Bug Fixes** (v1.4.0): Fixed SQL injection in `create_table()` column types, V2Engine callback ordering, async child attribute inheritance, and v2 mode read-query bypass. See [CHANGELOG](CHANGELOG.md) for full details.
+- **Critical Bug Fix** (v1.4.1): Fixed `AttributeError` in `upsert()` / `aupsert()` when using specific call patterns with `conflict_columns`. Added negative caching for LRU/TTL to improve performance.
+- **Refactoring & Quality** (v1.4.1): Introduced `V2Config` to group engine parameters and resolve SonarCloud warnings. Improved Docker CI robustness. See [CHANGELOG](CHANGELOG.md) for full details.
 
 ```python
 # Lock Timeout
@@ -289,6 +319,31 @@ with NanaSQLite("mydata.db") as db:
 - [ベンチマーク履歴 📊](https://nanasqlite.disnana.com/dev/bench/)
 - [移行ガイド (v1.1.x から v1.2.0)](MIGRATION_GUIDE.md)
 
+### ✨ v1.5.x 新機能 (Ultimate Hooks)
+
+**Ultimate Hooks: 柔軟なバリデーションと外部制約アーキテクチャ**
+データベースの読み書き・削除をカスタムフックや組み込み制約でインターセプトできます。データの検証、一意性の保証、外部キー制約のチェック、Pydantic とのシームレスな統合などが容易に行えます。
+
+```python
+from nanasqlite import NanaSQLite
+from nanasqlite.hooks import UniqueHook, CheckHook, PydanticHook
+from pydantic import BaseModel
+
+class UserConfig(BaseModel):
+    version: int
+    theme: str
+
+db = NanaSQLite("config.db")
+db.add_hook(UniqueHook("email"))
+db.add_hook(CheckHook(lambda k, v: v.get("age", 0) >= 18, "Age must be >= 18"))
+db.add_hook(PydanticHook(UserConfig))
+
+# dict を書き込むと、自動的に検証され Pydantic モデルとして読み出せます！
+db["user_conf"] = {"version": 1, "theme": "dark", "email": "test@example.com", "age": 20}
+config = db["user_conf"]
+print(config.theme)  # 'dark'
+```
+
 ### ✨ v1.4.x 新機能 (v2 アーキテクチャ)
 
 **v2 アーキテクチャ: ノンブロッキング・バックグラウンド永続化**
@@ -298,6 +353,11 @@ KVSの書き込みをすべて「Write-Back Cache（メモリ優先更新）」
 # v2モードを有効化（1秒ごとのバックグラウンドフラッシュ）
 db = NanaSQLite("high_load.db", v2_mode=True, flush_mode="time", flush_interval=1.0)
 
+# オプション: V2Configを使用して設定をひとまとめに（v1.4.1+）
+from nanasqlite import V2Config
+cfg = V2Config(flush_mode="time", flush_interval=5.0, enable_metrics=True)
+db = NanaSQLite("mydata.db", v2_mode=True, v2_config=cfg)
+
 # どんなに重いI/Oが発生しても、メインスレッドは一切ブロックされません！
 db["heavy_key"] = validate_and_compute_data()
 ```
@@ -313,6 +373,8 @@ db["heavy_key"] = validate_and_compute_data()
 - **バックアップ / リストア** (v1.3.4b1): APSW の SQLite バックアップ API によるオンラインバックアップと、一発でのリストアをサポート。
 - **セキュリティ監査・強化** (v1.3.4): column_type ホワイトリスト検証、AEAD nonce 検証、全 dict メソッドのクローズ済みインスタンス安全性。詳細は [CHANGELOG](CHANGELOG.md) を参照。
 - **セキュリティ監査・v2 バグ修正** (v1.4.0): `create_table()` カラム型SQLインジェクション修正、V2Engineコールバック順序修正、非同期子インスタンス属性継承修正、v2モード読み取りクエリバイパス修正。詳細は [CHANGELOG](CHANGELOG.md) を参照。
+- **致命的バグ修正・性能向上** (v1.4.1): `upsert()` / `aupsert()` における `AttributeError` を修正。LRU/TTL キャッシュへのネガティブキャッシュ導入による性能向上。詳細は [CHANGELOG](CHANGELOG.md) を参照。
+- **リファクタリング・品質向上** (v1.4.1): `V2Config` の導入による引数管理の整理と、Docker CI環境の安定化を実施。
 
 ```python
 # ロックタイムアウト

{nanasqlite-1.4.1.dev2 → nanasqlite-1.5.0.dev2}/pyproject.toml

@@ -84,8 +84,12 @@ Repository = "https://github.com/disnana/nanasqlite"
 Issues = "https://github.com/disnana/nanasqlite/issues"
 
 [tool.setuptools]
-packages = ["nanasqlite"]
-package-dir = {"nanasqlite" = "src/nanasqlite"}
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["nanasqlite*"]
+namespaces = false
 
 [tool.setuptools.package-data]
 nanasqlite = ["py.typed"]
@@ -130,7 +134,7 @@ ignore = [
 known-first-party = ["nanasqlite"]
 
 [tool.mypy]
-python_version = "3.10"
+python_version = "3.9"
 warn_return_any = false
 warn_unused_configs = true
 ignore_missing_imports = true

{nanasqlite-1.4.1.dev2 → nanasqlite-1.5.0.dev2}/src/nanasqlite/__init__.py

@@ -21,9 +21,12 @@ Async Example:
     >>> asyncio.run(main())
 """
 
+from __future__ import annotations
+
 from .async_core import AsyncNanaSQLite
 from .cache import CacheType
-from .core import HAS_ORJSON, HAS_VALIDKIT, NanaSQLite
+from .compat import HAS_ORJSON, HAS_VALIDKIT
+from .core import NanaSQLite, V2Config
 from .exceptions import (
     NanaSQLiteCacheError,
     NanaSQLiteClosedError,
@@ -34,15 +37,24 @@ from .exceptions import (
     NanaSQLiteTransactionError,
     NanaSQLiteValidationError,
 )
+from .hooks import CheckHook, ForeignKeyHook, PydanticHook, UniqueHook, ValidkitHook
+from .protocols import NanaHook
 
-__version__ = "1.4.1dev2"
+__version__ = "1.5.0dev2"
 __author__ = "Disnana"
 __all__ = [
     "NanaSQLite",
     "AsyncNanaSQLite",
+    "V2Config",
     "CacheType",
     "HAS_ORJSON",
     "HAS_VALIDKIT",
+    "NanaHook",
+    "CheckHook",
+    "UniqueHook",
+    "ForeignKeyHook",
+    "PydanticHook",
+    "ValidkitHook",
     "NanaSQLiteError",
     "NanaSQLiteValidationError",
     "NanaSQLiteDatabaseError",