boxd 0.2.2.dev44__tar.gz → 0.2.5.dev47__tar.gz

{boxd-0.2.2.dev44 → boxd-0.2.5.dev47}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boxd
-Version: 0.2.2.dev44
+Version: 0.2.5.dev47
 Summary: Python SDK for the boxd cloud VM platform
 Author: Azin
 License-Expression: MIT
@@ -18,12 +18,12 @@ Classifier: Topic :: System :: Distributed Computing
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: grpcio>=1.60
-Requires-Dist: protobuf>=4.25
+Requires-Dist: grpcio>=1.80
+Requires-Dist: protobuf>=6.31.1
 Requires-Dist: pydantic>=2
 Requires-Dist: httpx<1,>=0.27
 Provides-Extra: dev
-Requires-Dist: grpcio-tools>=1.60; extra == "dev"
+Requires-Dist: grpcio-tools<=1.80,>=1.60; extra == "dev"
 Requires-Dist: pytest>=8; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
 Requires-Dist: build>=1.0; extra == "dev"
@@ -531,6 +531,32 @@ volume.attachments      # [DiskAttachment(machine_id, machine_name, mount_path,
                         # mount_mode is "ro" or "rw"
 ```
 
+## Custom domains
+
+```python
+machine = boxd.machines.get(machine_id)
+print(boxd.domains.dns_instructions(
+    "app.example.com", machine_name=machine.name, machine_ip="<machine's public IP>",
+    zone=boxd.account.config().zone,
+))
+# Point an A record at the machine's public IP, and a wildcard CNAME
+# (*.app.example.com) at <machine>.<zone> — only once those are actually in
+# place:
+domain = boxd.domains.create("app.example.com", machine_id)   # starts "pending"
+domain.status           # "pending" | "active"
+domain.last_error       # empty once active
+boxd.domains.list()
+boxd.domains.delete("app.example.com")
+```
+
+`create` binds the domain and starts verification immediately — call it only
+once DNS is actually set. Checking before the records exist risks a public
+DNS resolver caching the "no records" answer, which would delay verification
+after you do set them. `dns_instructions` is a local helper (no network
+call) for rendering the records to show a user first — it doesn't touch the
+API. A background check verifies DNS and issues certs automatically, then
+flips `status` to `"active"`.
+
 ## Organizations, credentials, account
 
 ```python
@@ -544,6 +570,24 @@ orgs[0].is_default                   # where your personal machines are billed
 
 Anywhere a call takes `org`, it accepts an organization's name or id.
 
+An org can also have a wildcard domain (e.g. `preview.mysaas.com`,
+covering `<machine>.preview.mysaas.com` for every machine in the org).
+Setting or clearing it requires org admin; reading it doesn't.
+
+```python
+# Delegate the apex's NS records to boxd's cluster nameservers at your
+# registrar — only once that's actually done:
+d = boxd.orgs.set_domain("acme", "preview.mysaas.com")   # starts "pending"
+d.status, d.last_error
+boxd.orgs.get_domain("acme")     # None if unset
+boxd.orgs.clear_domain("acme")
+```
+
+`set_domain` starts verification immediately — call it only once NS
+delegation is actually live, for the same reason as per-machine domains
+above. A background check then verifies delegation and issues certs
+automatically, then flips `status` to `"active"`.
+
 ```python
 key = boxd.api_keys.create(
     "ci",

boxd-0.2.2.dev44/src/boxd.egg-info/PKG-INFO → boxd-0.2.5.dev47/README.md

@@ -1,35 +1,3 @@
-Metadata-Version: 2.4
-Name: boxd
-Version: 0.2.2.dev44
-Summary: Python SDK for the boxd cloud VM platform
-Author: Azin
-License-Expression: MIT
-Project-URL: Homepage, https://boxd.sh
-Keywords: boxd,vm,microvm,sandbox,compute,grpc,sdk
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: System :: Distributed Computing
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: grpcio>=1.60
-Requires-Dist: protobuf>=4.25
-Requires-Dist: pydantic>=2
-Requires-Dist: httpx<1,>=0.27
-Provides-Extra: dev
-Requires-Dist: grpcio-tools>=1.60; extra == "dev"
-Requires-Dist: pytest>=8; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
-Requires-Dist: build>=1.0; extra == "dev"
-Requires-Dist: twine>=4.0; extra == "dev"
-Dynamic: license-file
-
 # boxd Python SDK
 
 Python SDK for the [boxd](https://boxd.sh) cloud machine platform. Create
@@ -531,6 +499,32 @@ volume.attachments      # [DiskAttachment(machine_id, machine_name, mount_path,
                         # mount_mode is "ro" or "rw"
 ```
 
+## Custom domains
+
+```python
+machine = boxd.machines.get(machine_id)
+print(boxd.domains.dns_instructions(
+    "app.example.com", machine_name=machine.name, machine_ip="<machine's public IP>",
+    zone=boxd.account.config().zone,
+))
+# Point an A record at the machine's public IP, and a wildcard CNAME
+# (*.app.example.com) at <machine>.<zone> — only once those are actually in
+# place:
+domain = boxd.domains.create("app.example.com", machine_id)   # starts "pending"
+domain.status           # "pending" | "active"
+domain.last_error       # empty once active
+boxd.domains.list()
+boxd.domains.delete("app.example.com")
+```
+
+`create` binds the domain and starts verification immediately — call it only
+once DNS is actually set. Checking before the records exist risks a public
+DNS resolver caching the "no records" answer, which would delay verification
+after you do set them. `dns_instructions` is a local helper (no network
+call) for rendering the records to show a user first — it doesn't touch the
+API. A background check verifies DNS and issues certs automatically, then
+flips `status` to `"active"`.
+
 ## Organizations, credentials, account
 
 ```python
@@ -544,6 +538,24 @@ orgs[0].is_default                   # where your personal machines are billed
 
 Anywhere a call takes `org`, it accepts an organization's name or id.
 
+An org can also have a wildcard domain (e.g. `preview.mysaas.com`,
+covering `<machine>.preview.mysaas.com` for every machine in the org).
+Setting or clearing it requires org admin; reading it doesn't.
+
+```python
+# Delegate the apex's NS records to boxd's cluster nameservers at your
+# registrar — only once that's actually done:
+d = boxd.orgs.set_domain("acme", "preview.mysaas.com")   # starts "pending"
+d.status, d.last_error
+boxd.orgs.get_domain("acme")     # None if unset
+boxd.orgs.clear_domain("acme")
+```
+
+`set_domain` starts verification immediately — call it only once NS
+delegation is actually live, for the same reason as per-machine domains
+above. A background check then verifies delegation and issues certs
+automatically, then flips `status` to `"active"`.
+
 ```python
 key = boxd.api_keys.create(
     "ci",

{boxd-0.2.2.dev44 → boxd-0.2.5.dev47}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "boxd"
-version = "0.2.2.dev44"
+version = "0.2.5.dev47"
 description = "Python SDK for the boxd cloud VM platform"
 readme = "README.md"
 license = "MIT"
@@ -20,8 +20,15 @@ classifiers = [
     "Topic :: System :: Distributed Computing",
 ]
 dependencies = [
-    "grpcio>=1.60",
-    "protobuf>=4.25",
+    # Floors match what api_pb2*.py actually require (protobuf's
+    # compat guarantee is forward-only: gencode built with grpcio-tools
+    # 1.80 needs grpcio>=1.80 / protobuf>=6.31.1 at runtime, never older).
+    # Keep these in lockstep with the grpcio-tools pin below — bumping
+    # the codegen toolchain without bumping these floors reintroduces
+    # BOX-70 (resolvers install an old protobuf/grpcio that can't load
+    # the newer gencode).
+    "grpcio>=1.80",
+    "protobuf>=6.31.1",
     "pydantic>=2",
     # Cap below 1.0: httpx 1.0 (currently in pre-release as 1.0.devN)
     # removed `httpx.AsyncClient`, which _credentials.py uses for the
@@ -38,7 +45,11 @@ Homepage = "https://boxd.sh"
 
 [project.optional-dependencies]
 dev = [
-    "grpcio-tools>=1.60",
+    # Capped at 1.80: newer grpcio-tools stamps gencode against protobuf
+    # 7.x, which bumps the runtime floor above what shared environments
+    # (e.g. anything depending on beta9's protobuf<7) can satisfy. See
+    # BOX-70 — bump this only alongside the dependency floors above.
+    "grpcio-tools>=1.60,<=1.80",
     "pytest>=8",
     "pytest-asyncio>=0.23",
     "build>=1.0",

{boxd-0.2.2.dev44 → boxd-0.2.5.dev47}/src/boxd/__init__.py

@@ -33,6 +33,8 @@ from .errors import (
 from .models import (
     Account,
     ApiKey,
+    Backup,
+    BackupSchedule,
     Billing,
     Checkpoint,
     ClusterConfig,
@@ -41,6 +43,7 @@ from .models import (
     CreatedDisk,
     CreatedProxy,
     CreatedSnapshot,
+    CustomDomain,
     Disk,
     DiskAttachment,
     DiskStatus,
@@ -56,6 +59,7 @@ from .models import (
     MachineSourceKind,
     MachineStatus,
     Org,
+    OrgDomain,
     OrgRef,
     PauseResult,
     Proxy,
@@ -87,6 +91,8 @@ __all__ = [
     # Models
     "Account",
     "ApiKey",
+    "Backup",
+    "BackupSchedule",
     "Billing",
     "Checkpoint",
     "ClusterConfig",
@@ -95,6 +101,7 @@ __all__ = [
     "CreatedDisk",
     "CreatedProxy",
     "CreatedSnapshot",
+    "CustomDomain",
     "Disk",
     "DiskAttachment",
     "DiskStatus",
@@ -110,6 +117,7 @@ __all__ = [
     "MachineSourceKind",
     "MachineStatus",
     "Org",
+    "OrgDomain",
     "OrgRef",
     "PauseResult",
     "Proxy",

{boxd-0.2.2.dev44 → boxd-0.2.5.dev47}/src/boxd/_client.py

@@ -13,6 +13,7 @@ from ._urls import DEFAULT_BASE_URL, exchange_url_for, resolve_base_url
 from .resources.account import Account, AsyncAccount
 from .resources.credentials import ApiKeys, AsyncApiKeys
 from .resources.disks import AsyncDisks, Disks
+from .resources.domains import AsyncDomains, Domains
 from .resources.machines import AsyncMachines, Machines
 from .resources.orgs import AsyncOrgs, Orgs
 from .resources.snapshots import AsyncSnapshots, Snapshots
@@ -72,6 +73,7 @@ class Boxd:
         self.disks = Disks(self._transport)
         self.env = Env(self._transport)
         self.secrets = Secrets(self._transport)
+        self.domains = Domains(self._transport)
         self.orgs = Orgs(self._transport)
         self.api_keys = ApiKeys(self._transport)
         self.account = Account(self._transport)
@@ -128,6 +130,7 @@ class AsyncBoxd:
         self.disks = AsyncDisks(self._transport)
         self.env = AsyncEnv(self._transport)
         self.secrets = AsyncSecrets(self._transport)
+        self.domains = AsyncDomains(self._transport)
         self.orgs = AsyncOrgs(self._transport)
         self.api_keys = AsyncApiKeys(self._transport)
         self.account = AsyncAccount(self._transport)