boxd 0.2.6.dev355__py3-none-any.whl → 0.2.6.dev398__py3-none-any.whl

boxd/_mappers.py

@@ -80,6 +80,11 @@ def _epoch_ms_always(millis: int) -> datetime:
 # ── Machines ─────────────────────────────────────────────────────────
 
 
+def _desktop_url(name: str, console_origin: str) -> str:
+    """`<console>/desktop/<name>`, or "" when the console origin is unknown."""
+    return f"{console_origin}/desktop/{name}" if console_origin else ""
+
+
 def _machine_url(name: str, domain: str) -> str:
     """`https://<name>.<domain>`, or "" when the domain is not known yet."""
     return f"https://{name}.{domain}" if domain else ""
@@ -99,7 +104,7 @@ def machine_source(msg) -> MachineSource | None:
     )
 
 
-def machine(msg) -> Machine:
+def machine(msg, console_origin: str = "") -> Machine:
     # `billing_org`/`billing_org_id` name the machine's org whether or not it
     # is shared. `org`/`org_id` are the same org, blanked when it is private —
     # so they answer "is it shared", and nothing else.
@@ -131,6 +136,7 @@ def machine(msg) -> Machine:
             ssh_port=msg.ssh_port or None,
             domain=msg.access_domain,
             url=_machine_url(msg.name, msg.access_domain),
+            desktop_url=_desktop_url(msg.name, console_origin),
             custom_domains=[custom_domain(d) for d in msg.custom_domains],
         ),
         # 0 is MEANINGFUL here — disabled, not unset. Do not null it.
@@ -167,7 +173,9 @@ def machine_from_created(msg) -> Machine:
         # Not reported by these responses — `create`/`fork` re-read the
         # machine, so this fallback only shows when that read failed.
         networking=MachineNetworking(networks=[], isolated=False),
-        access=MachineAccess(ssh_port=None, domain="", url="", custom_domains=[]),
+        access=MachineAccess(
+            ssh_port=None, domain="", url="", desktop_url="", custom_domains=[]
+        ),
         idle=MachineIdle(suspend_after=0, hibernate_after=0, destroy_after=0),
         source=None,
         hibernated_at=None,

boxd/_transport.py

@@ -17,7 +17,7 @@ import grpc.aio
 from . import _version_check
 from ._credentials import AsyncCredentials, SyncCredentials
 from ._generated import api_pb2_grpc
-from ._urls import DEFAULT_BASE_URL, resolve_endpoint
+from ._urls import DEFAULT_BASE_URL, console_base_url, resolve_endpoint
 from .errors import BoxdError, from_grpc_error, is_retryable
 
 # First backoff, doubled per attempt. Two retries by default ⇒ 0.5s then 1.0s.
@@ -49,6 +49,17 @@ class _TransportBase:
             or DEFAULT_BASE_URL
         )
 
+    @property
+    def console_origin(self) -> str:
+        """The web console's origin for whichever cluster this client talks to.
+
+        Derived from the same `base_url` the channel dials, so the two can
+        never disagree. Note it cannot come from a machine's own
+        `access.domain`: that may be the ORG's wildcard domain, and the
+        console is never under it.
+        """
+        return console_base_url(self.base_url)
+
     def _build_channel(self, factory_secure, factory_insecure):
         endpoint = resolve_endpoint(self.base_url)
         if endpoint.use_tls:

boxd/_version_check.py

@@ -11,6 +11,7 @@ produced; the comparison and the nag are shared.
 
 from __future__ import annotations
 
+import os
 import re
 import sys
 from collections.abc import Iterable
@@ -18,6 +19,7 @@ from collections.abc import Iterable
 REQ_HEADER = "x-boxd-py-sdk-version"
 RESP_HEADER = "x-boxd-py-sdk-latest"
 UPGRADE_CMD = "pip install --upgrade boxd"
+PRERELEASE_UPGRADE_CMD = "pip install --upgrade --pre boxd"
 
 _notified = False
 
@@ -40,6 +42,15 @@ def note_metadata(md: Iterable[tuple[str, str]] | None) -> None:
     global _notified
     if _notified or md is None:
         return
+    # Only for a person at a terminal: in CI, or in an automation job whose
+    # stderr is its log file, this is noise on every run and nothing acts on
+    # it.
+    # An explicit opt-out beats every heuristic: set BOXD_NO_UPDATE_NOTICE to
+    # any non-empty value and this is never printed.
+    if os.environ.get("BOXD_NO_UPDATE_NOTICE"):
+        return
+    if not _stderr_is_tty():
+        return
     latest = None
     for key, value in md:
         if key.lower() == RESP_HEADER:
@@ -50,13 +61,38 @@ def note_metadata(md: Iterable[tuple[str, str]] | None) -> None:
     current = _current_version()
     if _compare_semver(latest, current) <= 0:
         return
+    # A pre-release is opt-in (`pip install --pre`), so someone on a release
+    # build is not behind on anything they asked for — and the command below
+    # would not install it anyway, leaving the nag to repeat forever. Staging
+    # advertises its own pre-releases, so this is the normal case there.
+    if _is_prerelease(latest) and not _is_prerelease(current):
+        return
     _notified = True
     print(file=sys.stderr)
     print(
         f"  A new version of boxd is available (v{latest}, you have v{current}). Update with:",
         file=sys.stderr,
     )
-    print(f"    {UPGRADE_CMD}", file=sys.stderr)
+    cmd = PRERELEASE_UPGRADE_CMD if _is_prerelease(latest) else UPGRADE_CMD
+    print(f"    {cmd}", file=sys.stderr)
+
+
+def _stderr_is_tty() -> bool:
+    """Is stderr a terminal? Indirected through a function so tests can say.
+
+    (A capture fixture replaces ``sys.stderr`` wholesale, so patching the
+    stream's ``isatty`` is not something a test can rely on.)
+    """
+    try:
+        return bool(sys.stderr.isatty())
+    except Exception:  # closed or exotic stream: not a terminal
+        return False
+
+
+def _is_prerelease(v: str) -> bool:
+    """Does this version carry a pre-release suffix ("0.2.6.dev356")?"""
+    m = _SEMVER_RE.match(v.strip())
+    return bool(m and m.group(4))
 
 
 _SEMVER_RE = re.compile(r"^(\d+)\.(\d+)\.(\d+)(.*)$")

boxd/models.py

@@ -68,6 +68,11 @@ class MachineAccess(BaseModel):
     """The domain the machine is addressed under."""
     url: str
     """`https://<name>.<domain>` — built for you, not sent by the server."""
+    desktop_url: str = ""
+    """The machine's live Desktop view in the console —
+    `https://app.<zone>/desktop/<name>`. Built for you, like `url`. Empty when
+    the client has no endpoint to derive the console origin from. Opening it
+    needs a signed-in browser; the machine is woken if it is asleep."""
     custom_domains: list[CustomDomain]
     """Per-VM custom domains bound to this machine (BOX-30), e.g.
     `app.example.com`. Distinct from `domain` above, which is the org's

boxd/resources/machines.py

@@ -259,7 +259,8 @@ class Machines(Namespace):
     def get(self, machine_id: str) -> Machine:
         """Fetch one machine by id or name."""
         return m.machine(
-            self._transport.call("GetVm", api_pb2.GetVmRequest(vm_id=machine_id))
+            self._transport.call("GetVm", api_pb2.GetVmRequest(vm_id=machine_id)),
+            self._transport.console_origin,
         )
 
     def list(self, *, org: str | None = None, all_contexts: bool = False) -> list[Machine]:
@@ -271,7 +272,8 @@ class Machines(Namespace):
         resp = self._transport.call(
             "ListVms", req.list_vms(org=org, all_contexts=all_contexts)
         )
-        return [m.machine(v) for v in resp.vms]
+        console_origin = self._transport.console_origin
+        return [m.machine(v, console_origin) for v in resp.vms]
 
     def delete(self, machine_id: str) -> None:
         """Destroy a machine. Terminal."""
@@ -828,7 +830,8 @@ class AsyncMachines(Namespace):
     async def get(self, machine_id: str) -> Machine:
         """Fetch one machine by id or name."""
         return m.machine(
-            await self._transport.call("GetVm", api_pb2.GetVmRequest(vm_id=machine_id))
+            await self._transport.call("GetVm", api_pb2.GetVmRequest(vm_id=machine_id)),
+            self._transport.console_origin,
         )
 
     async def list(
@@ -838,7 +841,8 @@ class AsyncMachines(Namespace):
         resp = await self._transport.call(
             "ListVms", req.list_vms(org=org, all_contexts=all_contexts)
         )
-        return [m.machine(v) for v in resp.vms]
+        console_origin = self._transport.console_origin
+        return [m.machine(v, console_origin) for v in resp.vms]
 
     async def delete(self, machine_id: str) -> None:
         """Destroy a machine. Terminal."""

{boxd-0.2.6.dev355.dist-info → boxd-0.2.6.dev398.dist-info}/METADATA

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

{boxd-0.2.6.dev355.dist-info → boxd-0.2.6.dev398.dist-info}/RECORD

@@ -1,14 +1,14 @@
 boxd/__init__.py,sha256=4fGbOYgQ_32_GQCLf7Nv4CTWfuSvdomx5tr57QA-zys,2868
 boxd/_client.py,sha256=oqJ_XtuzmmKW1jgzQ57na-ndT7PzAd8-QAxoYNbLpY0,5161
 boxd/_credentials.py,sha256=Z7sjbl9Y_tcKBLk6PA5YOSNews8GrYr391phFpnrW3E,11492
-boxd/_mappers.py,sha256=8VqmwdNM1RqqGbn-1Ub1frKwg3hX9OBCKf3r69S2JBQ,12597
+boxd/_mappers.py,sha256=kHnqVWUyixHS-XsEkNALlvXhGqp1RL-pOicfrLntv5U,12936
 boxd/_requests.py,sha256=s3d0IKxJjyX0klJwNaufYRWt4lwlQdxQgjAD6aNL6q4,9734
 boxd/_streaming.py,sha256=MEhPUhgdnwGnk0H8xUKx8kx2z-3Mcmhx4iS-yO-ifvI,6222
-boxd/_transport.py,sha256=tWzZuKDmN4sFtJZvCitvkWtv1Vc_rTvPlmWGHMT3DMU,8293
+boxd/_transport.py,sha256=pU9pY3V6UBj8prnO5suo7g32saadhL-EiffXi3Agtjs,8750
 boxd/_urls.py,sha256=pVwXTQGBmSieY-wwvXx5l6Be5lIrBcnjOdCCMMwW1Hs,3654
-boxd/_version_check.py,sha256=nhD6FazxaqGRjOPeAER3U0PBCEZPwNDuJjS3s1Ycpwo,4128
+boxd/_version_check.py,sha256=XJD_BY1CH5xOn2ArrbO2ZQXI6xf41o-zwQIReohF8sg,5623
 boxd/errors.py,sha256=Vapb1US78lxMvnzqsQ6oyHl2r_rs417Hl8YucT5Lme8,3435
-boxd/models.py,sha256=wKehB8m1ydLt3jxSfHUg_u2Sbx8Xk8ZicN-NBCjZ4Yk,13960
+boxd/models.py,sha256=Mi0zRgJL3nkkeUiSU7dtT7ggc9NJi_dTHL3XBAcNxF4,14272
 boxd/_generated/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 boxd/_generated/api_pb2.py,sha256=iSLbWoV1wOuF0fv-ylNl3cRnnCdubqyfYuh3N3cmAAY,55350
 boxd/_generated/api_pb2_grpc.py,sha256=9k6x_bxyEi7S3SLlGXiFdZwsRJIOSwsv8NCgvI0XoSc,148445
@@ -17,12 +17,12 @@ boxd/resources/account.py,sha256=9I9iHHjmEOxvrJSP773uKVMHORgPvaZBKCWkhuaNNSo,286
 boxd/resources/credentials.py,sha256=sFl2jFnyu7D_a-vZMfBWfnMGu31VzO-h2-JkFe0DEmA,3365
 boxd/resources/disks.py,sha256=lqlAJxt1mMvmsQCfBabsTtDMAbPkfz3xD9W_aVvCLqg,3785
 boxd/resources/domains.py,sha256=e5cY6f4iTVny2m_BRVrrKf4KR452i9FAdS64_RvzhIk,2967
-boxd/resources/machines.py,sha256=NzqpjL22tVM95QMe-N-oDzH6lO1OoF0l6h1NLm8AzII,47746
+boxd/resources/machines.py,sha256=MDyw5HphuI7YNFKPbTkjG0QFWWnQxq7F2RloM8-59xg,47980
 boxd/resources/orgs.py,sha256=KMG5MDZiZWbFgtwBR_F6tpwr1Kzjvnr6S5HOMPndd_0,7702
 boxd/resources/snapshots.py,sha256=xzVvBqcjimeor0pcWMyrGePxBJ-aV8NPbKYuIvu6epU,3181
 boxd/resources/vars.py,sha256=SuiK6h15Ols9TLA28WIRP_a86PfAnoDIDsi2JH1ZVVs,8301
-boxd-0.2.6.dev355.dist-info/licenses/LICENSE,sha256=rD8_32iKSf_QarUkwB8tTujEORtC3uYs4KIggm6cFKg,1061
-boxd-0.2.6.dev355.dist-info/METADATA,sha256=TVmFv9lC1_ijqYLX0JMxk0wa6FRsmCHogZY0PuHEbZY,26582
-boxd-0.2.6.dev355.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-boxd-0.2.6.dev355.dist-info/top_level.txt,sha256=lJFbtvnDUx23dMMfX5hqRWPjtUhgrLpNJ9qdCPwON30,5
-boxd-0.2.6.dev355.dist-info/RECORD,,
+boxd-0.2.6.dev398.dist-info/licenses/LICENSE,sha256=rD8_32iKSf_QarUkwB8tTujEORtC3uYs4KIggm6cFKg,1061
+boxd-0.2.6.dev398.dist-info/METADATA,sha256=_019etJ5MicQQwdEoCTAdYdU4BxhX4SjnjT1nfztMBI,26582
+boxd-0.2.6.dev398.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+boxd-0.2.6.dev398.dist-info/top_level.txt,sha256=lJFbtvnDUx23dMMfX5hqRWPjtUhgrLpNJ9qdCPwON30,5
+boxd-0.2.6.dev398.dist-info/RECORD,,