boxd 0.1.2.dev13__tar.gz → 0.1.3__tar.gz

{boxd-0.1.2.dev13/src/boxd.egg-info → boxd-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boxd
-Version: 0.1.2.dev13
+Version: 0.1.3
 Summary: Python SDK for the boxd cloud VM platform
 Author: Azin
 License-Expression: MIT

{boxd-0.1.2.dev13 → boxd-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "boxd"
-version = "0.1.2.dev13"
+version = "0.1.3"
 description = "Python SDK for the boxd cloud VM platform"
 readme = "README.md"
 license = "MIT"

{boxd-0.1.2.dev13 → boxd-0.1.3}/src/boxd/_sync.py

@@ -88,6 +88,16 @@ class Box(_SyncBase):
         """Resume this VM from suspension."""
         return self._run(self._async.resume())
 
+    def wait_until_ready(self, timeout: float = 90.0, poll_interval: float = 0.5) -> None:
+        """Block until the VM is fully ready (status='running' + exec works).
+
+        Call this after ``create()`` or ``fork()`` before any operation that
+        depends on the VM being fully usable — especially before another
+        ``fork()``, which gates fast-path live-fork on the source VM's Raft
+        status. See :meth:`boxd.box.Box.wait_until_ready` for details.
+        """
+        self._run(self._async.wait_until_ready(timeout=timeout, poll_interval=poll_interval))
+
     # ── Exec ─────────────────────────────────────────────────────
 
     def exec(

{boxd-0.1.2.dev13 → boxd-0.1.3}/src/boxd/box.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import asyncio
+import time
 from dataclasses import dataclass, field
 from pathlib import Path
 from typing import TYPE_CHECKING
@@ -15,6 +16,8 @@ from .errors import from_grpc_error
 from .exec import ExecProcess, ExecResult, StreamReader, StreamWriter
 from .types import Proxy, ResumeResult, SuspendResult
 
+_TERMINAL_STATES = frozenset({"destroyed", "failed", "stopped"})
+
 if TYPE_CHECKING:
     from .client import Compute
 
@@ -74,6 +77,49 @@ class Box(GrpcCaller):
         self.status = "running"
         return ResumeResult(resume_us=resp.resume_us)
 
+    async def wait_until_ready(
+        self,
+        timeout: float = 90.0,
+        poll_interval: float = 0.5,
+    ) -> None:
+        """Block until the VM is fully ready to use.
+
+        Returns once the VM's status flips to ``running`` AND an ``exec``
+        round-trip succeeds.
+
+        ``create()`` and ``fork()`` return as soon as the server has scheduled
+        the VM — at that point ``exec`` may already work, but the VM's status
+        in Raft can still be ``pending`` for ~1s. Operations that gate on the
+        authoritative state (notably another ``fork()``) will see the stale
+        status and fall back to a cold-boot path that drops the source's
+        in-memory state (e.g. tmpfs). Always call ``wait_until_ready()``
+        before acting on a fresh Box.
+        """
+        deadline = time.monotonic() + timeout
+
+        while time.monotonic() < deadline:
+            fresh = await self._client.box.get(self.id)
+            self.status = fresh.status
+            if fresh.status == "running":
+                break
+            if fresh.status in _TERMINAL_STATES:
+                raise RuntimeError(
+                    f"VM {self.name} entered terminal state '{fresh.status}' while waiting for ready"
+                )
+            await asyncio.sleep(poll_interval)
+        else:
+            raise TimeoutError(f"VM {self.name} did not reach 'running' within {timeout}s")
+
+        while time.monotonic() < deadline:
+            try:
+                await self.exec("true")
+                return
+            except Exception:
+                await asyncio.sleep(poll_interval)
+        raise TimeoutError(
+            f"VM {self.name} reached 'running' but exec did not succeed within {timeout}s"
+        )
+
     # ── Exec ──────────────────────────────────────────────────────
 
     async def exec(

{boxd-0.1.2.dev13 → boxd-0.1.3/src/boxd.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boxd
-Version: 0.1.2.dev13
+Version: 0.1.3
 Summary: Python SDK for the boxd cloud VM platform
 Author: Azin
 License-Expression: MIT

{boxd-0.1.2.dev13 → boxd-0.1.3}/tests/test_e2e.py

@@ -13,14 +13,10 @@ from boxd.errors import BoxdError
 
 
 def _wait_ready(box, timeout=90):
-    """Poll until the VM accepts exec commands."""
-    for i in range(timeout):
-        try:
-            box.exec("true")
-            return i
-        except Exception:
-            time.sleep(1)
-    pytest.fail(f"VM {box.name} not ready after {timeout}s")
+    """Wait until the VM is fully ready (status=running + exec works)."""
+    t0 = time.monotonic()
+    box.wait_until_ready(timeout=float(timeout))
+    return int(time.monotonic() - t0)
 
 
 pytestmark = pytest.mark.e2e

{boxd-0.1.2.dev13 → boxd-0.1.3}/tests/test_e2e_v2.py

@@ -8,13 +8,9 @@ pytestmark = pytest.mark.e2e
 
 
 def _wait_ready(box, timeout=90):
-    for i in range(timeout):
-        try:
-            box.exec("true")
-            return i
-        except Exception:
-            time.sleep(1)
-    pytest.fail(f"VM {box.name} not ready after {timeout}s")
+    t0 = time.monotonic()
+    box.wait_until_ready(timeout=float(timeout))
+    return int(time.monotonic() - t0)
 
 
 # ── Domains ─────────────────────────────────────────────────────