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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drukbox-python-sdk
-Version: 0.0.5
+Version: 0.0.6
 Summary: Async Python client for Drukbox.
 Requires-Python: >=3.11
 Requires-Dist: httpx>=0.28

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "drukbox-python-sdk"
-version = "0.0.5"
+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.5 → 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.5 → 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
@@ -350,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.5 → 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.5 → 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"
@@ -333,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(