bonya 1.0.0__tar.gz

bonya-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bonya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bonya-1.0.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: bonya
+Version: 1.0.0
+Summary: Synchronous Python SDK for Bonya sandboxes
+License-Expression: MIT
+Project-URL: Repository, https://github.com/bonyai/bonya-python
+Keywords: bonya,sandbox,sdk
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: websockets>=13
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: mypy>=1.8; extra == "dev"
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: twine>=6.2; extra == "dev"
+Dynamic: license-file
+
+# Bonya Python SDK
+
+Run code in a fast, isolated sandbox — from Python.
+
+```bash
+python -m pip install bonya
+```
+
+```python
+from bonya import Bonya
+
+with Bonya() as client:                       # reads BONYA_API_KEY
+    with client.create_sandbox() as sandbox:  # deleted on the way out
+        result = sandbox.exec(["echo", "hello"], check=True)
+        print(result.stdout)                  # hello
+```
+
+That is a real VM: it boots in about a second, runs anything Linux runs, and is
+gone when the `with` block ends.
+
+The SDK is synchronous. It talks to the Bonya REST API over HTTPS
+(`httpx`), and to the edge over a WebSocket (`websockets`) for streaming exec
+and terminal sessions. Python 3.10 or newer; fully typed (`py.typed`).
+
+## Configuration
+
+Every setting has an environment-variable fallback:
+
+| Argument | Environment variable | Default |
+|---|---|---|
+| `api_key` | `BONYA_API_KEY` | *required* |
+| `endpoint` | `BONYA_ENDPOINT` | `https://api.bonya.ai` |
+| `edge_endpoint` | `BONYA_EDGE_ENDPOINT` | the API endpoint |
+| `organization_id` | `BONYA_ORGANIZATION_ID` | your personal organization |
+| `ca_bundle` | `BONYA_CA_BUNDLE` | system trust store |
+| `timeout` | — | `30` (seconds) |
+| `max_retries` | — | `2` |
+| `filesystem_read_limit` | — | 64 MiB |
+
+An empty `organization_id` is an error rather than a silent fallback to your
+personal organization.
+
+## What you can do
+
+| I want to… | Call |
+|---|---|
+| Start a sandbox | `client.create_sandbox(template=, image=, snapshot=, gpu=, network=, env=, secret_sets=)` |
+| Reconnect to one | `client.get_sandbox(id)` / `.get_sandbox_by_name(name)` |
+| Find my sandboxes | `client.list_sandboxes(states=, name=)` |
+| Run a command | `sandbox.exec(cmd)` |
+| Stream output live | `sandbox.exec_stream(cmd)` |
+| Keep a process running after I disconnect | `sandbox.create_session(name, cmd)` / `.attach_session(name)` |
+| Move files in and out | `sandbox.read_file` / `.write_file` / `.upload_file` / `.download_file` / `.list_files` / `.stat_file` / `.mkdir_file` / `.remove_file` / `.move_file` |
+| Expose a port to the web | `sandbox.create_preview(port)` |
+| Capture disk state | `sandbox.snapshot()` / `.list_snapshots()` |
+| Clone a running sandbox | `sandbox.fork(count)` |
+| Pause or keep awake | `sandbox.pause("warm" \| "cold")` / `.keepalive(seconds)` / `.resume()` |
+| Restrict egress | `sandbox.update_network(NetworkPolicy(mode="allowlist", allow=[NetworkRule(domain="pypi.org")]))` |
+| Run a managed or scheduled job | `client.run_job(spec)` / `client.create_job_schedule(schedule, job)` |
+| See GPU capacity | `client.list_gpu_options()` |
+| Save a launch configuration | `client.create_template(name, config=TemplateConfig(...))` / `.list_templates()` / `.update_template()` / `.delete_template()` |
+| Pull private images | `client.create_registry_connection(...)` / `.validate_registry_connection(id, image)` |
+| Keep credentials out of code | `client.create_secret(name, value)` / `.create_secret_set(name, values)` (values are write-only) |
+| Switch organization | `client.list_organizations()` / `client.organization_id = id` |
+
+Everything is a **flat method** on `Bonya` or `Sandbox`.
+
+### Streaming exec
+
+```python
+from bonya import Exit, Stderr, Stdout
+
+with sandbox.exec_stream(["bash", "-lc", "echo out; echo err >&2"]) as session:
+    for event in session:
+        if isinstance(event, Stdout):
+            print("out:", event.data.decode(), end="")
+        elif isinstance(event, Stderr):
+            print("err:", event.data.decode(), end="")
+        elif isinstance(event, Exit):
+            print("exit:", event.exit_code)
+```
+
+### Persistent sessions
+
+```python
+sandbox.create_session("server", ["bash"])
+with sandbox.attach_session("server") as stream:
+    stream.write("npm run dev\n")
+    for event in stream:
+        ...  # Stdout, Exit, SessionEnded, SessionOutputDropped
+# leaving the block detaches; the process keeps running
+```
+
+### Jobs
+
+```python
+from bonya import JobSandboxSpec, JobSpec
+
+run = client.run_job(JobSpec(new_sandbox=JobSandboxSpec(), cmd=["./run-tests.sh"]))
+print(run.status, run.result.exit_code)
+```
+
+### Snapshots and forks
+
+```python
+snapshot = sandbox.snapshot(name="baseline")
+restored = client.create_sandbox(snapshot=snapshot.id)
+forks = sandbox.fork(2).sandboxes
+```
+
+## Errors
+
+Every error extends `BonyaError` (with `sandbox_id`, `idempotency_key`, `code`).
+Catch the class you care about: `AuthenticationError`, `SandboxNotFoundError`,
+`SandboxCreationTimeoutError` (carries the `idempotency_key` so create can be
+retried), `ExecFailedError`, `TimeoutError`, `NoCapacityError`,
+`RateLimitedError`, `OutcomeUnknownError`, `RemoteFileNotFoundError`, and so on.
+API keys and capability tokens are redacted from error messages.
+
+Create, exec, snapshot and other mutations accept an `idempotency_key`; the SDK
+generates one and reuses it across its own retries, so a retried call joins the
+original attempt instead of repeating it.
+
+## Examples
+
+Runnable programs live in [`examples/`](examples): `quickstart.py`,
+`exec_streaming.py`, `files.py`, `sessions.py`, `previews.py`, `snapshots.py`.
+
+## Development
+
+```bash
+python -m pip install -e '.[dev]'
+make check      # mypy + pytest
+```
+
+MIT licensed.

bonya-1.0.0/README.md

@@ -0,0 +1,136 @@
+# Bonya Python SDK
+
+Run code in a fast, isolated sandbox — from Python.
+
+```bash
+python -m pip install bonya
+```
+
+```python
+from bonya import Bonya
+
+with Bonya() as client:                       # reads BONYA_API_KEY
+    with client.create_sandbox() as sandbox:  # deleted on the way out
+        result = sandbox.exec(["echo", "hello"], check=True)
+        print(result.stdout)                  # hello
+```
+
+That is a real VM: it boots in about a second, runs anything Linux runs, and is
+gone when the `with` block ends.
+
+The SDK is synchronous. It talks to the Bonya REST API over HTTPS
+(`httpx`), and to the edge over a WebSocket (`websockets`) for streaming exec
+and terminal sessions. Python 3.10 or newer; fully typed (`py.typed`).
+
+## Configuration
+
+Every setting has an environment-variable fallback:
+
+| Argument | Environment variable | Default |
+|---|---|---|
+| `api_key` | `BONYA_API_KEY` | *required* |
+| `endpoint` | `BONYA_ENDPOINT` | `https://api.bonya.ai` |
+| `edge_endpoint` | `BONYA_EDGE_ENDPOINT` | the API endpoint |
+| `organization_id` | `BONYA_ORGANIZATION_ID` | your personal organization |
+| `ca_bundle` | `BONYA_CA_BUNDLE` | system trust store |
+| `timeout` | — | `30` (seconds) |
+| `max_retries` | — | `2` |
+| `filesystem_read_limit` | — | 64 MiB |
+
+An empty `organization_id` is an error rather than a silent fallback to your
+personal organization.
+
+## What you can do
+
+| I want to… | Call |
+|---|---|
+| Start a sandbox | `client.create_sandbox(template=, image=, snapshot=, gpu=, network=, env=, secret_sets=)` |
+| Reconnect to one | `client.get_sandbox(id)` / `.get_sandbox_by_name(name)` |
+| Find my sandboxes | `client.list_sandboxes(states=, name=)` |
+| Run a command | `sandbox.exec(cmd)` |
+| Stream output live | `sandbox.exec_stream(cmd)` |
+| Keep a process running after I disconnect | `sandbox.create_session(name, cmd)` / `.attach_session(name)` |
+| Move files in and out | `sandbox.read_file` / `.write_file` / `.upload_file` / `.download_file` / `.list_files` / `.stat_file` / `.mkdir_file` / `.remove_file` / `.move_file` |
+| Expose a port to the web | `sandbox.create_preview(port)` |
+| Capture disk state | `sandbox.snapshot()` / `.list_snapshots()` |
+| Clone a running sandbox | `sandbox.fork(count)` |
+| Pause or keep awake | `sandbox.pause("warm" \| "cold")` / `.keepalive(seconds)` / `.resume()` |
+| Restrict egress | `sandbox.update_network(NetworkPolicy(mode="allowlist", allow=[NetworkRule(domain="pypi.org")]))` |
+| Run a managed or scheduled job | `client.run_job(spec)` / `client.create_job_schedule(schedule, job)` |
+| See GPU capacity | `client.list_gpu_options()` |
+| Save a launch configuration | `client.create_template(name, config=TemplateConfig(...))` / `.list_templates()` / `.update_template()` / `.delete_template()` |
+| Pull private images | `client.create_registry_connection(...)` / `.validate_registry_connection(id, image)` |
+| Keep credentials out of code | `client.create_secret(name, value)` / `.create_secret_set(name, values)` (values are write-only) |
+| Switch organization | `client.list_organizations()` / `client.organization_id = id` |
+
+Everything is a **flat method** on `Bonya` or `Sandbox`.
+
+### Streaming exec
+
+```python
+from bonya import Exit, Stderr, Stdout
+
+with sandbox.exec_stream(["bash", "-lc", "echo out; echo err >&2"]) as session:
+    for event in session:
+        if isinstance(event, Stdout):
+            print("out:", event.data.decode(), end="")
+        elif isinstance(event, Stderr):
+            print("err:", event.data.decode(), end="")
+        elif isinstance(event, Exit):
+            print("exit:", event.exit_code)
+```
+
+### Persistent sessions
+
+```python
+sandbox.create_session("server", ["bash"])
+with sandbox.attach_session("server") as stream:
+    stream.write("npm run dev\n")
+    for event in stream:
+        ...  # Stdout, Exit, SessionEnded, SessionOutputDropped
+# leaving the block detaches; the process keeps running
+```
+
+### Jobs
+
+```python
+from bonya import JobSandboxSpec, JobSpec
+
+run = client.run_job(JobSpec(new_sandbox=JobSandboxSpec(), cmd=["./run-tests.sh"]))
+print(run.status, run.result.exit_code)
+```
+
+### Snapshots and forks
+
+```python
+snapshot = sandbox.snapshot(name="baseline")
+restored = client.create_sandbox(snapshot=snapshot.id)
+forks = sandbox.fork(2).sandboxes
+```
+
+## Errors
+
+Every error extends `BonyaError` (with `sandbox_id`, `idempotency_key`, `code`).
+Catch the class you care about: `AuthenticationError`, `SandboxNotFoundError`,
+`SandboxCreationTimeoutError` (carries the `idempotency_key` so create can be
+retried), `ExecFailedError`, `TimeoutError`, `NoCapacityError`,
+`RateLimitedError`, `OutcomeUnknownError`, `RemoteFileNotFoundError`, and so on.
+API keys and capability tokens are redacted from error messages.
+
+Create, exec, snapshot and other mutations accept an `idempotency_key`; the SDK
+generates one and reuses it across its own retries, so a retried call joins the
+original attempt instead of repeating it.
+
+## Examples
+
+Runnable programs live in [`examples/`](examples): `quickstart.py`,
+`exec_streaming.py`, `files.py`, `sessions.py`, `previews.py`, `snapshots.py`.
+
+## Development
+
+```bash
+python -m pip install -e '.[dev]'
+make check      # mypy + pytest
+```
+
+MIT licensed.

bonya-1.0.0/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bonya"
+version = "1.0.0"
+description = "Synchronous Python SDK for Bonya sandboxes"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["bonya", "sandbox", "sdk"]
+dependencies = [
+  "httpx>=0.27,<1",
+  "websockets>=13",
+]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Typing :: Typed",
+]
+
+[project.urls]
+Repository = "https://github.com/bonyai/bonya-python"
+
+[project.optional-dependencies]
+dev = [
+  "build>=1.0",
+  "mypy>=1.8",
+  "pytest>=8",
+  "twine>=6.2",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["bonya*"]
+
+[tool.setuptools.package-data]
+bonya = ["py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+packages = ["bonya"]

bonya-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

bonya-1.0.0/src/bonya/__init__.py

@@ -0,0 +1,101 @@
+"""Synchronous Python SDK for Bonya sandboxes."""
+
+from ._client import Bonya, Organization, SandboxSummary
+from ._errors import (
+    AuthenticationError,
+    BonyaError,
+    CapabilityRejectedError,
+    ConflictError,
+    ConnectionError,
+    CrossFilesystemMoveError,
+    ExecFailedError,
+    FilesystemError,
+    FilesystemLimitError,
+    InvalidRequestError,
+    JobRunNotFoundError,
+    JobScheduleNotFoundError,
+    LimitReachedError,
+    NoCapacityError,
+    OutcomeUnknownError,
+    PayloadTooLargeError,
+    PermissionDeniedError,
+    RateLimitedError,
+    RemoteFileExistsError,
+    RemoteFileNotFoundError,
+    SandboxBusyError,
+    SandboxCreationFailedError,
+    SandboxCreationTimeoutError,
+    SandboxDeletedError,
+    SandboxFailedError,
+    SandboxNotFoundError,
+    SandboxSuspendedError,
+    ServiceError,
+    SessionExists,
+    SessionExistsError,
+    SessionNotFoundError,
+    SnapshotInUseError,
+    SnapshotNotFoundError,
+    TimeoutError,
+)
+from ._files import FileInfo, FileKind
+from ._jobs import (
+    Disposition,
+    JobResult,
+    JobRun,
+    JobRunAction,
+    JobRunDetail,
+    JobRunStatus,
+    JobRunTimelineEntry,
+    JobRunTimelineStatus,
+    JobSandboxSpec,
+    JobSchedule,
+    JobScriptSpec,
+    JobSpec,
+    JobStart,
+    ScheduleAction,
+    ScheduleOverlap,
+    ScheduleSpec,
+)
+from ._library import RegistryConnection, Secret, SecretSet, Template, TemplateConfig
+from ._previews import Preview, PreviewAuth, PreviewGrant
+from ._sandbox import Capability, DeleteResult, ExecResult, ForkResult, ResumeResult, Sandbox, Snapshot
+from ._session import ExecSession
+from ._sessions import (
+    SessionEnded,
+    SessionEndedReason,
+    SessionInfo,
+    SessionList,
+    SessionOutputDropped,
+    SessionStatus,
+    SessionStream,
+)
+from ._types import (
+    LISTABLE_STATUSES,
+    ExecEvent,
+    Exit,
+    GpuRequest,
+    NetworkPolicy,
+    NetworkRule,
+    Status,
+    Stderr,
+    Stdout,
+    Wait,
+)
+
+__all__ = [
+    "AuthenticationError", "Bonya", "BonyaError", "Capability", "CapabilityRejectedError", "ConflictError",
+    "ConnectionError", "CrossFilesystemMoveError", "DeleteResult", "Disposition", "ExecEvent", "ExecFailedError",
+    "ExecResult", "ExecSession", "Exit", "FileInfo", "FileKind", "FilesystemError", "FilesystemLimitError",
+    "ForkResult", "GpuRequest", "InvalidRequestError", "JobResult", "JobRun", "JobRunAction", "JobRunDetail",
+    "JobRunNotFoundError", "JobRunStatus", "JobRunTimelineEntry", "JobRunTimelineStatus", "JobSandboxSpec",
+    "JobSchedule", "JobScheduleNotFoundError", "JobScriptSpec", "JobSpec", "JobStart", "LISTABLE_STATUSES",
+    "LimitReachedError", "NetworkPolicy", "NetworkRule", "NoCapacityError", "Organization", "OutcomeUnknownError",
+    "PayloadTooLargeError", "PermissionDeniedError", "Preview", "PreviewAuth", "PreviewGrant", "RateLimitedError",
+    "RegistryConnection", "RemoteFileExistsError", "RemoteFileNotFoundError", "ResumeResult", "Sandbox",
+    "SandboxBusyError", "SandboxCreationFailedError", "SandboxCreationTimeoutError", "SandboxDeletedError",
+    "SandboxFailedError", "SandboxNotFoundError", "SandboxSummary", "SandboxSuspendedError", "ScheduleAction",
+    "ScheduleOverlap", "ScheduleSpec", "Secret", "SecretSet", "ServiceError", "SessionEnded", "SessionEndedReason",
+    "SessionExists", "SessionExistsError", "SessionInfo", "SessionList", "SessionNotFoundError",
+    "SessionOutputDropped", "SessionStatus", "SessionStream", "Snapshot", "SnapshotInUseError",
+    "SnapshotNotFoundError", "Status", "Stderr", "Stdout", "Template", "TemplateConfig", "TimeoutError", "Wait",
+]