dirsql 0.3.15__tar.gz → 0.3.16__tar.gz

{dirsql-0.3.15 → dirsql-0.3.16}/Cargo.lock

@@ -499,7 +499,7 @@ dependencies = [
 
 [[package]]
 name = "dirsql-py-ext"
-version = "0.3.15"
+version = "0.3.16"
 dependencies = [
  "dirsql",
  "pyo3",

{dirsql-0.3.15 → dirsql-0.3.16}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: dirsql
-Version: 0.3.15
+Version: 0.3.16
 Requires-Dist: pytest>=8 ; extra == 'dev'
 Requires-Dist: pytest-describe>=2 ; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23 ; extra == 'dev'
 Requires-Dist: pytest-cov>=5 ; extra == 'dev'
 Requires-Dist: ruff>=0.4 ; extra == 'dev'
 Requires-Dist: maturin>=1.0 ; extra == 'dev'
+Requires-Dist: ty==0.0.42 ; extra == 'dev'
 Provides-Extra: dev
 Summary: Ephemeral SQL index over a local directory
 Keywords: sql,filesystem,directory,sqlite,index

{dirsql-0.3.15 → dirsql-0.3.16}/dirsql/_async.py

@@ -104,14 +104,14 @@ class DirSQL:
 
     async def query(self, sql):
         """Execute a SQL query asynchronously."""
-        return await asyncio.to_thread(self._db.query, sql)
+        return await asyncio.to_thread(self._db.query, sql)  # ty:ignore[unresolved-attribute]
 
     def watch(self):
         """Start watching for file changes. Returns an async iterable of RowEvent."""
         return _WatchStream(self._db)
 
     @property
-    def __dict__(self):
+    def __dict__(self):  # ty:ignore[missing-override-decorator]
         """Resolved construction state as a JSON-serializable dict.
 
         Recomputed on each access; reads the ``.dirsql.toml`` if ``config=``

dirsql-0.3.16/dirsql/_dirsql.pyi

@@ -0,0 +1,63 @@
+"""Type stubs for the native PyO3 extension module.
+
+Mirrors the surface defined in ``packages/python/src/lib.rs``. Hand-written
+because pyo3-stub-gen would otherwise demand a build-time hook that the
+maturin / putitoutthere release pipeline does not yet run.
+
+Whenever ``src/lib.rs`` adds, renames, or removes a ``#[pyclass]``,
+``#[pymethods]``, or module-level binding, this file MUST be updated in the
+same PR -- and ``PARITY.md`` is the canonical reminder.
+"""
+
+from collections.abc import Callable
+from os import PathLike
+from typing import Any
+
+__version__: str
+
+Row = dict[str, Any]
+
+class Table:
+    """A table definition. Construct via keyword arguments only."""
+
+    ddl: str
+    glob: str
+    strict: bool
+
+    def __init__(
+        self,
+        *,
+        ddl: str,
+        glob: str,
+        extract: Callable[[str], list[Row]],
+        strict: bool = False,
+    ) -> None: ...
+
+class RowEvent:
+    """A row event produced by the watch loop."""
+
+    table: str | None
+    action: str
+    row: Row | None
+    old_row: Row | None
+    error: str | None
+    file_path: str | None
+
+    def __repr__(self) -> str: ...  # ty:ignore[missing-override-decorator]
+
+class DirSQL:
+    """Synchronous binding class. ``dirsql._async.DirSQL`` wraps it."""
+
+    def __init__(
+        self,
+        root: str | None = None,
+        *,
+        tables: list[Table] | None = None,
+        ignore: list[str] | None = None,
+        config: str | None = None,
+        persist: bool = False,
+        persist_path: str | PathLike[str] | None = None,
+    ) -> None: ...
+    def query(self, sql: str) -> list[Row]: ...
+    def _start_watcher(self) -> None: ...
+    def _poll_events(self, timeout_ms: int) -> list[RowEvent]: ...

{dirsql-0.3.15 → dirsql-0.3.16}/dirsql/resolve_config.py

@@ -20,7 +20,7 @@ def resolve_config(root, tables, ignore, config, persist, persist_path):
         cfg_dir = os.path.dirname(os.path.abspath(config))
 
     def _abs(p):
-        return p if os.path.isabs(p) else os.path.join(cfg_dir, p)
+        return p if os.path.isabs(p) else os.path.join(cfg_dir, p)  # ty:ignore[no-matching-overload]
 
     return {
         "root": root or (_abs(cfg["root"]) if "root" in cfg else cfg_dir),

{dirsql-0.3.15 → dirsql-0.3.16}/packages/python/Cargo.toml

@@ -4,7 +4,7 @@ name = "dirsql-py-ext"
 # pypi/maturin handler can rewrite it via `write-version` before
 # `maturin build`. `pyproject.toml` declares `dynamic = ["version"]`
 # and maturin reads this field. Mirrors `packages/rust/Cargo.toml`.
-version = "0.3.15"
+version = "0.3.16"
 edition.workspace = true
 publish = false
 readme = "README.md"

{dirsql-0.3.15 → dirsql-0.3.16}/pyproject.toml

@@ -27,6 +27,8 @@ dev = [
     "pytest-cov>=5",
     "ruff>=0.4",
     "maturin>=1.0",
+    # ty is pre-1.0 -- pin tightly. Re-pin in lockstep with CI.
+    "ty==0.0.42",
 ]
 
 [project.scripts]
@@ -57,6 +59,32 @@ include = [
 ]
 manifest-path = "packages/python/Cargo.toml"
 
+# Type checking. Migration model: existing untyped code is frozen behind
+# `# ty: ignore[...]` baseline comments inserted by `ty check --add-ignore`;
+# any new error in new or touched code fails CI. Every rule is promoted to
+# `"error"`, matching TypeScript-strict discipline. Test files are excluded
+# because they monkeypatch fakes onto production module attributes
+# (`monkeypatch.setattr(async_mod, "_RustDirSQL", ...)`) -- AGENTS.md flags
+# that as a smell, ty surfaces it accurately, and the cleanup (constructor
+# injection) is tracked separately.
+[tool.ty.src]
+exclude = [
+    "**/test_*.py",
+    "**/*_test.py",
+    "tests/",
+    "build/",
+    "dirsql/_binary/",
+]
+
+[tool.ty.environment]
+python-version = "3.11"
+
+# Ruff enforces "every type-ignore must cite a rule code" (PGH003) so a
+# `# type: ignore` or `# ty: ignore` without `[...]` fails lint. Stops the
+# escape hatch from quietly widening.
+[tool.ruff.lint]
+extend-select = ["PGH003"]
+
 [tool.coverage.run]
 omit = [
     # Colocated unit tests live alongside the package source; instrumenting