fetchurl-sdk 0.2.0__tar.gz → 0.2.2__tar.gz

fetchurl_sdk-0.2.2/.github/workflows/autorelease.yml

@@ -0,0 +1,76 @@
+name: Autorelease
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      new_version:
+        description: "Version bump mode (svu) or explicit x.y.z"
+        type: choice
+        default: next
+        options: [next, patch, minor, major]
+
+jobs:
+  autorelease:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5.0.1
+        with:
+          fetch-depth: 0
+
+      - name: Setup git config
+        run: |
+          git config user.name actions-bot
+          git config user.email actions-bot@users.noreply.github.com
+
+      - uses: jdx/mise-action@6d1e696aa24c1aa1bcc1adea0212707c71ab78a8 # v3
+
+      - name: Sync deps
+        run: uv sync --extra test
+
+      - name: Unit tests
+        run: uv run python -m unittest test_fetchurl.py
+
+      - name: Integration tests (optional)
+        if: vars.FETCHURL_TEST_IMAGE != ''
+        env:
+          FETCHURL_TEST_IMAGE: ${{ vars.FETCHURL_TEST_IMAGE }}
+        run: uv run --extra test python -m unittest test_fetchurl_integration.py
+        continue-on-error: true
+
+      - name: Prepare release (svu, commit, local tag)
+        if: github.event_name == 'workflow_dispatch'
+        env:
+          NEW_VERSION: ${{ github.event.inputs.new_version }}
+        run: |
+          VERSION="$(./make_release prepare "$NEW_VERSION")"
+          echo "RELEASE_VERSION=$VERSION" >> "$GITHUB_ENV"
+          echo "Prepared $VERSION (not pushed until publish succeeds)" >> "$GITHUB_STEP_SUMMARY"
+
+      - name: Build
+        if: env.RELEASE_VERSION != ''
+        run: uv build
+
+      - name: Publish to PyPI
+        if: env.RELEASE_VERSION != ''
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_TOKEN }}
+        run: |
+          if [[ -z "${UV_PUBLISH_TOKEN:-}" ]]; then
+            echo "PYPI_TOKEN not set; trying trusted publishing (OIDC)..."
+            uv publish
+          else
+            uv publish --token "$UV_PUBLISH_TOKEN"
+          fi
+
+      - name: Push commit, tag, and GitHub release
+        if: env.RELEASE_VERSION != ''
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: ./make_release push "$RELEASE_VERSION"

fetchurl_sdk-0.2.2/.gitignore

@@ -0,0 +1 @@
+__pycache__/

fetchurl_sdk-0.2.2/.svu.yml

@@ -0,0 +1,2 @@
+tag.prefix: ""
+v0: true

fetchurl_sdk-0.2.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lucas Eduardo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fetchurl_sdk-0.2.2/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: fetchurl-sdk
+Version: 0.2.2
+Summary: Protocol-level client SDK for fetchurl content-addressable cache servers
+Project-URL: Homepage, https://pypi.org/project/fetchurl-sdk/
+Project-URL: Repository, https://github.com/fetchurl/sdk-python
+Project-URL: Bug Tracker, https://github.com/fetchurl/sdk-python/issues
+Author: lucasew
+License: MIT
+License-File: LICENSE
+Keywords: cache,content-addressable,fetchurl,hash,sha256
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Provides-Extra: test
+Requires-Dist: httpx>=0.27.0; extra == 'test'
+Requires-Dist: testcontainers>=3.7.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# fetchurl Python SDK
+
+Protocol-level client for [fetchurl](https://github.com/fetchurl/spec) content-addressable cache servers.
+
+Zero runtime dependencies — uses only the Python standard library. Works with any HTTP library via `Fetcher` / `AsyncFetcher` protocols.
+
+## Install
+
+```bash
+pip install fetchurl-sdk
+# or
+uv add fetchurl-sdk
+```
+
+## Protocol
+
+Normative behavior: **[fetchurl/spec](https://github.com/fetchurl/spec)** (`SPEC.md`).
+
+Reference server: **[fetchurl/fetchurl](https://github.com/fetchurl/fetchurl)**.
+
+## Usage
+
+```python
+from fetchurl import fetch, UrllibFetcher, parse_fetchurl_server
+import os
+
+servers = parse_fetchurl_server(os.environ.get("FETCHURL_SERVER", ""))
+# Or drive FetchSession yourself with your HTTP client — see package docstring.
+```
+
+Clients **must** treat the server as untrusted and verify the hash (this SDK does that for you).
+
+## Environment
+
+| Variable | Meaning |
+|----------|---------|
+| `FETCHURL_SERVER` | Server base URL(s) per the [spec](https://github.com/fetchurl/spec/blob/main/SPEC.md). Empty/absent disables server use. |
+
+## Development
+
+```bash
+uv sync --dev
+uv run python -m unittest test_fetchurl.py
+# Integration (Docker + image):
+# FETCHURL_TEST_IMAGE=fetchurl:local uv run --extra test python -m unittest test_fetchurl_integration.py
+```
+
+## Related
+
+| Repo | Role |
+|------|------|
+| [fetchurl/spec](https://github.com/fetchurl/spec) | Protocol |
+| [fetchurl/fetchurl](https://github.com/fetchurl/fetchurl) | Go server |
+| [fetchurl/sdk-js](https://github.com/fetchurl/sdk-js) | JavaScript SDK |
+| [fetchurl/sdk-rust](https://github.com/fetchurl/sdk-rust) | Rust SDK |

fetchurl_sdk-0.2.2/README.md

@@ -0,0 +1,55 @@
+# fetchurl Python SDK
+
+Protocol-level client for [fetchurl](https://github.com/fetchurl/spec) content-addressable cache servers.
+
+Zero runtime dependencies — uses only the Python standard library. Works with any HTTP library via `Fetcher` / `AsyncFetcher` protocols.
+
+## Install
+
+```bash
+pip install fetchurl-sdk
+# or
+uv add fetchurl-sdk
+```
+
+## Protocol
+
+Normative behavior: **[fetchurl/spec](https://github.com/fetchurl/spec)** (`SPEC.md`).
+
+Reference server: **[fetchurl/fetchurl](https://github.com/fetchurl/fetchurl)**.
+
+## Usage
+
+```python
+from fetchurl import fetch, UrllibFetcher, parse_fetchurl_server
+import os
+
+servers = parse_fetchurl_server(os.environ.get("FETCHURL_SERVER", ""))
+# Or drive FetchSession yourself with your HTTP client — see package docstring.
+```
+
+Clients **must** treat the server as untrusted and verify the hash (this SDK does that for you).
+
+## Environment
+
+| Variable | Meaning |
+|----------|---------|
+| `FETCHURL_SERVER` | Server base URL(s) per the [spec](https://github.com/fetchurl/spec/blob/main/SPEC.md). Empty/absent disables server use. |
+
+## Development
+
+```bash
+uv sync --dev
+uv run python -m unittest test_fetchurl.py
+# Integration (Docker + image):
+# FETCHURL_TEST_IMAGE=fetchurl:local uv run --extra test python -m unittest test_fetchurl_integration.py
+```
+
+## Related
+
+| Repo | Role |
+|------|------|
+| [fetchurl/spec](https://github.com/fetchurl/spec) | Protocol |
+| [fetchurl/fetchurl](https://github.com/fetchurl/fetchurl) | Go server |
+| [fetchurl/sdk-js](https://github.com/fetchurl/sdk-js) | JavaScript SDK |
+| [fetchurl/sdk-rust](https://github.com/fetchurl/sdk-rust) | Rust SDK |

fetchurl_sdk-0.2.2/make_release

@@ -0,0 +1,193 @@
+#!/usr/bin/env -S python3 -u
+"""Bump version (svu), commit + tag locally. Push only via `push` after publish succeeds."""
+from __future__ import annotations
+
+import argparse
+import re
+import subprocess
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent
+MANIFEST = ROOT / "pyproject.toml"
+MANIFEST_PATHS = [str(MANIFEST.relative_to(ROOT))]
+SVU_MODES = frozenset({"next", "major", "minor", "patch"})
+UPLOAD_GLOB: str | None = None
+VERSION_RE = re.compile(r'^version\s*=\s*"[^"]*"', re.M)
+
+
+def log(msg: str) -> None:
+    print(msg, file=sys.stderr)
+
+
+def run(cmd: list[str], *, check: bool = True, capture: bool = False) -> subprocess.CompletedProcess:
+    return subprocess.run(cmd, cwd=ROOT, check=check, text=True, capture_output=capture)
+
+
+def run_out(cmd: list[str]) -> str:
+    return run(cmd, capture=True).stdout.strip()
+
+
+def resolve_version(mode: str) -> str:
+    mode = mode.lstrip("v")
+    if mode in SVU_MODES:
+        return run_out(["svu", mode]).lstrip("v")
+    return mode
+
+
+def write_manifest(version: str) -> None:
+    text = MANIFEST.read_text(encoding="utf-8")
+    if not VERSION_RE.search(text):
+        raise SystemExit('version = "..." not found in pyproject.toml')
+    MANIFEST.write_text(VERSION_RE.sub(f'version = "{version}"', text, count=1), encoding="utf-8")
+
+
+def read_manifest_version() -> str:
+    m = re.search(r'^version\s*=\s*"([^"]+)"', MANIFEST.read_text(encoding="utf-8"), re.M)
+    if not m:
+        raise SystemExit("could not read version from pyproject.toml")
+    return m.group(1)
+
+def git_commit_and_tag(version: str, paths: list[str]) -> None:
+    # Never let git write to stdout — CI captures only the version line from prepare.
+    if paths:
+        run(["git", "add", *paths], capture=True)
+    else:
+        run(["git", "add", "-A"], capture=True)
+    staged = run(["git", "diff", "--cached", "--quiet"], check=False, capture=True)
+    if staged.returncode != 0:
+        cp = run(["git", "commit", "-sm", f"bump to {version}"], capture=True)
+        if cp.stdout:
+            log(cp.stdout.rstrip())
+        if cp.stderr:
+            log(cp.stderr.rstrip())
+    else:
+        log("nothing to commit (manifest unchanged?)")
+    exists = run(["git", "rev-parse", "-q", "--verify", f"refs/tags/{version}"], check=False, capture=True)
+    if exists.returncode == 0:
+        run(["git", "tag", "-f", version], capture=True)
+        log(f"moved local tag {version}")
+    else:
+        run(["git", "tag", version], capture=True)
+        log(f"created local tag {version}")
+
+
+def push_release(version: str, *, upload_glob: str | None = None) -> None:
+    """Push branch + tag and create GitHub release. Call only after registry publish succeeds."""
+    branch = run_out(["git", "rev-parse", "--abbrev-ref", "HEAD"])
+    for cmd in (
+        ["git", "push", "origin", f"HEAD:{branch}"],
+        ["git", "push", "origin", version],
+    ):
+        cp = run(cmd, capture=True)
+        if cp.stdout:
+            log(cp.stdout.rstrip())
+        if cp.stderr:
+            log(cp.stderr.rstrip())
+    chk = run(["gh", "release", "view", version], check=False, capture=True)
+    if chk.returncode == 0:
+        log(f"GitHub release {version} already exists")
+    else:
+        cp = run(
+            [
+                "gh",
+                "release",
+                "create",
+                version,
+                "--title",
+                f"Release {version}",
+                "--generate-notes",
+            ],
+            capture=True,
+        )
+        if cp.stdout:
+            log(cp.stdout.rstrip())
+        if cp.stderr:
+            log(cp.stderr.rstrip())
+    if upload_glob:
+        paths = sorted(ROOT.glob(upload_glob))
+        if paths:
+            cp = run(
+                ["gh", "release", "upload", version, *[str(p) for p in paths], "--clobber"],
+                capture=True,
+            )
+            if cp.stdout:
+                log(cp.stdout.rstrip())
+            if cp.stderr:
+                log(cp.stderr.rstrip())
+    log(f"pushed commit + tag + release {version}")
+
+
+def build_parser() -> argparse.ArgumentParser:
+    p = argparse.ArgumentParser(
+        prog="./make_release",
+        description=(
+            "Bump version with svu, commit and tag locally. "
+            "Push commit/tag/GitHub release only via the push subcommand "
+            "(run after a successful registry publish)."
+        ),
+    )
+    sub = p.add_subparsers(dest="command", required=True)
+
+    prep = sub.add_parser(
+        "prepare",
+        help="svu → write manifest → local commit + local tag (no remote push)",
+    )
+    prep.add_argument(
+        "mode",
+        nargs="?",
+        default="next",
+        help="svu mode (next|major|minor|patch) or explicit x.y.z (default: next)",
+    )
+
+    push_p = sub.add_parser(
+        "push",
+        help="push branch + tag and create GitHub release (after successful publish)",
+    )
+    push_p.add_argument(
+        "version",
+        nargs="?",
+        default=None,
+        help="semver to push (default: version from manifest)",
+    )
+
+    for mode in sorted(SVU_MODES):
+        sp = sub.add_parser(mode, help=f"shorthand for: prepare {mode}")
+        sp.set_defaults(command="prepare", mode=mode)
+
+    return p
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser()
+    args_list = list(sys.argv[1:] if argv is None else argv)
+    # Bare semver → prepare <semver>
+    if (
+        args_list
+        and args_list[0] not in ("prepare", "push", "-h", "--help")
+        and args_list[0] not in SVU_MODES
+        and re.fullmatch(r"v?\d+\.\d+\.\d+", args_list[0])
+    ):
+        args_list = ["prepare", args_list[0].lstrip("v"), *args_list[1:]]
+
+    args = parser.parse_args(args_list)
+
+    if args.command == "prepare":
+        version = resolve_version(args.mode)
+        write_manifest(version)
+        git_commit_and_tag(version, MANIFEST_PATHS)
+        print(version)
+        return 0
+
+    if args.command == "push":
+        version = (args.version or read_manifest_version()).lstrip("v")
+        push_release(version, upload_glob=UPLOAD_GLOB)
+        print(version)
+        return 0
+
+    parser.error(f"unknown command {args.command!r}")
+    return 2
+
+
+if __name__ == "__main__":
+    sys.exit(main())

{fetchurl_sdk-0.2.0 → fetchurl_sdk-0.2.2}/mise.toml

@@ -1,3 +1,4 @@
 [tools]
 ruff = "0.14.13"
+svu = "3.3.0"
 uv = "0.9.28"

{fetchurl_sdk-0.2.0 → fetchurl_sdk-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "fetchurl-sdk"
-version = "0.2.0"
+version = "0.2.2"
 description = "Protocol-level client SDK for fetchurl content-addressable cache servers"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -22,9 +22,9 @@ classifiers = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/lucasew/fetchurl"
-Repository = "https://github.com/lucasew/fetchurl"
-"Bug Tracker" = "https://github.com/lucasew/fetchurl/issues"
+Homepage = "https://pypi.org/project/fetchurl-sdk/"
+Repository = "https://github.com/fetchurl/sdk-python"
+"Bug Tracker" = "https://github.com/fetchurl/sdk-python/issues"
 
 [project.optional-dependencies]
 test = ["testcontainers>=3.7.0", "httpx>=0.27.0"]

{fetchurl_sdk-0.2.0 → fetchurl_sdk-0.2.2}/test_fetchurl_integration.py

@@ -57,6 +57,7 @@ class TestIntegration(unittest.TestCase):
                     DockerContainer(image_ref)
                     .with_command("server")
                     .with_network(net)
+                    .with_env("FETCHURL_ALLOW_PRIVATE_IPS", "1")
                     .with_exposed_ports(8080)
                 ).start()
 

{fetchurl_sdk-0.2.0 → fetchurl_sdk-0.2.2}/uv.lock

@@ -237,7 +237,7 @@ wheels = [
 
 [[package]]
 name = "fetchurl-sdk"
-version = "0.1.0"
+version = "0.2.1"
 source = { editable = "." }
 
 [package.optional-dependencies]

fetchurl_sdk-0.2.0/.gitignore

@@ -1,2 +0,0 @@
-.venv
-__pycache__

fetchurl_sdk-0.2.0/.python-version

@@ -1 +0,0 @@
-3.13

fetchurl_sdk-0.2.0/PKG-INFO

@@ -1,25 +0,0 @@
-Metadata-Version: 2.4
-Name: fetchurl-sdk
-Version: 0.2.0
-Summary: Protocol-level client SDK for fetchurl content-addressable cache servers
-Project-URL: Homepage, https://github.com/lucasew/fetchurl
-Project-URL: Repository, https://github.com/lucasew/fetchurl
-Project-URL: Bug Tracker, https://github.com/lucasew/fetchurl/issues
-Author: lucasew
-License: MIT
-Keywords: cache,content-addressable,fetchurl,hash,sha256
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Topic :: Internet :: WWW/HTTP
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.8
-Provides-Extra: test
-Requires-Dist: httpx>=0.27.0; extra == 'test'
-Requires-Dist: testcontainers>=3.7.0; extra == 'test'
-Description-Content-Type: text/markdown
-
-# fetchurl
-
-Simple caching server for URLs with a hash.

fetchurl_sdk-0.2.0/README.md

@@ -1,3 +0,0 @@
-# fetchurl
-
-Simple caching server for URLs with a hash.