boxd 0.1.0.dev2__tar.gz → 0.1.1.dev4__tar.gz

{boxd-0.1.0.dev2/src/boxd.egg-info → boxd-0.1.1.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boxd
-Version: 0.1.0.dev2
+Version: 0.1.1.dev4
 Summary: Python SDK for the boxd cloud VM platform
 Author: Azin
 License-Expression: MIT
@@ -65,16 +65,27 @@ Compute()                      # reads BOXD_API_KEY or BOXD_TOKEN
 
 ## Configuration
 
-The SDK reads its endpoint configuration from constructor arguments or env vars:
+Pick a named cluster preset:
+
+```python
+Compute(api_key="bxk_...")                            # production (default)
+Compute(api_key="bxd_...", environment="staging")     # boxd-stg.sh
+```
+
+`environment` also reads from the `BOXD_ENVIRONMENT` env var (`"production"` or `"staging"`).
+
+For custom or self-hosted endpoints, override URLs explicitly — these take precedence over `environment`:
 
 ```python
 Compute(
     api_key="bxk_...",
-    api_url="http://boxd.sh:9443",                     # default
-    exchange_url="https://boxd.sh/api/v1/auth/token",  # default
+    api_url="http://my-boxd.example.com:9443",
+    exchange_url="https://my-boxd.example.com/api/v1/auth/token",
 )
 ```
 
+Env vars `BOXD_API_URL` / `BOXD_EXCHANGE_URL` override the preset too.
+
 Equivalent env vars: `BOXD_API_KEY`, `BOXD_TOKEN`, `BOXD_API_URL`, `BOXD_EXCHANGE_URL`.
 
 `api_url` accepts an optional URL scheme that controls TLS:

{boxd-0.1.0.dev2 → boxd-0.1.1.dev4}/README.md

@@ -32,16 +32,27 @@ Compute()                      # reads BOXD_API_KEY or BOXD_TOKEN
 
 ## Configuration
 
-The SDK reads its endpoint configuration from constructor arguments or env vars:
+Pick a named cluster preset:
+
+```python
+Compute(api_key="bxk_...")                            # production (default)
+Compute(api_key="bxd_...", environment="staging")     # boxd-stg.sh
+```
+
+`environment` also reads from the `BOXD_ENVIRONMENT` env var (`"production"` or `"staging"`).
+
+For custom or self-hosted endpoints, override URLs explicitly — these take precedence over `environment`:
 
 ```python
 Compute(
     api_key="bxk_...",
-    api_url="http://boxd.sh:9443",                     # default
-    exchange_url="https://boxd.sh/api/v1/auth/token",  # default
+    api_url="http://my-boxd.example.com:9443",
+    exchange_url="https://my-boxd.example.com/api/v1/auth/token",
 )
 ```
 
+Env vars `BOXD_API_URL` / `BOXD_EXCHANGE_URL` override the preset too.
+
 Equivalent env vars: `BOXD_API_KEY`, `BOXD_TOKEN`, `BOXD_API_URL`, `BOXD_EXCHANGE_URL`.
 
 `api_url` accepts an optional URL scheme that controls TLS:

{boxd-0.1.0.dev2 → boxd-0.1.1.dev4}/pyproject.toml

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

{boxd-0.1.0.dev2 → boxd-0.1.1.dev4}/src/boxd/__init__.py

@@ -63,7 +63,13 @@ from .errors import (
     ConnectionError,
 )
 
-__version__ = "0.1.0"
+try:
+    from importlib.metadata import version as _pkg_version
+
+    __version__ = _pkg_version("boxd")
+except Exception:
+    # Fallback for source checkouts where the package isn't installed.
+    __version__ = "0.0.0+source"
 
 __all__ = [
     # Main client (sync)

{boxd-0.1.0.dev2 → boxd-0.1.1.dev4}/src/boxd/_sync.py

@@ -411,6 +411,7 @@ class Compute(_SyncBase):
         token: str | None = None,
         api_url: str | None = None,
         exchange_url: str | None = None,
+        environment: str | None = None,
     ) -> None:
         from .client import Compute as AsyncCompute
 
@@ -420,6 +421,7 @@ class Compute(_SyncBase):
             token=token,
             api_url=api_url,
             exchange_url=exchange_url,
+            environment=environment,
         )
         self.box = BoxService(self._async.box, self._loop)
         self.template = TemplateService(self._async.template, self._loop)

{boxd-0.1.0.dev2 → boxd-0.1.1.dev4}/src/boxd/client.py

@@ -22,6 +22,31 @@ from .types import ConfigResult, WhoamiResult
 _DEFAULT_API_URL = "http://boxd.sh:9443"
 _DEFAULT_EXCHANGE_URL = "https://boxd.sh/api/v1/auth/token"
 
+# Named environments. Each is a (api_url, exchange_url) preset; explicit
+# api_url / exchange_url args still override.
+_ENVIRONMENT_URLS: dict[str, tuple[str, str]] = {
+    "production": (_DEFAULT_API_URL, _DEFAULT_EXCHANGE_URL),
+    "staging": (
+        "http://boxd-stg.sh:9443",
+        "https://boxd-stg.sh/api/v1/auth/token",
+    ),
+}
+
+
+def _resolve_environment(explicit: str | None) -> str:
+    """Pick environment preset: explicit arg > BOXD_ENVIRONMENT env > production."""
+    if explicit:
+        if explicit not in _ENVIRONMENT_URLS:
+            raise ValueError(
+                f"unknown environment {explicit!r}; expected one of "
+                f"{sorted(_ENVIRONMENT_URLS)}"
+            )
+        return explicit
+    from_env = os.environ.get("BOXD_ENVIRONMENT")
+    if from_env in _ENVIRONMENT_URLS:
+        return from_env
+    return "production"
+
 
 class Compute:
     """Main client for the boxd API.
@@ -39,16 +64,19 @@ class Compute:
         token: str | None = None,
         api_url: str | None = None,
         exchange_url: str | None = None,
+        environment: str | None = None,
     ) -> None:
+        env = _resolve_environment(environment)
+        preset_api_url, preset_exchange_url = _ENVIRONMENT_URLS[env]
         self._api_url = (
             api_url
             or os.environ.get("BOXD_API_URL")
-            or _DEFAULT_API_URL
+            or preset_api_url
         )
         self._exchange_url = (
             exchange_url
             or os.environ.get("BOXD_EXCHANGE_URL")
-            or _DEFAULT_EXCHANGE_URL
+            or preset_exchange_url
         )
 
         resolved_key = api_key or os.environ.get("BOXD_API_KEY")

{boxd-0.1.0.dev2 → boxd-0.1.1.dev4/src/boxd.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boxd
-Version: 0.1.0.dev2
+Version: 0.1.1.dev4
 Summary: Python SDK for the boxd cloud VM platform
 Author: Azin
 License-Expression: MIT
@@ -65,16 +65,27 @@ Compute()                      # reads BOXD_API_KEY or BOXD_TOKEN
 
 ## Configuration
 
-The SDK reads its endpoint configuration from constructor arguments or env vars:
+Pick a named cluster preset:
+
+```python
+Compute(api_key="bxk_...")                            # production (default)
+Compute(api_key="bxd_...", environment="staging")     # boxd-stg.sh
+```
+
+`environment` also reads from the `BOXD_ENVIRONMENT` env var (`"production"` or `"staging"`).
+
+For custom or self-hosted endpoints, override URLs explicitly — these take precedence over `environment`:
 
 ```python
 Compute(
     api_key="bxk_...",
-    api_url="http://boxd.sh:9443",                     # default
-    exchange_url="https://boxd.sh/api/v1/auth/token",  # default
+    api_url="http://my-boxd.example.com:9443",
+    exchange_url="https://my-boxd.example.com/api/v1/auth/token",
 )
 ```
 
+Env vars `BOXD_API_URL` / `BOXD_EXCHANGE_URL` override the preset too.
+
 Equivalent env vars: `BOXD_API_KEY`, `BOXD_TOKEN`, `BOXD_API_URL`, `BOXD_EXCHANGE_URL`.
 
 `api_url` accepts an optional URL scheme that controls TLS: