sqlite-dic 0.0.0__py3-none-any.whl

sqlite_dic/__init__.py

@@ -0,0 +1,60 @@
+# SQLite辞書DB [sqlite-dic]
+
+import sys
+import json
+import sqlite3
+import threading
+from collections.abc import MutableMapping
+
+# テーブル定義式
+SCHEMA = "CREATE TABLE IF NOT EXISTS main (key TEXT PRIMARY KEY, value TEXT)"
+
+# SQLite辞書DB [sqlite-dic]
+class SQLite_Dic(MutableMapping):   # 辞書ライクオブジェクトを継承することで辞書的インターフェースを自動的に実現
+	# 初期化処理
+	def __init__(self, path):
+		self._path = path
+		self._local = threading.local()	# スレッドごとに接続を保持するためのストレージ
+		self.exe_and_com(SCHEMA)	# 初期テーブル作成
+	# execute と commit を実行
+	def exe_and_com(self, *args):
+		cur = self.conn.execute(*args)
+		self.conn.commit()
+		return cur
+	# DBへの接続obj取得
+	@property
+	def conn(self):
+		if getattr(self._local, "conn", None) is None:	# 存在しない場合新規作成
+			conn = sqlite3.connect(self._path)
+			conn.execute("PRAGMA journal_mode=WAL")	# WALモード (高速)
+			conn.execute("PRAGMA busy_timeout=30000")	# 30秒タイムアウト
+			self._local.conn = conn
+		return self._local.conn
+	# MutableMapping の必須実装メソッド5つ
+	def __getitem__(self, key):
+		row = self.conn.execute("SELECT value FROM main WHERE key=?", [key]).fetchone()
+		if row is None: raise KeyError(key)
+		return json.loads(row[0])
+	def __setitem__(self, key, value):
+		encoded = json.dumps(value, ensure_ascii=False)	# JSON化
+		self.exe_and_com("INSERT OR REPLACE INTO main (key, value) VALUES (?, ?)", [key, encoded])	# execute と commit を実行
+	def __delitem__(self, key):
+		cur = self.exe_and_com("DELETE FROM main WHERE key=?", [key])	# execute と commit を実行
+		if cur.rowcount == 0: raise KeyError(key)
+	def __iter__(self):
+		rows = self.conn.execute("SELECT key FROM main").fetchall()
+		return (r[0] for r in rows)
+	def __len__(self):
+		return self.conn.execute("SELECT COUNT(*) FROM main").fetchone()[0]
+	# 第一・第二文字列化
+	def __str__(self): return f"<sqlite-dic len={len(self)}>"
+	def __repr__(self): return str(self)
+	# DB接続を閉じる (複数回呼んでも安全; atexit登録はしなくても安全と考えられるので今回は略)
+	def __del__(self):
+		conn = getattr(self._local, "conn", None)
+		if conn is None: return None
+		conn.close()
+		self._local.conn = None
+
+# モジュールオブジェクトとクラスオブジェクトを同一視
+sys.modules[__name__] = SQLite_Dic

sqlite_dic/test.py

@@ -0,0 +1,14 @@
+# SQLite辞書DB [sqlite-dic]
+# 【動作確認 / 使用例】
+
+import ezpip
+# SQLite辞書DB [sqlite-dic]
+sqlite_dic = ezpip.load_develop("sqlite_dic", "../", develop_flag = True)
+
+db = sqlite_dic("./sample.db")  # DB接続
+
+db["hoge"] = 33 # DBへの値の追加/更新
+db["fuga"] = {"k": "value"} # 値はJSON化可能な任意の値が使える
+print(db["hoge"])   # 値の取得
+del db["hoge"]  # エントリの削除
+print(len(db))  # -> 1

sqlite_dic-0.0.0.dist-info/METADATA

@@ -0,0 +1,98 @@
+Metadata-Version: 2.1
+Name: sqlite-dic
+Version: 0.0.0
+Summary: A lightweight SQLite-backed database that can be used like a Python dictionary.
+Home-page: https://github.co.jp/
+Author: bib_inf
+Author-email: contact.bibinf@gmail.com
+License: CC0 v1.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Classifier: License :: CC0 1.0 Universal (CC0 1.0) Public Domain Dedication
+Description-Content-Type: text/markdown
+Requires-Dist: ezpip
+
+English description follows Japanese.
+
+---
+
+Pythonの辞書のように使える、SQLiteバックエンドの軽量キーバリューストアです。
+
+## 概要
+- `sqlite-dic` は、SQLiteデータベースをPythonの辞書と同じ感覚で操作できるライブラリです。値にはJSONシリアライズ可能な任意の型（文字列、数値、真偽値、リスト、辞書、`None`）を格納できます。
+- 内部ではSQLiteのWAL（Write-Ahead Logging）モードを使用しており、読み書きの並列アクセスが可能です。すべての操作はスレッドセーフです。
+- AIでのコーディングにおいてこのツールを使用するときは、そのままこのドキュメントをプロンプトに含めることで、AIにこのDBを使ってコーディングしてもらうことが可能です。
+
+## インストール
+
+```bash
+pip install sqlite-dic
+```
+
+## 使い方
+
+```python
+import sqlite_dic
+
+# データベースを開く（存在しなければ自動作成）
+db = sqlite_dic("./sample.db")
+
+# 値の追加・更新 — 辞書と同じ書き方
+db["count"] = 33
+db["config"] = {"theme": "dark", "lang": "ja"}
+
+# 値の取得
+print(db["count"])    # 33
+print(db["config"])   # {'theme': 'dark', 'lang': 'ja'}
+
+# エントリの削除
+del db["count"]
+
+# 格納数の確認
+print(len(db))        # 1
+```
+
+## 制約
+- **キー** は文字列のみ使用可能です。
+- **値** はJSONシリアライズ可能な型（`dict`、`list`、`str`、`int`、`float`、`bool`、`None`）に限ります。
+- 同時書き込みはSQLiteのファイルロックにより直列化されます（busy timeout: 30秒）。
+
+---
+
+A lightweight key-value store backed by SQLite, with a Python `dict`-like interface.
+
+## Overview
+- `sqlite-dic` lets you use an SQLite database as if it were a regular Python dictionary. Values can be any JSON-serializable type, so you can store strings, numbers, booleans, lists, dicts, and `None` without any extra setup.
+- Under the hood, SQLite's WAL (Write-Ahead Logging) mode provides concurrent read/write access, and all operations are thread-safe.
+
+## Installation
+```bash
+pip install sqlite-dic
+```
+
+## Quick Start
+```python
+import sqlite_dic
+
+# Open (or create) a database
+db = sqlite_dic("./sample.db")
+
+# Set values — just like a dict
+db["count"] = 33
+db["config"] = {"theme": "dark", "lang": "en"}
+
+# Get values
+print(db["count"])    # 33
+print(db["config"])   # {'theme': 'dark', 'lang': 'en'}
+
+# Delete an entry
+del db["count"]
+
+# Check the number of stored entries
+print(len(db))        # 1
+```
+
+## Constraints
+- **Keys** must be strings.
+- **Values** must be JSON-serializable (`dict`, `list`, `str`, `int`, `float`, `bool`, or `None`).
+- Concurrent writes are serialized by SQLite's file lock (busy timeout: 30 seconds).

sqlite_dic-0.0.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+sqlite_dic/__init__.py,sha256=B_S7ao2O_S_qz7WBCV-bpmYrTbwsLG3HewXNng2E6HA,2459
+sqlite_dic/test.py,sha256=1CE3rPBScscm8723kEvFD1_1PYXkuDN6wCvCwaAc0gQ,447
+sqlite_dic-0.0.0.dist-info/METADATA,sha256=cj0s8cIv0VjP6JMjW5ZE4Oy7cJE6iIc7slhtRgOCAqY,3414
+sqlite_dic-0.0.0.dist-info/WHEEL,sha256=2wepM1nk4DS4eFpYrW1TTqPcoGNfHhhO_i5m4cOimbo,92
+sqlite_dic-0.0.0.dist-info/top_level.txt,sha256=ZMFbQgNCUHmGdJ4J9c8dPYPRMlk4O7NQH6g7rRu9gXs,11
+sqlite_dic-0.0.0.dist-info/RECORD,,

sqlite_dic-0.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.38.4)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

sqlite_dic-0.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+sqlite_dic