subspacecomputing 0.1.1__tar.gz → 0.1.2__tar.gz

{subspacecomputing-0.1.1/subspacecomputing.egg-info → subspacecomputing-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: subspacecomputing
-Version: 0.1.1
+Version: 0.1.2
 Summary: Python SDK for Subspace Computing Engine API (by Beausoft)
 Home-page: https://www.subspacecomputing.com/developer
 Author: Beausoft
@@ -49,6 +49,17 @@ bsce = BSCE(api_key='your-api-key-here')
 # bsce = BSCE(api_key='your-api-key-here', base_url='http://localhost:8000')
 ```
 
+### Teams (`X-Team-Id`)
+
+Keys can carry a `default_team_id` from the portal. If the user is in **several** teams, some endpoints require an explicit team: pass `team_id=...` or call `set_team_id` so the SDK sends `X-Team-Id`.
+
+If you omit it when required, the API returns **400** with `error.reason` **`team_context_required`**. Use `ValidationError` and read `exc.reason`.
+
+```python
+bsce = BSCE(api_key="...", team_id="00000000-0000-0000-0000-000000000000")
+bsce.set_team_id(None)  # clear override for following requests
+```
+
 ### Simple Projection (1 scenario)
 
 ```python

{subspacecomputing-0.1.1 → subspacecomputing-0.1.2}/README.md

@@ -22,6 +22,17 @@ bsce = BSCE(api_key='your-api-key-here')
 # bsce = BSCE(api_key='your-api-key-here', base_url='http://localhost:8000')
 ```
 
+### Teams (`X-Team-Id`)
+
+Keys can carry a `default_team_id` from the portal. If the user is in **several** teams, some endpoints require an explicit team: pass `team_id=...` or call `set_team_id` so the SDK sends `X-Team-Id`.
+
+If you omit it when required, the API returns **400** with `error.reason` **`team_context_required`**. Use `ValidationError` and read `exc.reason`.
+
+```python
+bsce = BSCE(api_key="...", team_id="00000000-0000-0000-0000-000000000000")
+bsce.set_team_id(None)  # clear override for following requests
+```
+
 ### Simple Projection (1 scenario)
 
 ```python

{subspacecomputing-0.1.1 → subspacecomputing-0.1.2}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "subspacecomputing"
-version = "0.1.1"
+version = "0.1.2"
 description = "Python SDK for Subspace Computing Engine API (by Beausoft)"
 authors = [{name = "Beausoft", email = "contact@beausoft.ca"}]
 readme = "README.md"
@@ -25,6 +25,7 @@ dev = [
     "fastapi>=0.100.0",  # Pour tests d'intégration
 ]
 
+# No Git repository URL: built from a private monorepo; only public product URLs are published on PyPI.
 [project.urls]
 Documentation = "https://www.subspacecomputing.com/developer"
 Homepage = "https://www.subspacecomputing.com/developer"

{subspacecomputing-0.1.1 → subspacecomputing-0.1.2}/setup.py

@@ -13,7 +13,7 @@ except FileNotFoundError:
 
 setup(
     name="subspacecomputing",
-    version="0.1.1",
+    version="0.1.2",
     description="Python SDK for Subspace Computing Engine API (by Beausoft)",
     long_description=long_description,
     long_description_content_type="text/markdown",

{subspacecomputing-0.1.1 → subspacecomputing-0.1.2}/subspacecomputing/__init__.py

@@ -13,7 +13,7 @@ from .errors import (
     ValidationError,
 )
 
-__version__ = "0.1.1"
+__version__ = "0.1.2"
 __all__ = [
     "BSCE",
     "BSCEError",

{subspacecomputing-0.1.1 → subspacecomputing-0.1.2}/subspacecomputing/client.py

@@ -26,6 +26,8 @@ class BSCE:
         api_key: str,
         base_url: Optional[str] = None,
         timeout: Optional[int] = None,
+        *,
+        team_id: Optional[str] = None,
     ):
         """
         Initialize the BSCE client.
@@ -36,6 +38,7 @@ class BSCE:
             base_url: API base URL (optional, defaults to https://api.subspacecomputing.com).
                      Only useful for local testing or custom environments.
             timeout: Request timeout in seconds (optional, defaults to 60).
+            team_id: Optional team UUID for header ``X-Team-Id`` (override default_team_id on the key).
 
         Raises:
             ValueError: If api_key is empty or None.
@@ -47,13 +50,25 @@ class BSCE:
         self.api_key = api_key.strip()
         self.base_url = (base_url or "https://api.subspacecomputing.com").rstrip("/")
         self.timeout = timeout if timeout is not None else DEFAULT_TIMEOUT
+        self._team_id = (team_id or "").strip() or None
         self.session = requests.Session()
-        self.session.headers.update({
+        headers = {
             "X-API-Key": self.api_key,
             "Content-Type": "application/json",
-        })
+        }
+        if self._team_id:
+            headers["X-Team-Id"] = self._team_id
+        self.session.headers.update(headers)
         self.last_response = None  # Store last response for header access
 
+    def set_team_id(self, team_id: Optional[str] = None) -> None:
+        """Set or clear ``X-Team-Id`` for subsequent requests."""
+        self._team_id = (team_id or "").strip() or None
+        if self._team_id:
+            self.session.headers["X-Team-Id"] = self._team_id
+        else:
+            self.session.headers.pop("X-Team-Id", None)
+
     def _handle_response(self, response: requests.Response):
         """
         Handle HTTP errors and raise appropriate exceptions.
@@ -445,6 +460,24 @@ class BSCE:
         self._handle_response(response)
         # 204 No Content, no body
 
+    def get_run_artifact(self, artifact_id: str) -> Dict[str, Any]:
+        """
+        Fetch a run artifact by id (authZ: view on parent projection).
+
+        Args:
+            artifact_id: run_artifacts.id
+
+        Returns:
+            Artifact payload (may include final_values or url).
+        """
+        response = self.session.get(
+            f"{self.base_url}/run-artifacts/{artifact_id}",
+            timeout=self.timeout,
+        )
+        self.last_response = response
+        self._handle_response(response)
+        return response.json()
+
     # Helper methods for accessing rate limit and quota info
 
     @staticmethod

{subspacecomputing-0.1.1 → subspacecomputing-0.1.2}/subspacecomputing/errors.py

@@ -3,7 +3,7 @@ Custom exceptions for the Subspace Computing SDK.
 """
 
 import requests
-from typing import Optional
+from typing import Any, Optional
 
 
 class BSCEError(Exception):
@@ -13,19 +13,31 @@ class BSCEError(Exception):
         self.message = message
         self.response = response
         self.status_code = response.status_code if response else None
-        self.detail = None
+        self.detail: Any = None
+        self._body: Optional[dict] = None
 
-        # Try to extract error details from the response
         if response is not None:
             try:
                 error_data = response.json()
                 if isinstance(error_data, dict):
+                    self._body = error_data
                     self.detail = error_data.get("detail", error_data.get("message"))
             except ValueError:
                 self.detail = response.text
 
         super().__init__(self.message)
 
+    @property
+    def reason(self) -> Optional[str]:
+        """Clé stable contrat §6.8 si le corps est ``{\"error\": {\"reason\": ...}}``."""
+        if not self._body:
+            return None
+        err = self._body.get("error")
+        if isinstance(err, dict):
+            r = err.get("reason")
+            return str(r) if r is not None else None
+        return None
+
     def __str__(self):
         if self.detail:
             return f"{self.message}: {self.detail}"

{subspacecomputing-0.1.1 → subspacecomputing-0.1.2/subspacecomputing.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: subspacecomputing
-Version: 0.1.1
+Version: 0.1.2
 Summary: Python SDK for Subspace Computing Engine API (by Beausoft)
 Home-page: https://www.subspacecomputing.com/developer
 Author: Beausoft
@@ -49,6 +49,17 @@ bsce = BSCE(api_key='your-api-key-here')
 # bsce = BSCE(api_key='your-api-key-here', base_url='http://localhost:8000')
 ```
 
+### Teams (`X-Team-Id`)
+
+Keys can carry a `default_team_id` from the portal. If the user is in **several** teams, some endpoints require an explicit team: pass `team_id=...` or call `set_team_id` so the SDK sends `X-Team-Id`.
+
+If you omit it when required, the API returns **400** with `error.reason` **`team_context_required`**. Use `ValidationError` and read `exc.reason`.
+
+```python
+bsce = BSCE(api_key="...", team_id="00000000-0000-0000-0000-000000000000")
+bsce.set_team_id(None)  # clear override for following requests
+```
+
 ### Simple Projection (1 scenario)
 
 ```python