diffbutler 0.5.0__tar.gz → 0.5.2__tar.gz

{diffbutler-0.5.0 → diffbutler-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: diffbutler
-Version: 0.5.0
+Version: 0.5.2
 Summary: A terminal dashboard for human-directed AI code reviews.
 Keywords: code-review,github,terminal,ai
 License-Expression: MIT
@@ -38,17 +38,29 @@ finish your review in the browser.
 
 ## Install
 
-Install [uv](https://docs.astral.sh/uv/getting-started/installation/) and Git.
-From a local checkout of this repository, run:
+Install [uv](https://docs.astral.sh/uv/getting-started/installation/) and Git, then
+install DiffButler from [PyPI](https://pypi.org/project/diffbutler/):
 
 ```sh
-uv tool install --python 3.14 .
+uv tool install --python 3.14 diffbutler
 ```
 
 uv manages Python and dependencies in an isolated environment. No virtual environment
 activation is needed. If `diffbutler` is not on your PATH, run `uv tool update-shell`
 and restart your shell.
 
+To upgrade a PyPI installation:
+
+```sh
+uv tool upgrade diffbutler
+```
+
+To install from a local checkout of this repository instead, run from its root:
+
+```sh
+uv tool install --python 3.14 .
+```
+
 Install and sign in to Codex CLI or Claude Code before requesting AI reviews.
 The native presets support Codex CLI or Claude Code on Linux and macOS without version checks.
 Reviews use your normal agent settings, including model and reasoning effort, with
@@ -161,6 +173,18 @@ data, and state directories, including review history, saved sessions, and diagn
 logs. Custom files outside those directories are preserved. Use `diffbutler reset --force`
 to skip confirmation. Run `diffbutler` again to repeat first-run setup.
 
+## Uninstall
+
+Remove the uv-installed command and its isolated environment:
+
+```sh
+uv tool uninstall diffbutler
+```
+
+This keeps your DiffButler configuration, review history, and diagnostic logs.
+To remove those too, run `diffbutler reset` **before uninstalling**; see
+[Reset](#reset) for what it deletes.
+
 ## Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and checks.

{diffbutler-0.5.0 → diffbutler-0.5.2}/README.md

@@ -10,17 +10,29 @@ finish your review in the browser.
 
 ## Install
 
-Install [uv](https://docs.astral.sh/uv/getting-started/installation/) and Git.
-From a local checkout of this repository, run:
+Install [uv](https://docs.astral.sh/uv/getting-started/installation/) and Git, then
+install DiffButler from [PyPI](https://pypi.org/project/diffbutler/):
 
 ```sh
-uv tool install --python 3.14 .
+uv tool install --python 3.14 diffbutler
 ```
 
 uv manages Python and dependencies in an isolated environment. No virtual environment
 activation is needed. If `diffbutler` is not on your PATH, run `uv tool update-shell`
 and restart your shell.
 
+To upgrade a PyPI installation:
+
+```sh
+uv tool upgrade diffbutler
+```
+
+To install from a local checkout of this repository instead, run from its root:
+
+```sh
+uv tool install --python 3.14 .
+```
+
 Install and sign in to Codex CLI or Claude Code before requesting AI reviews.
 The native presets support Codex CLI or Claude Code on Linux and macOS without version checks.
 Reviews use your normal agent settings, including model and reasoning effort, with
@@ -133,6 +145,18 @@ data, and state directories, including review history, saved sessions, and diagn
 logs. Custom files outside those directories are preserved. Use `diffbutler reset --force`
 to skip confirmation. Run `diffbutler` again to repeat first-run setup.
 
+## Uninstall
+
+Remove the uv-installed command and its isolated environment:
+
+```sh
+uv tool uninstall diffbutler
+```
+
+This keeps your DiffButler configuration, review history, and diagnostic logs.
+To remove those too, run `diffbutler reset` **before uninstalling**; see
+[Reset](#reset) for what it deletes.
+
 ## Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and checks.

{diffbutler-0.5.0 → diffbutler-0.5.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "diffbutler"
-version = "0.5.0"
+version = "0.5.2"
 description = "A terminal dashboard for human-directed AI code reviews."
 readme = "README.md"
 requires-python = ">=3.14"

{diffbutler-0.5.0 → diffbutler-0.5.2}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "diffbutler"
-version = "0.5.0"
+version = "0.5.2"
 description = "A terminal dashboard for human-directed AI code reviews."
 readme = "README.md"
 requires-python = ">=3.14"

{diffbutler-0.5.0 → diffbutler-0.5.2}/src/diffbutler/store/database.py

@@ -5,6 +5,7 @@ import sqlite3
 from contextlib import closing
 from dataclasses import dataclass
 from datetime import UTC, datetime
+from functools import partial
 from pathlib import Path
 from uuid import uuid4
 
@@ -56,6 +57,29 @@ def sqlite_url(value: str) -> URL:
     return url.set(database=str(Path(url.database).expanduser().absolute()))
 
 
+async def _finish[T](task: asyncio.Future[T]) -> tuple[T, bool]:
+    """Finish owned I/O despite cancellation, reporting it to the resource owner."""
+    cancelled = False
+    while not task.done():
+        try:
+            await asyncio.shield(task)
+        except asyncio.CancelledError:
+            cancelled = True
+    return task.result(), cancelled
+
+
+async def connect_sqlite(path: Path) -> aiosqlite.Connection:
+    # Cancelling aiosqlite's initial await can discard the connection its worker
+    # thread is still opening, before SQLAlchemy can own or dispose of it.
+    connection, cancelled = await _finish(
+        asyncio.ensure_future(aiosqlite.connect(path, check_same_thread=False))
+    )
+    if cancelled:
+        await _finish(asyncio.create_task(connection.close()))
+        raise asyncio.CancelledError
+    return connection
+
+
 async def configure_sqlite(connection: aiosqlite.Connection) -> None:
     """Enable WAL without blocking the event loop during startup contention."""
     try:
@@ -115,7 +139,9 @@ class Database:
         self.url = sqlite_url(url)
         assert self.url.database is not None
         self.path = Path(self.url.database)
-        self.engine: AsyncEngine = create_async_engine(self.url)
+        self.engine: AsyncEngine = create_async_engine(
+            self.url, async_creator=partial(connect_sqlite, self.path)
+        )
         event.listen(self.engine.sync_engine, "connect", _configure_sqlite)
         self.sessions = async_sessionmaker(self.engine, expire_on_commit=False)
 
@@ -160,13 +186,6 @@ class Database:
         # Cancellation during disposal can interrupt aiosqlite.close after the
         # pool has discarded the connection. Finish closing it before propagating
         # cancellation, including repeated cancellation during app shutdown.
-        closing = asyncio.create_task(self.engine.dispose())
-        cancelled = False
-        while not closing.done():
-            try:
-                await asyncio.shield(closing)
-            except asyncio.CancelledError:
-                cancelled = True
-        closing.result()
+        _, cancelled = await _finish(asyncio.create_task(self.engine.dispose()))
         if cancelled:
             raise asyncio.CancelledError