dirsql 0.0.14__tar.gz → 0.0.16__tar.gz

{dirsql-0.0.14 → dirsql-0.0.16}/.claude/CLAUDE.md

@@ -1,5 +1,15 @@
 # dirsql Development
 
+## Cross-Language Parity
+
+dirsql ships SDKs in Rust, Python, and TypeScript. Aim for **complete API parity across all three languages**: same concepts, same capabilities, same naming where possible. Exceptions are allowed for language-idiomatic patterns:
+
+- **Python**: `await db.ready()` (method call, not awaitable property). snake_case. Async iterators for event streams.
+- **TypeScript**: `await db.ready` (awaitable property is idiomatic). camelCase. AsyncIterables for event streams.
+- **Rust**: Builder pattern or `db.ready().await`. snake_case. Stream trait for event streams.
+
+When adding a feature to one SDK, create beads for the other two. Don't let them drift apart.
+
 ## Scratch Files
 
 Write scratch/temporary files to `/tmp` instead of asking permission. Use unique filenames to avoid collisions with other sessions.

{dirsql-0.0.14 → dirsql-0.0.16}/.github/workflows/minor-release.yml

@@ -3,6 +3,10 @@ name: Minor Release
 on:
   workflow_dispatch:
 
+permissions:
+  contents: write
+  id-token: write
+
 jobs:
   detect-changes:
     runs-on: ubuntu-latest

{dirsql-0.0.14 → dirsql-0.0.16}/.github/workflows/patch-release.yml

@@ -8,6 +8,10 @@ on:
     branches: [main]
   workflow_dispatch:
 
+permissions:
+  contents: write
+  id-token: write
+
 jobs:
   check:
     runs-on: ubuntu-latest

{dirsql-0.0.14 → dirsql-0.0.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dirsql
-Version: 0.0.14
+Version: 0.0.16
 Requires-Dist: pytest>=8 ; extra == 'dev'
 Requires-Dist: pytest-describe>=2 ; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23 ; extra == 'dev'

{dirsql-0.0.14 → dirsql-0.0.16}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "dirsql"
-version = "0.0.14"
+version = "0.0.16"
 description = "Ephemeral SQL index over a local directory"
 license = "MIT"
 requires-python = ">=3.12"
@@ -36,3 +36,5 @@ exclude = [
     "AGENTS.md",
     "justfile",
 ]
+python-source = "python"
+module-name = "dirsql._dirsql"

dirsql-0.0.16/python/dirsql/__init__.py

@@ -0,0 +1,6 @@
+"""dirsql - Ephemeral SQL index over a local directory."""
+
+from dirsql._dirsql import DirSQL, Table, RowEvent, __version__
+from dirsql._async import AsyncDirSQL
+
+__all__ = ["DirSQL", "Table", "RowEvent", "AsyncDirSQL", "__version__"]

dirsql-0.0.16/python/dirsql/_async.py

@@ -0,0 +1,63 @@
+"""Async wrapper for DirSQL."""
+
+import asyncio
+
+from dirsql._dirsql import DirSQL
+
+
+class _WatchStream:
+    """Async iterator that polls for file events."""
+
+    def __init__(self, db):
+        self._db = db
+        self._started = False
+        self._buffer = []
+
+    def __aiter__(self):
+        return self
+
+    async def __anext__(self):
+        if not self._started:
+            await asyncio.to_thread(self._db._start_watcher)
+            self._started = True
+
+        while True:
+            if self._buffer:
+                return self._buffer.pop(0)
+            events = await asyncio.to_thread(self._db._poll_events, 200)
+            if events:
+                self._buffer.extend(events)
+
+
+class AsyncDirSQL:
+    """Async wrapper around DirSQL.
+
+    Usage:
+        db = await AsyncDirSQL(root, tables=[...])
+        results = await db.query("SELECT ...")
+        async for event in db.watch():
+            ...
+    """
+
+    def __init__(self, root, *, tables, ignore=None):
+        self._root = root
+        self._tables = tables
+        self._ignore = ignore
+        self._db = None
+
+    def __await__(self):
+        return self._init().__await__()
+
+    async def _init(self):
+        self._db = await asyncio.to_thread(
+            DirSQL, self._root, tables=self._tables, ignore=self._ignore
+        )
+        return self
+
+    async def query(self, sql):
+        """Execute a SQL query asynchronously."""
+        return await asyncio.to_thread(self._db.query, sql)
+
+    def watch(self):
+        """Start watching for file changes. Returns an async iterable of RowEvent."""
+        return _WatchStream(self._db)