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

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

@@ -0,0 +1,83 @@
+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
+      # Trusted publishing (PyPI) — enable if you configure OIDC on PyPI instead of UV_PUBLISH_TOKEN
+      id-token: write
+    steps:
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5.0.1
+        with:
+          # svu needs full history + tags
+          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: Bump version (svu)
+        if: github.event_name == 'workflow_dispatch'
+        env:
+          NEW_VERSION: ${{ github.event.inputs.new_version }}
+        run: |
+          VERSION="$(NO_TAG=1 ./make_release "$NEW_VERSION")"
+          echo "RELEASE_VERSION=$VERSION" >> "$GITHUB_ENV"
+          echo "New version: $VERSION (from svu $NEW_VERSION)" >> "$GITHUB_STEP_SUMMARY"
+
+      - name: Create GitHub release
+        if: env.RELEASE_VERSION != ''
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          TAG: ${{ env.RELEASE_VERSION }}
+        run: |
+          git tag "$TAG"
+          git push origin "$TAG"
+          git push origin HEAD:main
+          gh release create "$TAG" --title "Release $TAG" --generate-notes
+
+      - 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

fetchurl_sdk-0.2.1/.svu.yml

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

fetchurl_sdk-0.2.1/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.1/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: fetchurl-sdk
+Version: 0.2.1
+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.1/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.1/make_release

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Usage: ./make_release [next|major|minor|patch|<x.y.z>]
+# Only the semver is printed on stdout; everything else goes to stderr.
+MODE="${1:-next}"
+
+case "$MODE" in
+  next|major|minor|patch)
+    VERSION="$(svu "$MODE")"
+    ;;
+  *)
+    VERSION="${MODE#v}"
+    ;;
+esac
+VERSION="${VERSION#v}"
+
+sed -i "s/^version = .*/version = \"$VERSION\"/" pyproject.toml
+git add pyproject.toml
+
+git commit -sm "bump to $VERSION" 1>&2 || true
+if [[ ! -v NO_TAG ]]; then
+  git tag "$VERSION"
+  git push origin "$VERSION" 1>&2
+fi
+git push origin HEAD 1>&2
+
+printf '%s\n' "$VERSION"

{fetchurl_sdk-0.2.0 → fetchurl_sdk-0.2.1}/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.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "fetchurl-sdk"
-version = "0.2.0"
+version = "0.2.1"
 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.1}/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.1}/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.