withcache 0.12.0__tar.gz → 0.13.1__tar.gz

{withcache-0.12.0 → withcache-0.13.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: withcache
-Version: 0.12.0
+Version: 0.13.1
 Summary: Operator-curated, URL-keyed artifact cache for a small lab (CUDA/ROCm/DOCA/firmware)
 Project-URL: Homepage, https://github.com/safl/withcache
 Author-email: "Simon A. F. Lund" <safl@safl.dk>
@@ -68,14 +68,16 @@ disk.
 
 | Path                          | What it is                                                  |
 |-------------------------------|-------------------------------------------------------------|
-| `src/withcache/server.py`     | The cache-host: blob store + miss table + **background download manager** + operator UI (Bootstrap 5 + Bootstrap Icons + HTMX) |
+| `src/withcache/server.py`     | The cache-host: blob store + miss table + **background download manager** + events log |
+| `src/withcache/_app.py`       | FastAPI app factory + operator UI wiring (Bootstrap 5 + Bootstrap Icons + HTMX) |
 | `src/withcache/_shim.py`      | Shared shim core (find URL → probe → rewrite → exec)        |
 | `src/withcache/curlwithcache.py` / `wgetwithcache.py` | The Python `curl` / `wget` shims    |
 | `shim/shim.zig`               | The native shim: one static binary, both tools via `argv[0]` |
 | `deploy/Containerfile`, `deploy/compose.yml` | Single Podman/Docker host deploy             |
 
-The cache-host and the Python shims are **stdlib-only** (no third-party runtime
-deps); the native shim is a dependency-free static binary.
+The cache-host runs on FastAPI + Jinja + Bootstrap (matching bty +
+nbdmux for one trio-consistent chrome); the shims (Python and
+native) are dependency-free so they drop into any environment.
 
 ## Install
 
@@ -245,11 +247,11 @@ Notes & limits (all degrade gracefully; worst case is "no caching, curl still wo
 
 `http://withcache-server:8081/` (Bootstrap 5 + Bootstrap Icons + HTMX, bundled
 offline; matches bty's chrome for a consistent trio) is a five-page dashboard:
-- **Cached** (landing): URL, size, **hits** (times served) and **misses** (times requested before it was cached), SHA-256, fetched-at, each with **Delete** to free space.
-- **Downloads**: live progress bars, `queued/running/completed/cancelled/failed`, **Cancel**, and **Clear finished**. Downloads run in a background worker pool, not in the request, so large pulls never block, modelled on [bty]'s job managers.
+- **Dashboard** (landing): catalog + cache + activity summary, health checklist, and the last N audit events.
+- **Catalog**: image catalog fetched from a nosi-style `catalog.toml` (URL configured on Settings > Catalog source). Add entries via the subnav's inline "Add ORAS" / "Add HTTPS" forms or "Fetch default" button, then **Download** each entry. Rows carry hits, size, download progress (live), and cached/failed pills.
 - **Misses**: URLs clients asked for that aren't downloaded yet. Each with **Fetch** (promotes to a catalog entry AND downloads it) and **Dismiss** (forget it).
-- **Catalog**: image catalog fetched from a nosi-style `catalog.toml` (URL configurable via `$WITHCACHE_CATALOG_URL` or the subnav Set&fetch input); pre-seed by URL via the "Add image from oras" or "Add HTTPS entry" forms, then **Download** each entry.
-- **Settings**: identity + storage paths + catalog source + logging (uvicorn level) + auth.
+- **Events**: append-only audit log with a free-text filter and per-page pagination. Failure rows carry an ack button; the dashboard's Health tripwire flags unacknowledged failures.
+- **Settings**: identity + storage paths + catalog source (editable) + logging (uvicorn level) + auth.
 
 ## Auth
 

{withcache-0.12.0 → withcache-0.13.1}/README.md

@@ -45,14 +45,16 @@ disk.
 
 | Path                          | What it is                                                  |
 |-------------------------------|-------------------------------------------------------------|
-| `src/withcache/server.py`     | The cache-host: blob store + miss table + **background download manager** + operator UI (Bootstrap 5 + Bootstrap Icons + HTMX) |
+| `src/withcache/server.py`     | The cache-host: blob store + miss table + **background download manager** + events log |
+| `src/withcache/_app.py`       | FastAPI app factory + operator UI wiring (Bootstrap 5 + Bootstrap Icons + HTMX) |
 | `src/withcache/_shim.py`      | Shared shim core (find URL → probe → rewrite → exec)        |
 | `src/withcache/curlwithcache.py` / `wgetwithcache.py` | The Python `curl` / `wget` shims    |
 | `shim/shim.zig`               | The native shim: one static binary, both tools via `argv[0]` |
 | `deploy/Containerfile`, `deploy/compose.yml` | Single Podman/Docker host deploy             |
 
-The cache-host and the Python shims are **stdlib-only** (no third-party runtime
-deps); the native shim is a dependency-free static binary.
+The cache-host runs on FastAPI + Jinja + Bootstrap (matching bty +
+nbdmux for one trio-consistent chrome); the shims (Python and
+native) are dependency-free so they drop into any environment.
 
 ## Install
 
@@ -222,11 +224,11 @@ Notes & limits (all degrade gracefully; worst case is "no caching, curl still wo
 
 `http://withcache-server:8081/` (Bootstrap 5 + Bootstrap Icons + HTMX, bundled
 offline; matches bty's chrome for a consistent trio) is a five-page dashboard:
-- **Cached** (landing): URL, size, **hits** (times served) and **misses** (times requested before it was cached), SHA-256, fetched-at, each with **Delete** to free space.
-- **Downloads**: live progress bars, `queued/running/completed/cancelled/failed`, **Cancel**, and **Clear finished**. Downloads run in a background worker pool, not in the request, so large pulls never block, modelled on [bty]'s job managers.
+- **Dashboard** (landing): catalog + cache + activity summary, health checklist, and the last N audit events.
+- **Catalog**: image catalog fetched from a nosi-style `catalog.toml` (URL configured on Settings > Catalog source). Add entries via the subnav's inline "Add ORAS" / "Add HTTPS" forms or "Fetch default" button, then **Download** each entry. Rows carry hits, size, download progress (live), and cached/failed pills.
 - **Misses**: URLs clients asked for that aren't downloaded yet. Each with **Fetch** (promotes to a catalog entry AND downloads it) and **Dismiss** (forget it).
-- **Catalog**: image catalog fetched from a nosi-style `catalog.toml` (URL configurable via `$WITHCACHE_CATALOG_URL` or the subnav Set&fetch input); pre-seed by URL via the "Add image from oras" or "Add HTTPS entry" forms, then **Download** each entry.
-- **Settings**: identity + storage paths + catalog source + logging (uvicorn level) + auth.
+- **Events**: append-only audit log with a free-text filter and per-page pagination. Failure rows carry an ack button; the dashboard's Health tripwire flags unacknowledged failures.
+- **Settings**: identity + storage paths + catalog source (editable) + logging (uvicorn level) + auth.
 
 ## Auth
 

{withcache-0.12.0 → withcache-0.13.1}/shim/build.zig.zon

@@ -2,7 +2,7 @@
     .name = .withcache_shim,
     // Zig requires a literal here; keep it in lockstep with the project's
     // single source (src/withcache/__init__.py) via `make bump` / `make version-check`.
-    .version = "0.12.0",
+    .version = "0.13.1",
     .fingerprint = 0xd7d96c5ed212ccaa,
     .minimum_zig_version = "0.16.0",
     .paths = .{

{withcache-0.12.0 → withcache-0.13.1}/src/withcache/__init__.py

@@ -22,6 +22,6 @@ inherit the framework floor.
 from . import oras
 from .client import blob_url, cache_base, is_cached, serve_url
 
-__version__ = "0.12.0"
+__version__ = "0.13.1"
 
 __all__ = ["__version__", "blob_url", "cache_base", "is_cached", "oras", "serve_url"]

{withcache-0.12.0 → withcache-0.13.1}/src/withcache/_api.py

@@ -22,14 +22,17 @@ v0.11.0) promotes a missed URL to a catalog entry + enqueues the
 Download in one click.
 
 Streaming shape: FastAPI ``StreamingResponse`` with a generator
-that reads chunks from the on-disk blob at 64 KiB reads;
-:class:`StreamRegistry` ticks progress per chunk so the operator
-Downloads page shows in-flight transfers as they run.
+that reads chunks from the on-disk blob at 64 KiB reads. The
+Downloads-page real-time progress tracker was retired in v0.12.0
+along with that page; per-entry download progress now folds into
+the Catalog page's Downloaded column, populated from the
+DownloadManager's job list directly.
 """
 
 from __future__ import annotations
 
 import base64
+import contextlib
 import urllib.parse
 from collections.abc import Iterator
 from typing import Any
@@ -88,7 +91,27 @@ def _serve_blob(
         row = None
 
     if row is None:
-        store.record_miss(url)
+        fresh = store.record_miss(url)
+        if fresh:
+            # First miss for this URL: emit an audit event so the
+            # operator sees it on /ui/events. Subsequent misses for
+            # the same URL bump the counter without re-emitting.
+            from . import _events_log
+
+            with contextlib.suppress(Exception):
+                with store.conn() as ev_conn:
+                    _events_log.record(
+                        ev_conn,
+                        kind="blob.miss.recorded",
+                        summary=f"First cache miss for {url}",
+                        subject_kind="blob",
+                        subject_id=url,
+                        actor="client",
+                        source_ip=_events_log.normalize_ip(
+                            request.client.host if request.client else None
+                        ),
+                    )
+                    ev_conn.commit()
         return PlainTextResponse(
             "cache miss: this URL hasn't been downloaded yet. "
             "Pick the matching catalog entry on /ui/catalog and hit Download.\n",