Add optional end-to-end upload test harness

Author: kvz

.gitattributes

@@ -0,0 +1 @@
+*.jpg binary

README.md

@@ -64,6 +64,14 @@ Signature parity tests use `npx transloadit smart_sig` under the hood, matching
 
 Pass `--python 3.12` (or set `PYTHON_VERSIONS`) to restrict the matrix, or append a custom command after `--`, for example `scripts/test-in-docker.sh -- pytest -k smartcdn`.
 
+To exercise the optional end-to-end upload against a real Transloadit account, provide `TRANSLOADIT_KEY` and `TRANSLOADIT_SECRET` (via environment variables or `.env`) and set `PYTHON_SDK_E2E=1`:
+
+```bash
+PYTHON_SDK_E2E=1 scripts/test-in-docker.sh --python 3.12 -- pytest tests/test_e2e_upload.py
+```
+
+The test uploads `chameleon.jpg`, resizes it, and asserts on the live assembly results. It respects `TRANSLOADIT_HOST` and `TRANSLOADIT_REGION` overrides when present.
+
 If you have a global installation of `poetry`, you can run the tests with:
 
 ```bash

chameleon.jpg

@@ -48,6 +48,9 @@ build-backend = "poetry.core.masonry.api"
 [tool.pytest.ini_options]
 addopts = "--cov=transloadit --cov-report=term-missing"
 testpaths = ["tests"]
+markers = [
+    "e2e: marks tests that hit the live Transloadit API"
+]
 
 [tool.coverage.run]
 source = ["transloadit"]

pyproject.toml

@@ -158,7 +158,7 @@ run_for_version() {
     docker_args+=(--env-file "$PWD/.env")
   fi
 
-  local -a passthrough_envs=(TRANSLOADIT_KEY TRANSLOADIT_SECRET TRANSLOADIT_HOST TRANSLOADIT_REGION TRANSLOADIT_TEMPLATE_ID)
+  local -a passthrough_envs=(TRANSLOADIT_KEY TRANSLOADIT_SECRET TRANSLOADIT_HOST TRANSLOADIT_REGION TRANSLOADIT_TEMPLATE_ID PYTHON_SDK_E2E)
   for var in "${passthrough_envs[@]}"; do
     if [[ -n "${!var:-}" ]]; then
       docker_args+=(-e "$var=${!var}")

scripts/test-in-docker.sh

@@ -0,0 +1,93 @@
+import os
+from pathlib import Path
+
+import pytest
+
+from transloadit.client import Transloadit
+
+
+def _is_enabled():
+    flag = os.getenv("PYTHON_SDK_E2E", "")
+    return flag.lower() in {"1", "true", "yes", "on"}
+
+
+pytestmark = [
+    pytest.mark.e2e,
+    pytest.mark.skipif(not _is_enabled(), reason="Set PYTHON_SDK_E2E=1 to run E2E tests"),
+]
+
+
+def _build_service():
+    service = os.getenv("TRANSLOADIT_HOST")
+    if service:
+        return service
+
+    region = os.getenv("TRANSLOADIT_REGION")
+    if region:
+        return f"https://api2-{region}.transloadit.com"
+
+    return None
+
+
+def test_e2e_image_resize(tmp_path):
+    key = os.getenv("TRANSLOADIT_KEY")
+    secret = os.getenv("TRANSLOADIT_SECRET")
+
+    if not key or not secret:
+        pytest.skip("TRANSLOADIT_KEY and TRANSLOADIT_SECRET must be set to run E2E tests")
+
+    fixture_path = Path(__file__).resolve().parents[1] / "chameleon.jpg"
+    if not fixture_path.exists():
+        pytest.skip("chameleon.jpg fixture missing; run from repository root")
+
+    service = _build_service()
+    client_kwargs = {"service": service} if service else {}
+    client = Transloadit(key, secret, **client_kwargs)
+
+    assembly = client.new_assembly()
+
+    with fixture_path.open("rb") as upload:
+        assembly.add_file(upload)
+        assembly.add_step(
+            "resize",
+            "/image/resize",
+            {
+                "use": ":original",
+                "width": 128,
+                "height": 128,
+                "resize_strategy": "fit",
+                "format": "png",
+            },
+        )
+
+        response = assembly.create(wait=True, resumable=False)
+
+    data = response.data
+    assert data.get("ok") == "ASSEMBLY_COMPLETED", data
+
+    uploads = data.get("uploads") or []
+    assert uploads, f"Expected uploads in assembly response: {data}"
+    upload_info = uploads[0]
+    basename = upload_info.get("basename")
+    if basename:
+        assert basename == fixture_path.stem
+    filename = upload_info.get("name")
+    if filename:
+        assert filename == fixture_path.name
+
+    results = (data.get("results") or {}).get("resize") or []
+    assert results, f"Expected resize results in assembly response: {data}"
+    first_result = results[0]
+
+    ssl_url = first_result.get("ssl_url")
+    assert ssl_url and ssl_url.startswith("https://"), f"Unexpected ssl_url: {ssl_url}"
+
+    meta = first_result.get("meta") or {}
+    width = meta.get("width")
+    height = meta.get("height")
+    if width is not None:
+        width = int(width)
+    if height is not None:
+        height = int(height)
+    assert width and height, f"Missing dimensions in result metadata: {meta}"
+    assert 0 < width <= 128 and 0 < height <= 128