withcache 0.11.1__tar.gz → 0.13.0__tar.gz

{withcache-0.11.1 → withcache-0.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: withcache
-Version: 0.11.1
+Version: 0.13.0
 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>

{withcache-0.11.1 → withcache-0.13.0}/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.11.1",
+    .version = "0.13.0",
     .fingerprint = 0xd7d96c5ed212ccaa,
     .minimum_zig_version = "0.16.0",
     .paths = .{

{withcache-0.11.1 → withcache-0.13.0}/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.11.1"
+__version__ = "0.13.0"
 
 __all__ = ["__version__", "blob_url", "cache_base", "is_cached", "oras", "serve_url"]

{withcache-0.11.1 → withcache-0.13.0}/src/withcache/_api.py

@@ -30,6 +30,7 @@ Downloads page shows in-flight transfers as they run.
 from __future__ import annotations
 
 import base64
+import contextlib
 import urllib.parse
 from collections.abc import Iterator
 from typing import Any
@@ -88,7 +89,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",