sandboxer-sdk 0.1.0__py3-none-any.whl

sandboxer/__init__.py

@@ -0,0 +1,128 @@
+"""Python SDK for Sandboxer (https://sandboxer.com): cloud sandboxes for AI agents and humans.
+
+Quickstart::
+
+    from sandboxer import Sandboxer
+
+    with Sandboxer.create(ttl_seconds=1800, on_exit="delete") as sandbox:
+        print(sandbox.exec("uname -a").stdout)
+
+``Sandboxer`` / ``Sandbox`` are the high-level synchronous API; ``AsyncSandboxer`` /
+``AsyncSandbox`` the asynchronous one. ``SandboxerApi`` (``client.api``) is the low-level
+client with one method per API operation, named like boat-sdk's ``BoatApi``.
+"""
+
+from . import models
+from ._config import DEFAULT_BASE_URL
+from ._generated_api import OPERATIONS, AsyncSandboxerApi, SandboxerApi
+from ._helpers_sync import (
+    exec_command,
+    prompt_events,
+    read_bytes,
+    read_text,
+    stop_and_remove,
+    stream_events,
+    stream_prompt,
+    wait_for_desktop,
+    wait_for_named_snapshot,
+    wait_for_prompt,
+    wait_for_prompt_done,
+    wait_for_setup,
+    wait_for_state,
+    wait_until_idle,
+    wait_until_ready,
+    write_bytes,
+    write_text,
+)
+from ._results import CommandResult, reset_default_clients
+from ._sandbox_async import (
+    AsyncCommand,
+    AsyncCommandStream,
+    AsyncFiles,
+    AsyncPromptRun,
+    AsyncSandbox,
+    AsyncSandboxer,
+)
+from ._sandbox_sync import Command, CommandStream, Files, PromptRun, Sandbox, Sandboxer
+from ._types import NOT_GIVEN, NotGiven, RequestOptions
+from ._version import __version__
+from .errors import (
+    APIConnectionError,
+    APITimeoutError,
+    AuthenticationError,
+    BadRequestError,
+    CommandError,
+    ConflictError,
+    InternalServerError,
+    NotFoundError,
+    PaymentRequiredError,
+    PermissionDeniedError,
+    RateLimitError,
+    SandboxerError,
+    SandboxStateError,
+    WaitTimeoutError,
+    WebhookVerificationError,
+)
+from .webhooks import construct_event, sign_webhook, verify_webhook, verify_webhook_headers
+
+__all__ = [
+    "DEFAULT_BASE_URL",
+    "NOT_GIVEN",
+    "OPERATIONS",
+    "APIConnectionError",
+    "APITimeoutError",
+    "AsyncCommand",
+    "AsyncCommandStream",
+    "AsyncFiles",
+    "AsyncPromptRun",
+    "AsyncSandbox",
+    "AsyncSandboxer",
+    "AsyncSandboxerApi",
+    "AuthenticationError",
+    "BadRequestError",
+    "Command",
+    "CommandError",
+    "CommandResult",
+    "CommandStream",
+    "ConflictError",
+    "Files",
+    "InternalServerError",
+    "NotFoundError",
+    "NotGiven",
+    "PaymentRequiredError",
+    "PermissionDeniedError",
+    "PromptRun",
+    "RateLimitError",
+    "RequestOptions",
+    "Sandbox",
+    "SandboxStateError",
+    "Sandboxer",
+    "SandboxerApi",
+    "SandboxerError",
+    "WaitTimeoutError",
+    "WebhookVerificationError",
+    "__version__",
+    "construct_event",
+    "exec_command",
+    "models",
+    "prompt_events",
+    "read_bytes",
+    "read_text",
+    "reset_default_clients",
+    "sign_webhook",
+    "stop_and_remove",
+    "stream_events",
+    "stream_prompt",
+    "verify_webhook",
+    "verify_webhook_headers",
+    "wait_for_desktop",
+    "wait_for_named_snapshot",
+    "wait_for_prompt",
+    "wait_for_prompt_done",
+    "wait_for_setup",
+    "wait_for_state",
+    "wait_until_idle",
+    "wait_until_ready",
+    "write_bytes",
+    "write_text",
+]

sandboxer/_config.py

@@ -0,0 +1,45 @@
+"""Client configuration resolved from arguments and environment variables."""
+
+from __future__ import annotations
+
+import os
+from collections.abc import Mapping
+from dataclasses import dataclass, field
+
+DEFAULT_BASE_URL = "https://sandboxer.com/api/v1"
+DEFAULT_TIMEOUT = 60.0
+DEFAULT_MAX_RETRIES = 3
+
+
+@dataclass
+class ClientConfig:
+    api_key: str | None
+    base_url: str
+    org: str | None
+    timeout: float | None
+    max_retries: int
+    default_headers: dict[str, str] = field(default_factory=dict)
+
+    @classmethod
+    def resolve(
+        cls,
+        *,
+        api_key: str | None = None,
+        base_url: str | None = None,
+        org: str | None = None,
+        timeout: float | None = DEFAULT_TIMEOUT,
+        max_retries: int = DEFAULT_MAX_RETRIES,
+        default_headers: Mapping[str, str] | None = None,
+    ) -> ClientConfig:
+        """Fill unset values from ``SANDBOXER_API_KEY`` (then ``SANDBOXER_TOKEN``),
+        ``SANDBOXER_API_URL`` and ``SANDBOXER_ORG``."""
+        key = api_key or os.environ.get("SANDBOXER_API_KEY") or os.environ.get("SANDBOXER_TOKEN") or None
+        url = (base_url or os.environ.get("SANDBOXER_API_URL") or DEFAULT_BASE_URL).rstrip("/")
+        return cls(
+            api_key=key,
+            base_url=url,
+            org=org or os.environ.get("SANDBOXER_ORG") or None,
+            timeout=timeout,
+            max_retries=max_retries,
+            default_headers=dict(default_headers or {}),
+        )