riffsdk 0.4.2__tar.gz → 0.4.3__tar.gz

{riffsdk-0.4.2 → riffsdk-0.4.3}/.github/workflows/release.yml

@@ -86,3 +86,19 @@ jobs:
           path: dist/
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
+      - name: Verify release landed on PyPI
+        env:
+          TAG: ${{ needs.release.outputs.tag }}
+        run: |
+          VER="${TAG#v}"
+          echo "Verifying riffsdk ${VER} is available on PyPI..."
+          for i in $(seq 1 12); do
+            if curl -sf "https://pypi.org/pypi/riffsdk/${VER}/json" >/dev/null; then
+              echo "riffsdk ${VER} is live on PyPI"
+              exit 0
+            fi
+            echo "not yet on PyPI, retry ${i}/12..."
+            sleep 10
+          done
+          echo "::error::riffsdk ${VER} never appeared on PyPI despite a successful upload step (likely a silent edge 200 — see https://upload.pypi.org/legacy/ response in the publish step)"
+          exit 1

{riffsdk-0.4.2 → riffsdk-0.4.3}/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 <!-- version list -->
 
+## v0.4.3 (2026-06-11)
+
+### Bug Fixes
+
+- Add project homepage URL ([#12](https://github.com/databutton/riff-sdk-python/pull/12),
+  [`7333ba9`](https://github.com/databutton/riff-sdk-python/commit/7333ba9badb64eef3b111b74ee060fb5a6538c5b))
+
+- Declare MIT license and package author
+  ([#12](https://github.com/databutton/riff-sdk-python/pull/12),
+  [`7333ba9`](https://github.com/databutton/riff-sdk-python/commit/7333ba9badb64eef3b111b74ee060fb5a6538c5b))
+
+- Include README as package long description
+  ([#12](https://github.com/databutton/riff-sdk-python/pull/12),
+  [`7333ba9`](https://github.com/databutton/riff-sdk-python/commit/7333ba9badb64eef3b111b74ee060fb5a6538c5b))
+
+- Populate pypi release details and check publishing in CI job
+  ([#12](https://github.com/databutton/riff-sdk-python/pull/12),
+  [`7333ba9`](https://github.com/databutton/riff-sdk-python/commit/7333ba9badb64eef3b111b74ee060fb5a6538c5b))
+
+- Verify PyPI publish actually landed before passing release
+  ([#12](https://github.com/databutton/riff-sdk-python/pull/12),
+  [`7333ba9`](https://github.com/databutton/riff-sdk-python/commit/7333ba9badb64eef3b111b74ee060fb5a6538c5b))
+
+
 ## v0.4.2 (2026-06-11)
 
 ### Bug Fixes

riffsdk-0.4.3/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: riffsdk
+Version: 0.4.3
+Summary: Python SDK for the Riff Storage API
+Project-URL: Homepage, https://riff.ai
+Author-email: Martin Sandve Alnæs <msa@databutton.io>
+License-Expression: MIT
+License-File: LICENCE
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.6
+Requires-Dist: tenacity>=8.3
+Description-Content-Type: text/markdown
+
+# riffsdk
+
+Python SDK for the Riff Storage API. Provides sync and async clients for storing, retrieving, and managing objects.
+
+## Installation
+
+```bash
+uv add riffsdk
+# or
+pip install riffsdk
+```
+
+Or install from a branch (for pre-release testing):
+
+```bash
+uv add git+https://github.com/databutton/riff-sdk-python.git@main
+# or
+pip install git+https://github.com/databutton/riff-sdk-python.git@main
+```
+
+## Quick start
+
+```python
+from riffsdk.storage import StorageClient
+
+client = StorageClient()
+
+# Upload
+meta = client.put("hello.txt", "Hello, world!")
+
+# Download
+data = client.get("hello.txt")
+
+# List
+for obj in client.list("hello"):
+    print(f"{obj.key} ({obj.size} bytes)")
+
+# Delete
+client.delete("hello.txt")
+
+client.close()
+```
+
+### Async
+
+```python
+from riffsdk.storage import AsyncStorageClient
+
+async with AsyncStorageClient() as client:
+    await client.put("key", b"data", content_type="application/octet-stream")
+    data = await client.get("key")
+```
+
+## Authentication
+
+Set the `RIFF_TOKEN` environment variable. The SDK picks it up automatically.
+
+## API
+
+### Clients
+
+- `StorageClient` -- sync client
+- `AsyncStorageClient` -- async client
+
+Both support: `put`, `get`, `stat`, `exists`, `list`, `delete`, `close`, and context manager usage.
+
+### Models
+
+- `ObjectMeta` -- metadata for a stored object (key, version, size, content_type, timestamps)
+- `UploadResult`, `DownloadResult` -- operation results
+- `ListPage` -- paginated listing
+- `Scope` -- access scope (use `account_scope()`, `project_scope()`, `session_scope()`)
+
+### Uploads
+
+- `ResumableUpload` / `AsyncResumableUpload` -- multipart resumable uploads for large files
+- `StorageReader` / `StorageWriter` -- streaming read/write
+
+### Exceptions
+
+All exceptions inherit from `StorageError`:
+
+- `AuthorisationError`
+- `ObjectNotFoundError`
+- `VersionConflictError`
+- `AlreadyExistsError`
+- `LeaseConflictError`
+- `UploadNotFoundError`
+- `QuotaExceededError`
+- `PartMismatchError`
+- `StorageTransportError`
+
+## Examples
+
+See the `examples/` directory for complete working examples:
+
+- `basic_crud.py` -- put, get, list, delete
+- `async_client.py` -- async usage with asyncio
+- `file_upload_download.py` -- file uploads with progress
+- `optimistic_concurrency.py` -- version-based conflict handling
+
+## Development
+
+Requires Python 3.11+ and [uv](https://docs.astral.sh/uv/).
+
+```bash
+uv sync --dev        # Install dependencies
+mise run test        # Run tests
+mise run lint        # Lint
+mise run format      # Format code
+```
+
+See `AGENTS.md` for full development workflow details.

{riffsdk-0.4.2 → riffsdk-0.4.3}/pyproject.toml

@@ -4,11 +4,18 @@ build-backend = "hatchling.build"
 
 [project]
 name = "riffsdk"
-version = "0.4.2"
+version = "0.4.3"
 description = "Python SDK for the Riff Storage API"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENCE"]
+authors = [{ name = "Martin Sandve Alnæs", email = "msa@databutton.io" }]
 requires-python = ">=3.11"
 dependencies = ["httpx>=0.27", "pydantic>=2.6", "tenacity>=8.3"]
 
+[project.urls]
+Homepage = "https://riff.ai"
+
 [project.scripts]
 riffsdk = "riffsdk._cli:main"
 

riffsdk-0.4.2/PKG-INFO

@@ -1,9 +0,0 @@
-Metadata-Version: 2.4
-Name: riffsdk
-Version: 0.4.2
-Summary: Python SDK for the Riff Storage API
-License-File: LICENCE
-Requires-Python: >=3.11
-Requires-Dist: httpx>=0.27
-Requires-Dist: pydantic>=2.6
-Requires-Dist: tenacity>=8.3