bottle-lmdb 0.1.0__tar.gz

bottle_lmdb-0.1.0/PKG-INFO

@@ -0,0 +1,36 @@
+Metadata-Version: 2.3
+Name: bottle-lmdb
+Version: 0.1.0
+Summary: Add your description here
+Author: Kimikazu Kato
+Author-email: Kimikazu Kato <kimikazu@gmail.com>
+Requires-Dist: bottle>=0.12.25
+Requires-Dist: lmdb>=3.0.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# bottle-lmdb
+Lightning Memory-Mapped Database (LMDB) plugin for Bottle.
+
+Usage:
+
+```python
+from bottle import Bottle
+from bottle_lmdb import LMDBPlugin
+
+app = Bottle()
+plugin = LMDBPlugin("/path/to/db")
+app.install(plugin)
+
+@app.get("/write/<key>/<value>")
+def write(key, value, db):
+    with db.begin(write=True) as txn:
+        txn.put(key.encode(), value.encode())
+    return "ok"
+
+@app.get("/read/<key>")
+def read(key, db):
+    with db.begin() as txn:
+        value = txn.get(key.encode())
+    return value.decode() if value else "not found"
+```

bottle_lmdb-0.1.0/README.md

@@ -0,0 +1,25 @@
+# bottle-lmdb
+Lightning Memory-Mapped Database (LMDB) plugin for Bottle.
+
+Usage:
+
+```python
+from bottle import Bottle
+from bottle_lmdb import LMDBPlugin
+
+app = Bottle()
+plugin = LMDBPlugin("/path/to/db")
+app.install(plugin)
+
+@app.get("/write/<key>/<value>")
+def write(key, value, db):
+    with db.begin(write=True) as txn:
+        txn.put(key.encode(), value.encode())
+    return "ok"
+
+@app.get("/read/<key>")
+def read(key, db):
+    with db.begin() as txn:
+        value = txn.get(key.encode())
+    return value.decode() if value else "not found"
+```

bottle_lmdb-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[project]
+name = "bottle-lmdb"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+authors = [
+    { name = "Kimikazu Kato", email = "kimikazu@gmail.com" }
+]
+requires-python = ">=3.10"
+dependencies = [
+    "bottle>=0.12.25",
+    "lmdb>=3.0.0",
+]
+
+[build-system]
+requires = ["uv_build>=0.8.22,<0.9.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "httpx>=0.28.1",
+    "mypy>=2.4.1",
+    "pytest>=9.2.0",
+    "tox-uv>=1.36.1",
+]

bottle_lmdb-0.1.0/src/bottle_lmdb/__init__.py

@@ -0,0 +1,3 @@
+from .plugin import LMDBPlugin
+
+__all__ = ["LMDBPlugin"]

bottle_lmdb-0.1.0/src/bottle_lmdb/plugin.py

@@ -0,0 +1,65 @@
+import inspect
+import typing
+import lmdb
+
+
+class LMDBPlugin:
+    name = "lmdb"
+    api = 2
+
+    def __init__(self, db_path: str, **kwargs) -> None:
+        """Initialize the plugin.
+
+        Args:
+            db_path: Path to the LMDB database directory.
+            **kwargs: Extra options forwarded to ``lmdb.Environment``.
+                The ``keyword`` option sets the route keyword argument
+                name used to inject the environment (default: ``"db"``).
+        """
+        self._db_path = db_path
+        self._kwargs = kwargs.copy()
+        self._env: None | lmdb.Environment = None
+        if "keyword" in kwargs:
+            keyword = self._kwargs["keyword"]
+            del self._kwargs["keyword"]
+        else:
+            keyword = "db"
+        self._keyword: str = keyword
+
+    @property
+    def env(self) -> lmdb.Environment:
+        """Return the LMDB environment, opening it lazily on first access.
+
+        Returns:
+            lmdb.Environment: The environment for ``db_path``.
+        """
+        # When a work process access this first time db is initialized
+        if self._env is None:
+            self._env = lmdb.Environment(self._db_path, **self._kwargs)
+        return self._env
+
+    def apply(self, callback: typing.Callable, route) -> typing.Callable:
+        """Wrap a route callback to inject the LMDB environment.
+
+        Args:
+            callback: The original route callback.
+            route: The Bottle route object (unused).
+
+        Returns:
+            A wrapper that passes the environment to the callback
+            via the configured keyword argument.
+        """
+        keyword = route.config.get("lmdb.keyword", self._keyword)
+        
+        try:
+            args = inspect.signature(route.callback).parameters
+        except (TypeError, ValueError):
+            return callback
+        if keyword not in args:
+            return callback
+
+        def wrapper(*a, **ka):
+            ka[keyword] = self.env
+            return callback(*a, **ka)
+
+        return wrapper