drukbox-python-sdk 0.0.4__tar.gz → 0.0.6__tar.gz

{drukbox_python_sdk-0.0.4 → drukbox_python_sdk-0.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drukbox-python-sdk
-Version: 0.0.4
+Version: 0.0.6
 Summary: Async Python client for Drukbox.
 Requires-Python: >=3.11
 Requires-Dist: httpx>=0.28
@@ -80,7 +80,7 @@ Supported host operations:
 - `aclose`
 
 `create_host` supports the service's optional `image`, `env`, `expires_at`,
-and `Idempotency-Key` inputs.
+`provider`, and `Idempotency-Key` inputs.
 
 `doctor` fetches `GET /doctor` — read-only dependency health. The service
 runs one cheap, non-mutating probe per dependency (database, active VM

{drukbox_python_sdk-0.0.4 → drukbox_python_sdk-0.0.6}/README.md

@@ -72,7 +72,7 @@ Supported host operations:
 - `aclose`
 
 `create_host` supports the service's optional `image`, `env`, `expires_at`,
-and `Idempotency-Key` inputs.
+`provider`, and `Idempotency-Key` inputs.
 
 `doctor` fetches `GET /doctor` — read-only dependency health. The service
 runs one cheap, non-mutating probe per dependency (database, active VM

{drukbox_python_sdk-0.0.4 → drukbox_python_sdk-0.0.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "drukbox-python-sdk"
-version = "0.0.4"
+version = "0.0.6"
 description = "Async Python client for Drukbox."
 readme = "README.md"
 # Tracks the lowest Python any current consumer supports. Bump only

{drukbox_python_sdk-0.0.4 → drukbox_python_sdk-0.0.6}/src/drukbox_sdk/__init__.py

@@ -18,6 +18,7 @@ from .exceptions import (
     SandboxProvisioningError,
     SandboxResponseError,
     SandboxUnavailableError,
+    SandboxValidationError,
 )
 
 __all__ = [
@@ -32,4 +33,5 @@ __all__ = [
     "SandboxProvisioningError",
     "SandboxResponseError",
     "SandboxUnavailableError",
+    "SandboxValidationError",
 ]

{drukbox_python_sdk-0.0.4 → drukbox_python_sdk-0.0.6}/src/drukbox_sdk/api.py

@@ -45,6 +45,7 @@ from .exceptions import (
     SandboxProvisioningError,
     SandboxResponseError,
     SandboxUnavailableError,
+    SandboxValidationError,
 )
 
 # Explicit pool budget. The httpx defaults (100 / 20) are plenty for
@@ -214,6 +215,7 @@ class SandboxAPI:
         expires_at: datetime | None = None,
         idempotency_key: str | None = None,
         image: str | None = None,
+        provider: str | None = None,
     ) -> SandboxHost:
         """Provision a new host.
 
@@ -228,6 +230,10 @@ class SandboxAPI:
         header. Useful for retry safety on flaky networks — a retry with
         the same key after a successful provision returns the original
         host instead of creating a duplicate.
+
+        ``provider`` pins which VM provider serves the request; omit it to
+        use the service default. An unknown provider raises
+        :class:`SandboxResponseError` (the service rejects it with 400).
         """
 
         payload: dict[str, Any] = {}
@@ -237,6 +243,8 @@ class SandboxAPI:
             payload["expires_at"] = expires_at.isoformat()
         if image is not None:
             payload["image"] = image
+        if provider is not None:
+            payload["provider"] = provider
 
         headers: dict[str, str] = {}
         if idempotency_key is not None:
@@ -343,6 +351,14 @@ class SandboxAPI:
         if response.status_code == 503:
             raise SandboxUnavailableError(json_response.get("detail", "service unavailable"))
 
+        if response.status_code == 422:
+            # FastAPI's 422 detail is a list of error dicts; join the messages
+            # so it reads as a line, not a raw list repr.
+            detail = json_response.get("detail", "validation error")
+            if isinstance(detail, list):
+                detail = "; ".join(item.get("msg", "") for item in detail) or "validation error"
+            raise SandboxValidationError(detail)
+
         if response.status_code >= 400:
             raise SandboxResponseError(json_response.get("detail", "error"))
         return json_response

{drukbox_python_sdk-0.0.4 → drukbox_python_sdk-0.0.6}/src/drukbox_sdk/exceptions.py

@@ -50,5 +50,14 @@ class SandboxProvisioningError(SandboxAPIError):
     """
 
 
+class SandboxValidationError(SandboxAPIError):
+    """422 — the service rejected the request payload as invalid.
+
+    e.g. an env key that isn't a valid environment-variable name, or a
+    proxy target URL carrying a path or credentials. The request is
+    malformed, so retrying it unchanged won't help — fix the input.
+    """
+
+
 class SandboxResponseError(SandboxAPIError):
     """Everything else the service returned that the SDK doesn't classify."""

{drukbox_python_sdk-0.0.4 → drukbox_python_sdk-0.0.6}/tests/test_api.py

@@ -31,6 +31,7 @@ from drukbox_sdk import (
     SandboxProvisioningError,
     SandboxResponseError,
     SandboxUnavailableError,
+    SandboxValidationError,
 )
 
 BASE_URL = "https://sandbox.test"
@@ -164,9 +165,23 @@ async def test_create_host_omits_image_and_env_when_unset(api: SandboxAPI):
     assert "image" not in body
     assert "env" not in body
     assert "expires_at" not in body
+    assert "provider" not in body
     assert "Idempotency-Key" not in route.calls.last.request.headers
 
 
+@respx.mock
+async def test_create_host_sends_provider_when_set(api: SandboxAPI):
+    payload = _host_payload(provider="hetzner")
+    route = respx.post(f"{BASE_URL}/hosts").mock(
+        return_value=httpx.Response(201, json=payload),
+    )
+
+    host = await api.create_host(provider="hetzner")
+
+    assert '"provider":"hetzner"' in route.calls.last.request.content.decode()
+    assert host.provider == "hetzner"
+
+
 @respx.mock
 async def test_get_host_returns_parsed_host(api: SandboxAPI):
     payload = _host_payload(status="active")
@@ -319,6 +334,28 @@ async def test_409_raises_sandbox_conflict_error(api: SandboxAPI):
         await api.delete_host(host_id)
 
 
+@respx.mock
+async def test_422_raises_sandbox_validation_error(api: SandboxAPI):
+    # FastAPI's 422 detail is a list of error dicts; the SDK flattens it to a
+    # readable line and raises the dedicated validation error (don't-retry).
+    respx.post(f"{BASE_URL}/hosts").mock(
+        return_value=httpx.Response(
+            422,
+            json={
+                "detail": [
+                    {
+                        "loc": ["body", "env"],
+                        "msg": "env keys must be valid environment variable names: FOO BAR",
+                    }
+                ]
+            },
+        ),
+    )
+
+    with pytest.raises(SandboxValidationError, match="env keys must be valid"):
+        await api.create_host(env={"FOO BAR": "x"})
+
+
 @respx.mock
 async def test_500_raises_sandbox_response_error(api: SandboxAPI):
     respx.get(f"{BASE_URL}/hosts").mock(