drukbox-python-sdk 0.0.4__py3-none-any.whl → 0.0.6__py3-none-any.whl

{drukbox_python_sdk-0.0.4.dist-info → drukbox_python_sdk-0.0.6.dist-info}/METADATA

@@ -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.6.dist-info/RECORD

@@ -0,0 +1,6 @@
+drukbox_sdk/__init__.py,sha256=GXf8MpWSrvq-ZVpjbyewSyeoF7rVG3D3rPXUKlDtJTU,790
+drukbox_sdk/api.py,sha256=wThm3hD7ZMDzWQhe4VLMPrDbnkv6BgQpbHQc-4gBAAg,14737
+drukbox_sdk/exceptions.py,sha256=YecxsuwpHhwzgw-_h9KbXf1WqY6R0JIJrwPY3Eg4e6I,2146
+drukbox_python_sdk-0.0.6.dist-info/METADATA,sha256=ffkMD_7mvw4OWt9iGoomxU1ygptC7LH2fB-ULAPJsHQ,3203
+drukbox_python_sdk-0.0.6.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+drukbox_python_sdk-0.0.6.dist-info/RECORD,,

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_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_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.dist-info/RECORD

@@ -1,6 +0,0 @@
-drukbox_sdk/__init__.py,sha256=mYIclrOsTbsz9I-0J7eTizXg9s95dGker9SQppmVmrI,732
-drukbox_sdk/api.py,sha256=rZ1MI4zKMiqGNOtAzcPM10Y-Q7ZW3Ly_ZP9cgVqhcDc,13953
-drukbox_sdk/exceptions.py,sha256=eGtoDqmyt5vF0f4AJ4XmOatEe1vVl9KDOfI2YygdA2k,1811
-drukbox_python_sdk-0.0.4.dist-info/METADATA,sha256=aAGDQPkXP6ktJ_yKYbOAaooAmDbqS0lq4fckWJqKgu8,3191
-drukbox_python_sdk-0.0.4.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-drukbox_python_sdk-0.0.4.dist-info/RECORD,,