withcache 0.6.3__tar.gz → 0.6.5__tar.gz

{withcache-0.6.3 → withcache-0.6.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: withcache
-Version: 0.6.3
+Version: 0.6.5
 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>
@@ -100,13 +100,13 @@ asserts the binary and the Python `plan()` rewrite argv identically.
 ```sh
 export WITHCACHE_ADMIN_PASSWORD=change-me    # protects the operator UI
 podman compose -f deploy/compose.yml up -d   # or: docker compose -f ...
-# operator UI:  http://withcache-server:3000/
+# operator UI:  http://withcache-server:8081/
 ```
 
 Or without containers:
 
 ```sh
-WITHCACHE_ADMIN_PASSWORD=change-me withcache-server --data-dir ./data --port 3000
+WITHCACHE_ADMIN_PASSWORD=change-me withcache-server --data-dir ./data --port 8081
 ```
 
 Data (blobs + `cache.db` + `session-secret`) lives in the `/data` volume (or
@@ -137,7 +137,7 @@ Nothing is renamed; you opt in per command. Good for trying it out or a script
 you can edit.
 
 ```sh
-export WITHCACHE_SERVER=http://withcache-server:3000
+export WITHCACHE_SERVER=http://withcache-server:8081
 curlwithcache -fsSL https://the/origin/cuda.tar.gz -o cuda.tar.gz
 wgetwithcache https://the/origin/rocm.tar.gz
 ```
@@ -152,7 +152,7 @@ mkdir -p ~/.withcache/bin
 ln -sf "$(command -v curlwithcache)" ~/.withcache/bin/curl
 ln -sf "$(command -v wgetwithcache)" ~/.withcache/bin/wget
 
-export WITHCACHE_SERVER=http://withcache-server:3000
+export WITHCACHE_SERVER=http://withcache-server:8081
 export PATH="$HOME/.withcache/bin:$PATH"
 hash -r                       # forget any cached curl/wget location
 
@@ -174,7 +174,7 @@ ln -sf "$(command -v wgetwithcache)" ~/.withcache/bin/wget
 cat >> ~/.bashrc <<'EOF'
 
 # withcache: transparent curl/wget caching
-export WITHCACHE_SERVER=http://withcache-server:3000
+export WITHCACHE_SERVER=http://withcache-server:8081
 export PATH="$HOME/.withcache/bin:$PATH"
 EOF
 ```
@@ -186,7 +186,7 @@ inside that directory.
 
 ```sh
 # .envrc
-export WITHCACHE_SERVER=http://withcache-server:3000
+export WITHCACHE_SERVER=http://withcache-server:8081
 PATH_add ~/.withcache/bin        # assumes the symlinks from approach 2/3 exist
 ```
 
@@ -204,7 +204,7 @@ sudo ln -sf "$(command -v wgetwithcache)" /usr/local/bin/wget
 
 # A login-shell env file (covers interactive logins; daemons started outside a
 # login shell won't see it; set WITHCACHE_SERVER in their unit if you need it).
-echo 'export WITHCACHE_SERVER=http://withcache-server:3000' \
+echo 'export WITHCACHE_SERVER=http://withcache-server:8081' \
   | sudo tee /etc/profile.d/withcache.sh >/dev/null
 ```
 
@@ -237,7 +237,7 @@ Notes & limits (all degrade gracefully; worst case is "no caching, curl still wo
 
 ## Operator UI
 
-`http://withcache-server:3000/` (Pico.css + HTMX, bundled offline) shows:
+`http://withcache-server:8081/` (Pico.css + HTMX, bundled offline) shows:
 - **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.
@@ -276,7 +276,7 @@ scheme. `withcache.client` is stdlib-only, so importing it adds no dependencies:
 from withcache import client
 
 # "use the cache when it's warm, the origin otherwise"
-url = client.serve_url("http://cache:3000", origin) or origin
+url = client.serve_url("http://cache:8081", origin) or origin
 ```
 
 `is_cached()` is a graceful `HEAD` (a miss, timeout, or unreachable cache all

{withcache-0.6.3 → withcache-0.6.5}/README.md

@@ -82,13 +82,13 @@ asserts the binary and the Python `plan()` rewrite argv identically.
 ```sh
 export WITHCACHE_ADMIN_PASSWORD=change-me    # protects the operator UI
 podman compose -f deploy/compose.yml up -d   # or: docker compose -f ...
-# operator UI:  http://withcache-server:3000/
+# operator UI:  http://withcache-server:8081/
 ```
 
 Or without containers:
 
 ```sh
-WITHCACHE_ADMIN_PASSWORD=change-me withcache-server --data-dir ./data --port 3000
+WITHCACHE_ADMIN_PASSWORD=change-me withcache-server --data-dir ./data --port 8081
 ```
 
 Data (blobs + `cache.db` + `session-secret`) lives in the `/data` volume (or
@@ -119,7 +119,7 @@ Nothing is renamed; you opt in per command. Good for trying it out or a script
 you can edit.
 
 ```sh
-export WITHCACHE_SERVER=http://withcache-server:3000
+export WITHCACHE_SERVER=http://withcache-server:8081
 curlwithcache -fsSL https://the/origin/cuda.tar.gz -o cuda.tar.gz
 wgetwithcache https://the/origin/rocm.tar.gz
 ```
@@ -134,7 +134,7 @@ mkdir -p ~/.withcache/bin
 ln -sf "$(command -v curlwithcache)" ~/.withcache/bin/curl
 ln -sf "$(command -v wgetwithcache)" ~/.withcache/bin/wget
 
-export WITHCACHE_SERVER=http://withcache-server:3000
+export WITHCACHE_SERVER=http://withcache-server:8081
 export PATH="$HOME/.withcache/bin:$PATH"
 hash -r                       # forget any cached curl/wget location
 
@@ -156,7 +156,7 @@ ln -sf "$(command -v wgetwithcache)" ~/.withcache/bin/wget
 cat >> ~/.bashrc <<'EOF'
 
 # withcache: transparent curl/wget caching
-export WITHCACHE_SERVER=http://withcache-server:3000
+export WITHCACHE_SERVER=http://withcache-server:8081
 export PATH="$HOME/.withcache/bin:$PATH"
 EOF
 ```
@@ -168,7 +168,7 @@ inside that directory.
 
 ```sh
 # .envrc
-export WITHCACHE_SERVER=http://withcache-server:3000
+export WITHCACHE_SERVER=http://withcache-server:8081
 PATH_add ~/.withcache/bin        # assumes the symlinks from approach 2/3 exist
 ```
 
@@ -186,7 +186,7 @@ sudo ln -sf "$(command -v wgetwithcache)" /usr/local/bin/wget
 
 # A login-shell env file (covers interactive logins; daemons started outside a
 # login shell won't see it; set WITHCACHE_SERVER in their unit if you need it).
-echo 'export WITHCACHE_SERVER=http://withcache-server:3000' \
+echo 'export WITHCACHE_SERVER=http://withcache-server:8081' \
   | sudo tee /etc/profile.d/withcache.sh >/dev/null
 ```
 
@@ -219,7 +219,7 @@ Notes & limits (all degrade gracefully; worst case is "no caching, curl still wo
 
 ## Operator UI
 
-`http://withcache-server:3000/` (Pico.css + HTMX, bundled offline) shows:
+`http://withcache-server:8081/` (Pico.css + HTMX, bundled offline) shows:
 - **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.
@@ -258,7 +258,7 @@ scheme. `withcache.client` is stdlib-only, so importing it adds no dependencies:
 from withcache import client
 
 # "use the cache when it's warm, the origin otherwise"
-url = client.serve_url("http://cache:3000", origin) or origin
+url = client.serve_url("http://cache:8081", origin) or origin
 ```
 
 `is_cached()` is a graceful `HEAD` (a miss, timeout, or unreachable cache all

{withcache-0.6.3 → withcache-0.6.5}/deploy/Containerfile

@@ -17,7 +17,7 @@ RUN useradd --create-home --uid 10001 app \
  && mkdir -p /data && chown app:app /data
 USER app
 
-EXPOSE 3000
+EXPOSE 8081
 VOLUME ["/data"]
 
 # Set WITHCACHE_ADMIN_PASSWORD at run time to protect the operator UI.
@@ -25,6 +25,6 @@ VOLUME ["/data"]
 # with WITHCACHE_SESSION_SECRET.
 
 HEALTHCHECK --interval=30s --timeout=3s --start-period=5s \
-  CMD python -c "import urllib.request,sys; sys.exit(0 if urllib.request.urlopen('http://127.0.0.1:3000/healthz',timeout=2).status==200 else 1)"
+  CMD python -c "import urllib.request,sys; sys.exit(0 if urllib.request.urlopen('http://127.0.0.1:8081/healthz',timeout=2).status==200 else 1)"
 
-ENTRYPOINT ["withcache-server", "--host", "0.0.0.0", "--port", "3000", "--data-dir", "/data"]
+ENTRYPOINT ["withcache-server", "--host", "0.0.0.0", "--port", "8081", "--data-dir", "/data"]

{withcache-0.6.3 → withcache-0.6.5}/deploy/compose.yml

@@ -9,7 +9,7 @@ services:
     image: withcache:latest
     container_name: withcache
     ports:
-      - "3000:3000"
+      - "8081:8081"
     environment:
       # Protect the operator UI. Unset => UI is open (a warning is logged).
       - WITHCACHE_ADMIN_PASSWORD=${WITHCACHE_ADMIN_PASSWORD:-}

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

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

{withcache-0.6.3 → withcache-0.6.5}/src/withcache/_shim.py

@@ -26,7 +26,7 @@ _SCHEME = re.compile(r"^[a-zA-Z][a-zA-Z0-9+.\-]*://")
 
 
 def cache_base(server: str) -> str:
-    """Accept 'host', 'host:3000', or 'http://withcache-server:3000'."""
+    """Accept 'host', 'host:8081', or 'http://withcache-server:8081'."""
     server = server.strip().rstrip("/")
     if "://" not in server:
         server = "http://" + server

{withcache-0.6.3 → withcache-0.6.5}/src/withcache/client.py

@@ -7,7 +7,7 @@ dependencies.
     from withcache import client
 
     # "use the cache when it's warm, the origin otherwise"
-    url = client.serve_url("http://cache:3000", origin) or origin
+    url = client.serve_url("http://cache:8081", origin) or origin
 
 The ``/b/<urlsafe-b64(origin)>/<basename>`` encoding is shared with the shims
 and the server (one definition in :mod:`withcache._shim`), so consumers stay in
@@ -25,7 +25,7 @@ __all__ = ["PROBE_TIMEOUT", "blob_url", "cache_base", "is_cached", "serve_url"]
 
 PROBE_TIMEOUT = 3.0  # seconds; never block the caller on a slow/unreachable cache
 
-#: Normalize a server value: accepts 'host', 'host:3000', or 'http://host:3000'.
+#: Normalize a server value: accepts 'host', 'host:8081', or 'http://host:8081'.
 cache_base = _shim.cache_base
 
 

{withcache-0.6.3 → withcache-0.6.5}/src/withcache/curlwithcache.py

@@ -7,7 +7,7 @@ withcache cache-host and the artifact is cached there, the download is served
 from the cache; otherwise — server unset, not cached, or unreachable — your curl
 runs exactly as written. Existing scripts need no changes.
 
-    export WITHCACHE_SERVER=http://withcache-server:3000
+    export WITHCACHE_SERVER=http://withcache-server:8081
     curl -fsSL https://the/origin/cuda.tar.gz -o cuda.tar.gz   # cache hit -> local
 
 It wraps the system curl, so all curl flags keep working; on a miss it hands