withcache 0.8.0__tar.gz → 0.8.1__tar.gz

{withcache-0.8.0 → withcache-0.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: withcache
-Version: 0.8.0
+Version: 0.8.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>
@@ -61,7 +61,7 @@ optional **operator-curated** model (`--curate`: a miss queue a human approves).
 
 | Path                          | What it is                                                  |
 |-------------------------------|-------------------------------------------------------------|
-| `src/withcache/server.py`     | The cache-host: blob store + miss table + **background download manager** + operator UI (Pico.css + HTMX) |
+| `src/withcache/server.py`     | The cache-host: blob store + miss table + **background download manager** + operator UI (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]` |
@@ -237,11 +237,13 @@ Notes & limits (all degrade gracefully; worst case is "no caching, curl still wo
 
 ## Operator UI
 
-`http://withcache-server:8081/` (Pico.css + HTMX, bundled offline) shows:
+`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.
+- **Streams**: in-flight stream-through-and-store fetches serving bytes to a client while writing to disk.
+- **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. The subnav Fetch form pre-seeds an artifact before anyone misses it.
 - **Misses**: auto-fetched by default, or (under `--curate`) each with **Download** (queues a background pull) and **Dismiss**.
-- **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.
-- **Cached artifacts**: URL, size, **hits** (times served) and **misses** (times requested before it was cached), SHA-256, fetched-at, each with **Delete** to free space.
-- **Add from URI**: pre-seed an artifact before anyone misses 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" input.
 
 ## Auth
 

{withcache-0.8.0 → withcache-0.8.1}/README.md

@@ -43,7 +43,7 @@ optional **operator-curated** model (`--curate`: a miss queue a human approves).
 
 | Path                          | What it is                                                  |
 |-------------------------------|-------------------------------------------------------------|
-| `src/withcache/server.py`     | The cache-host: blob store + miss table + **background download manager** + operator UI (Pico.css + HTMX) |
+| `src/withcache/server.py`     | The cache-host: blob store + miss table + **background download manager** + operator UI (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]` |
@@ -219,11 +219,13 @@ Notes & limits (all degrade gracefully; worst case is "no caching, curl still wo
 
 ## Operator UI
 
-`http://withcache-server:8081/` (Pico.css + HTMX, bundled offline) shows:
+`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.
+- **Streams**: in-flight stream-through-and-store fetches serving bytes to a client while writing to disk.
+- **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. The subnav Fetch form pre-seeds an artifact before anyone misses it.
 - **Misses**: auto-fetched by default, or (under `--curate`) each with **Download** (queues a background pull) and **Dismiss**.
-- **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.
-- **Cached artifacts**: URL, size, **hits** (times served) and **misses** (times requested before it was cached), SHA-256, fetched-at, each with **Delete** to free space.
-- **Add from URI**: pre-seed an artifact before anyone misses 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" input.
 
 ## Auth
 

{withcache-0.8.0 → withcache-0.8.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.8.0",
+    .version = "0.8.1",
     .fingerprint = 0xd7d96c5ed212ccaa,
     .minimum_zig_version = "0.16.0",
     .paths = .{

{withcache-0.8.0 → withcache-0.8.1}/src/withcache/__init__.py

@@ -17,6 +17,6 @@ All modules are stdlib-only and self-contained.
 from . import oras
 from .client import blob_url, cache_base, is_cached, serve_url
 
-__version__ = "0.8.0"
+__version__ = "0.8.1"
 
 __all__ = ["__version__", "blob_url", "cache_base", "is_cached", "oras", "serve_url"]

{withcache-0.8.0 → withcache-0.8.1}/src/withcache/server.py

@@ -6,7 +6,7 @@ their origin URL. By default a cache miss is auto-fetched: it is recorded in the
 miss table and pulled from origin in the background, so the next request hits
 (the client falls through to origin on the first miss). Run with `--curate` to
 require an operator to approve each pull via a small web UI instead; either way
-you can pre-seed an artifact with the "Add from URI" form.
+you can pre-seed an artifact with the Downloads-page Fetch form.
 
 This is the only component that needs internet egress (and any vendor creds).
 Clients never write to it.
@@ -180,12 +180,12 @@ def _serialise_catalog(entries: list[dict[str, Any]]) -> bytes:
 class CatalogState:
     """Live state of the fetched image catalog.
 
-    withcache does not run a background poller. The catalog is
-    fetched at process start (best-effort, persisted result from
-    the last successful fetch survives a restart), refetched
-    lazily when the dashboard renders and the in-memory copy is
-    older than :data:`CATALOG_CACHE_TTL`, and force-refetched by
-    the operator via the Refresh button (POST /admin/catalog_refresh).
+    withcache does not run a background poller and does not refetch
+    on a TTL. The catalog is fetched at process start (best-effort;
+    a persisted result from the last successful fetch survives a
+    restart) and force-refetched by the operator via the Refresh
+    button on the Catalog page (POST /admin/catalog_refresh); every
+    other render reads whatever is currently in memory.
 
     The raw TOML bytes are persisted to ``<data_dir>/catalog.toml``
     so a restart doesn't wipe the last known good catalog and the
@@ -1690,13 +1690,16 @@ class Handler(http.server.BaseHTTPRequestHandler):
         subnav_html: str,
         body_html: str,
     ) -> str:
+        brand_cls = "navbar-brand fw-semibold"
+        if nav_active == "cached":
+            brand_cls += " brand-active"
         return f"""{self._head(title)}
 <body class="bg-light">
 <div class="sticky-header">
 <div class="brand-accent"></div>
 <nav class="navbar navbar-expand-md bg-dark navbar-dark py-2">
     <div class="container">
-        <a class="navbar-brand fw-semibold" href="/ui/cached">
+        <a class="{brand_cls}" href="/ui/cached">
             <i class="bi bi-database brand-icon me-1"></i>WITHCACHE
         </a>
         <div class="d-flex flex-grow-1 align-items-center flex-wrap">
@@ -1884,7 +1887,7 @@ class Handler(http.server.BaseHTTPRequestHandler):
             '<input class="form-control form-control-sm" type="url" name="url" '
             'style="width: 22rem;" '
             'placeholder="https://origin/path/artifact.tar.gz" required>'
-            '<button class="btn btn-sm btn-primary" type="submit" title="Add from URI"'
+            '<button class="btn btn-sm btn-primary" type="submit" title="Fetch URI"'
             ">Fetch</button>"
             "</form>"
         )

{withcache-0.8.0 → withcache-0.8.1}/tests/test_withcache.py

@@ -1062,10 +1062,10 @@ class TestMultiPageNavigation(unittest.TestCase):
                 self.assertIn(f'id="{key}-fragment"', body)
                 self.assertIn('class="nav-btn active"', body)
 
-    def test_downloads_subnav_has_add_from_uri(self):
+    def test_downloads_subnav_has_fetch_form(self):
         body = self._get("/ui/downloads")
         self.assertIn('hx-post="/admin/fetch"', body)
-        self.assertIn("Add from URI", body)
+        self.assertIn(">Fetch</button>", body)
 
     def test_catalog_subnav_has_url_and_oras_forms(self):
         body = self._get("/ui/catalog")