subspacecomputing 0.1.1__tar.gz → 0.1.4__tar.gz

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

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: subspacecomputing
-Version: 0.1.1
-Summary: Python SDK for Subspace Computing Engine API (by Beausoft)
+Version: 0.1.4
+Summary: Python SDK for ASTRIA — Subspace Computing Engine
 Home-page: https://www.subspacecomputing.com/developer
-Author: Beausoft
-Author-email: Beausoft <contact@beausoft.ca>
+Author: Subspace Computing
+Author-email: Subspace Computing <contact@beausoft.ca>
 Project-URL: Documentation, https://www.subspacecomputing.com/developer
 Project-URL: Homepage, https://www.subspacecomputing.com/developer
 Project-URL: Support, https://www.subspacecomputing.com/developer
@@ -20,6 +20,7 @@ Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
 Requires-Dist: black>=23.0.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
 Requires-Dist: fastapi>=0.100.0; extra == "dev"
+Requires-Dist: httpx>=0.25.0; extra == "dev"
 Dynamic: author
 Dynamic: home-page
 Dynamic: license-file
@@ -40,13 +41,24 @@ pip install subspacecomputing
 ### Initialization
 
 ```python
-from subspacecomputing import BSCE
+from subspacecomputing import ASTRIA
 
 # Initialize the client (defaults to production URL)
-bsce = BSCE(api_key='your-api-key-here')
+client = ASTRIA(api_key='your-api-key-here')
 
 # For local testing or custom environments (optional)
-# bsce = BSCE(api_key='your-api-key-here', base_url='http://localhost:8000')
+# client = ASTRIA(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
+client = ASTRIA(api_key="...", team_id="00000000-0000-0000-0000-000000000000")
+client.set_team_id(None)  # clear override for following requests
 ```
 
 ### Simple Projection (1 scenario)
@@ -66,7 +78,7 @@ spec = {
 }
 
 # Run the projection
-result = bsce.project(spec)
+result = client.project(spec)
 
 # Display results
 print(f"Final capital: {result['final_values']['capital']}")
@@ -96,7 +108,7 @@ spec = {
 }
 
 # Run the simulation
-result = bsce.simulate(spec)
+result = client.simulate(spec)
 
 # Analyze results
 print(f"Mean final capital: {result['last_mean']['capital']}")
@@ -150,7 +162,7 @@ aggregations = [
 ]
 
 # Run batch
-result = bsce.project_batch(
+result = client.project_batch(
     template=template,
     batch_params=batch_params,
     aggregations=aggregations
@@ -168,7 +180,7 @@ print(f"Average: {result['aggregations']['moyenne_capital']}")
 
 ```python
 # Validate an SP Model before execution
-validation = bsce.validate(spec)
+validation = client.validate(spec)
 
 if validation['is_valid']:
     print("✅ SP Model is valid")
@@ -182,15 +194,15 @@ else:
 
 ```python
 # Get examples
-examples = bsce.get_examples()
+examples = client.get_examples()
 print(f"Available examples: {len(examples['examples'])}")
 
 # Check usage
-usage = bsce.get_usage()
+usage = client.get_usage()
 print(f"Simulations used: {usage['usage']['simulations_used']}/{usage['usage']['simulations_limit']}")
 
 # Get plans
-plans = bsce.get_plans()
+plans = client.get_plans()
 for plan in plans['plans']:
     print(f"{plan['name']}: ${plan['price_monthly']}/month")
 ```
@@ -199,16 +211,16 @@ for plan in plans['plans']:
 
 ```python
 from subspacecomputing import (
-    BSCE,
+    Subspace,
+    SubspaceError,
     QuotaExceededError,
     RateLimitError,
     AuthenticationError,
     ValidationError,
-    BSCEError
 )
 
 try:
-    result = bsce.simulate(spec)
+    result = client.simulate(spec)
 except QuotaExceededError as e:
     print(f"Monthly quota exceeded: {e}")
 except RateLimitError as e:
@@ -218,7 +230,7 @@ except AuthenticationError as e:
     print(f"Invalid API key: {e}")
 except ValidationError as e:
     print(f"Validation error: {e.detail}")
-except BSCEError as e:
+except SubspaceError as e:
     print(f"API error: {e}")
 ```
 
@@ -228,15 +240,15 @@ After making a request, you can check your rate limit and quota status:
 
 ```python
 # Make a request
-result = bsce.project(spec)
+result = client.project(spec)
 
 # Check rate limit info
-rate_limit = bsce.get_rate_limit_info()
+rate_limit = client.get_rate_limit_info()
 if rate_limit:
     print(f"Rate limit: {rate_limit['remaining']}/{rate_limit['limit']} remaining")
 
 # Check quota info
-quota = bsce.get_quota_info()
+quota = client.get_quota_info()
 if quota:
     print(f"Quota: {quota['used']}/{quota['limit']} used, {quota['remaining']} remaining")
 ```

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

@@ -13,13 +13,24 @@ pip install subspacecomputing
 ### Initialization
 
 ```python
-from subspacecomputing import BSCE
+from subspacecomputing import ASTRIA
 
 # Initialize the client (defaults to production URL)
-bsce = BSCE(api_key='your-api-key-here')
+client = ASTRIA(api_key='your-api-key-here')
 
 # For local testing or custom environments (optional)
-# bsce = BSCE(api_key='your-api-key-here', base_url='http://localhost:8000')
+# client = ASTRIA(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
+client = ASTRIA(api_key="...", team_id="00000000-0000-0000-0000-000000000000")
+client.set_team_id(None)  # clear override for following requests
 ```
 
 ### Simple Projection (1 scenario)
@@ -39,7 +50,7 @@ spec = {
 }
 
 # Run the projection
-result = bsce.project(spec)
+result = client.project(spec)
 
 # Display results
 print(f"Final capital: {result['final_values']['capital']}")
@@ -69,7 +80,7 @@ spec = {
 }
 
 # Run the simulation
-result = bsce.simulate(spec)
+result = client.simulate(spec)
 
 # Analyze results
 print(f"Mean final capital: {result['last_mean']['capital']}")
@@ -123,7 +134,7 @@ aggregations = [
 ]
 
 # Run batch
-result = bsce.project_batch(
+result = client.project_batch(
     template=template,
     batch_params=batch_params,
     aggregations=aggregations
@@ -141,7 +152,7 @@ print(f"Average: {result['aggregations']['moyenne_capital']}")
 
 ```python
 # Validate an SP Model before execution
-validation = bsce.validate(spec)
+validation = client.validate(spec)
 
 if validation['is_valid']:
     print("✅ SP Model is valid")
@@ -155,15 +166,15 @@ else:
 
 ```python
 # Get examples
-examples = bsce.get_examples()
+examples = client.get_examples()
 print(f"Available examples: {len(examples['examples'])}")
 
 # Check usage
-usage = bsce.get_usage()
+usage = client.get_usage()
 print(f"Simulations used: {usage['usage']['simulations_used']}/{usage['usage']['simulations_limit']}")
 
 # Get plans
-plans = bsce.get_plans()
+plans = client.get_plans()
 for plan in plans['plans']:
     print(f"{plan['name']}: ${plan['price_monthly']}/month")
 ```
@@ -172,16 +183,16 @@ for plan in plans['plans']:
 
 ```python
 from subspacecomputing import (
-    BSCE,
+    Subspace,
+    SubspaceError,
     QuotaExceededError,
     RateLimitError,
     AuthenticationError,
     ValidationError,
-    BSCEError
 )
 
 try:
-    result = bsce.simulate(spec)
+    result = client.simulate(spec)
 except QuotaExceededError as e:
     print(f"Monthly quota exceeded: {e}")
 except RateLimitError as e:
@@ -191,7 +202,7 @@ except AuthenticationError as e:
     print(f"Invalid API key: {e}")
 except ValidationError as e:
     print(f"Validation error: {e.detail}")
-except BSCEError as e:
+except SubspaceError as e:
     print(f"API error: {e}")
 ```
 
@@ -201,15 +212,15 @@ After making a request, you can check your rate limit and quota status:
 
 ```python
 # Make a request
-result = bsce.project(spec)
+result = client.project(spec)
 
 # Check rate limit info
-rate_limit = bsce.get_rate_limit_info()
+rate_limit = client.get_rate_limit_info()
 if rate_limit:
     print(f"Rate limit: {rate_limit['remaining']}/{rate_limit['limit']} remaining")
 
 # Check quota info
-quota = bsce.get_quota_info()
+quota = client.get_quota_info()
 if quota:
     print(f"Quota: {quota['used']}/{quota['limit']} used, {quota['remaining']} remaining")
 ```

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

@@ -6,9 +6,9 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "subspacecomputing"
-version = "0.1.1"
-description = "Python SDK for Subspace Computing Engine API (by Beausoft)"
-authors = [{name = "Beausoft", email = "contact@beausoft.ca"}]
+version = "0.1.4"
+description = "Python SDK for ASTRIA — Subspace Computing Engine"
+authors = [{name = "Subspace Computing", email = "contact@beausoft.ca"}]
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
@@ -22,9 +22,11 @@ dev = [
     "pytest-cov>=4.0.0",
     "black>=23.0.0",
     "ruff>=0.1.0",
-    "fastapi>=0.100.0",  # Pour tests d'intégration
+    "fastapi>=0.100.0",
+    "httpx>=0.25.0",  # TestClient (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.4}/setup.py

@@ -1,5 +1,5 @@
 """
-Setup.py pour le SDK Python Beausoft Subspace Computing Engine.
+Setup.py pour le SDK Python ASTRIA — Subspace Computing Engine.
 """
 
 from setuptools import setup, find_packages
@@ -13,11 +13,11 @@ except FileNotFoundError:
 
 setup(
     name="subspacecomputing",
-    version="0.1.1",
-    description="Python SDK for Subspace Computing Engine API (by Beausoft)",
+    version="0.1.4",
+    description="Python SDK for ASTRIA — Subspace Computing Engine",
     long_description=long_description,
     long_description_content_type="text/markdown",
-    author="Beausoft",
+    author="Subspace Computing",
     author_email="contact@beausoft.ca",
     url="https://www.subspacecomputing.com/developer",
     packages=find_packages(),

subspacecomputing-0.1.4/subspacecomputing/__init__.py

@@ -0,0 +1,29 @@
+"""
+ASTRIA — Python SDK
+
+Python SDK for ASTRIA, the Subspace Computing Engine.
+"""
+
+from .client import ASTRIA, Subspace, BSCE  # Subspace & BSCE = backward compat aliases
+from .errors import (
+    SubspaceError,
+    BSCEError,  # backward compat alias
+    QuotaExceededError,
+    RateLimitError,
+    AuthenticationError,
+    ValidationError,
+)
+
+__version__ = "0.1.4"
+__all__ = [
+    "ASTRIA",
+    "SubspaceError",
+    "QuotaExceededError",
+    "RateLimitError",
+    "AuthenticationError",
+    "ValidationError",
+    # Backward compatibility
+    "Subspace",
+    "BSCE",
+    "BSCEError",
+]

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

@@ -7,7 +7,7 @@ This module provides a simple Python interface to interact with the Subspace Com
 import requests
 from typing import Dict, Any, Optional, List
 from .errors import (
-    BSCEError,
+    SubspaceError,
     QuotaExceededError,
     RateLimitError,
     AuthenticationError,
@@ -18,17 +18,19 @@ from .errors import (
 DEFAULT_TIMEOUT = 60
 
 
-class BSCE:
-    """Python client for Subspace Computing Engine API."""
+class ASTRIA:
+    """ASTRIA — Moteur de calcul Subspace Computing. Client Python pour l'API."""
 
     def __init__(
         self,
         api_key: str,
         base_url: Optional[str] = None,
         timeout: Optional[int] = None,
+        *,
+        team_id: Optional[str] = None,
     ):
         """
-        Initialize the BSCE client.
+        Initialize the ASTRIA client.
 
         Args:
             api_key: Your API key (format: be_live_... or sk_pro_...).
@@ -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.
@@ -66,7 +81,7 @@ class BSCE:
             QuotaExceededError: If monthly quota exceeded (429)
             AuthenticationError: If API key invalid (401)
             ValidationError: If validation error (400)
-            BSCEError: For other errors
+            SubspaceError: For other errors
         """
         if response.status_code == 429:
             # Check if it's rate limit or quota
@@ -81,11 +96,11 @@ class BSCE:
                 response,
             )
         elif response.status_code == 403:
-            raise BSCEError("Access denied", response)
+            raise SubspaceError("Access denied", response)
         elif response.status_code == 400:
             raise ValidationError("Validation error", response)
         elif not response.ok:
-            raise BSCEError(f"API error: {response.status_code}", response)
+            raise SubspaceError(f"API error: {response.status_code}", response)
 
     # Main endpoints (calculations)
 
@@ -331,7 +346,7 @@ class BSCE:
             projection_id: Projection ID
 
         Raises:
-            BSCEError: If error during deletion
+            SubspaceError: If error during deletion
         """
         response = self.session.delete(
             f"{self.base_url}/projections/{projection_id}",
@@ -435,7 +450,7 @@ class BSCE:
             run_id: Run ID
 
         Raises:
-            BSCEError: If error during deletion
+            SubspaceError: If error during deletion
         """
         response = self.session.delete(
             f"{self.base_url}/projection-runs/{run_id}",
@@ -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
@@ -497,3 +530,8 @@ class BSCE:
             "remaining": self._safe_int(remaining),
             "used": self._safe_int(used),
         }
+
+
+# Backward compatibility aliases
+Subspace = ASTRIA
+BSCE = ASTRIA

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

@@ -3,54 +3,70 @@ Custom exceptions for the Subspace Computing SDK.
 """
 
 import requests
-from typing import Optional
+from typing import Any, Optional
 
 
-class BSCEError(Exception):
+class SubspaceError(Exception):
     """Base error for the Subspace Computing SDK."""
 
     def __init__(self, message: str, response: Optional[requests.Response] = None):
         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]:
+        """Structured error reason string, if the response body contains ``{"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}"
         return self.message
 
 
-class QuotaExceededError(BSCEError):
+class QuotaExceededError(SubspaceError):
     """Monthly quota exceeded (429)."""
 
     pass
 
 
-class RateLimitError(BSCEError):
+class RateLimitError(SubspaceError):
     """Rate limit exceeded (429)."""
 
     pass
 
 
-class AuthenticationError(BSCEError):
+class AuthenticationError(SubspaceError):
     """Invalid or missing API key (401)."""
 
     pass
 
 
-class ValidationError(BSCEError):
+class ValidationError(SubspaceError):
     """SP Model validation error (400)."""
 
     pass
+
+
+# Backward compatibility alias
+BSCEError = SubspaceError

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

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: subspacecomputing
-Version: 0.1.1
-Summary: Python SDK for Subspace Computing Engine API (by Beausoft)
+Version: 0.1.4
+Summary: Python SDK for ASTRIA — Subspace Computing Engine
 Home-page: https://www.subspacecomputing.com/developer
-Author: Beausoft
-Author-email: Beausoft <contact@beausoft.ca>
+Author: Subspace Computing
+Author-email: Subspace Computing <contact@beausoft.ca>
 Project-URL: Documentation, https://www.subspacecomputing.com/developer
 Project-URL: Homepage, https://www.subspacecomputing.com/developer
 Project-URL: Support, https://www.subspacecomputing.com/developer
@@ -20,6 +20,7 @@ Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
 Requires-Dist: black>=23.0.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
 Requires-Dist: fastapi>=0.100.0; extra == "dev"
+Requires-Dist: httpx>=0.25.0; extra == "dev"
 Dynamic: author
 Dynamic: home-page
 Dynamic: license-file
@@ -40,13 +41,24 @@ pip install subspacecomputing
 ### Initialization
 
 ```python
-from subspacecomputing import BSCE
+from subspacecomputing import ASTRIA
 
 # Initialize the client (defaults to production URL)
-bsce = BSCE(api_key='your-api-key-here')
+client = ASTRIA(api_key='your-api-key-here')
 
 # For local testing or custom environments (optional)
-# bsce = BSCE(api_key='your-api-key-here', base_url='http://localhost:8000')
+# client = ASTRIA(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
+client = ASTRIA(api_key="...", team_id="00000000-0000-0000-0000-000000000000")
+client.set_team_id(None)  # clear override for following requests
 ```
 
 ### Simple Projection (1 scenario)
@@ -66,7 +78,7 @@ spec = {
 }
 
 # Run the projection
-result = bsce.project(spec)
+result = client.project(spec)
 
 # Display results
 print(f"Final capital: {result['final_values']['capital']}")
@@ -96,7 +108,7 @@ spec = {
 }
 
 # Run the simulation
-result = bsce.simulate(spec)
+result = client.simulate(spec)
 
 # Analyze results
 print(f"Mean final capital: {result['last_mean']['capital']}")
@@ -150,7 +162,7 @@ aggregations = [
 ]
 
 # Run batch
-result = bsce.project_batch(
+result = client.project_batch(
     template=template,
     batch_params=batch_params,
     aggregations=aggregations
@@ -168,7 +180,7 @@ print(f"Average: {result['aggregations']['moyenne_capital']}")
 
 ```python
 # Validate an SP Model before execution
-validation = bsce.validate(spec)
+validation = client.validate(spec)
 
 if validation['is_valid']:
     print("✅ SP Model is valid")
@@ -182,15 +194,15 @@ else:
 
 ```python
 # Get examples
-examples = bsce.get_examples()
+examples = client.get_examples()
 print(f"Available examples: {len(examples['examples'])}")
 
 # Check usage
-usage = bsce.get_usage()
+usage = client.get_usage()
 print(f"Simulations used: {usage['usage']['simulations_used']}/{usage['usage']['simulations_limit']}")
 
 # Get plans
-plans = bsce.get_plans()
+plans = client.get_plans()
 for plan in plans['plans']:
     print(f"{plan['name']}: ${plan['price_monthly']}/month")
 ```
@@ -199,16 +211,16 @@ for plan in plans['plans']:
 
 ```python
 from subspacecomputing import (
-    BSCE,
+    Subspace,
+    SubspaceError,
     QuotaExceededError,
     RateLimitError,
     AuthenticationError,
     ValidationError,
-    BSCEError
 )
 
 try:
-    result = bsce.simulate(spec)
+    result = client.simulate(spec)
 except QuotaExceededError as e:
     print(f"Monthly quota exceeded: {e}")
 except RateLimitError as e:
@@ -218,7 +230,7 @@ except AuthenticationError as e:
     print(f"Invalid API key: {e}")
 except ValidationError as e:
     print(f"Validation error: {e.detail}")
-except BSCEError as e:
+except SubspaceError as e:
     print(f"API error: {e}")
 ```
 
@@ -228,15 +240,15 @@ After making a request, you can check your rate limit and quota status:
 
 ```python
 # Make a request
-result = bsce.project(spec)
+result = client.project(spec)
 
 # Check rate limit info
-rate_limit = bsce.get_rate_limit_info()
+rate_limit = client.get_rate_limit_info()
 if rate_limit:
     print(f"Rate limit: {rate_limit['remaining']}/{rate_limit['limit']} remaining")
 
 # Check quota info
-quota = bsce.get_quota_info()
+quota = client.get_quota_info()
 if quota:
     print(f"Quota: {quota['used']}/{quota['limit']} used, {quota['remaining']} remaining")
 ```

{subspacecomputing-0.1.1 → subspacecomputing-0.1.4}/subspacecomputing.egg-info/requires.txt

@@ -6,6 +6,7 @@ pytest-cov>=4.0.0
 black>=23.0.0
 ruff>=0.1.0
 fastapi>=0.100.0
+httpx>=0.25.0
 
 [pandas]
 pandas>=2.0.0

{subspacecomputing-0.1.1 → subspacecomputing-0.1.4}/tests/test_client_integration.py

@@ -15,7 +15,7 @@ sys.path.insert(0, str(Path(__file__).parent.parent.parent.parent))
 
 from fastapi.testclient import TestClient
 from api.main import app
-from subspacecomputing import BSCE
+from subspacecomputing import ASTRIA
 
 
 @pytest.fixture
@@ -33,7 +33,7 @@ def sdk_client(api_key, api_client):
     fonctionne avec le SDK qui utilise requests.Session.
     """
     # Créer une instance du SDK
-    client = BSCE(api_key=api_key, base_url="http://testserver")
+    client = ASTRIA(api_key=api_key, base_url="http://testserver")
     
     # Créer un mock pour requests.Session qui utilise TestClient
     def make_request(method, url, **kwargs):

{subspacecomputing-0.1.1 → subspacecomputing-0.1.4}/tests/test_client_unit.py

@@ -7,8 +7,8 @@ Ces tests vérifient le comportement du SDK sans dépendre de l'API réelle.
 import pytest
 from unittest.mock import Mock, patch
 from subspacecomputing import (
-    BSCE,
-    BSCEError,
+    ASTRIA,
+    SubspaceError,
     QuotaExceededError,
     RateLimitError,
     AuthenticationError,
@@ -21,30 +21,30 @@ class TestClientInitialization:
 
     def test_init_with_api_key(self, api_key, base_url):
         """Test initialisation avec API key."""
-        bsce = BSCE(api_key=api_key, base_url=base_url)
-        assert bsce.api_key == api_key
-        assert bsce.base_url == base_url
-        assert 'X-API-Key' in bsce.session.headers
-        assert bsce.session.headers['X-API-Key'] == api_key
+        client = ASTRIA(api_key=api_key, base_url=base_url)
+        assert client.api_key == api_key
+        assert client.base_url == base_url
+        assert 'X-API-Key' in client.session.headers
+        assert client.session.headers['X-API-Key'] == api_key
 
     def test_init_default_base_url(self, api_key):
         """Test initialisation avec URL par défaut."""
-        bsce = BSCE(api_key=api_key)
-        assert bsce.base_url == 'https://api.subspacecomputing.com'
+        client = ASTRIA(api_key=api_key)
+        assert client.base_url == 'https://api.subspacecomputing.com'
 
     def test_init_strips_trailing_slash(self, api_key):
         """Test que l'URL est nettoyée (pas de slash final)."""
-        bsce = BSCE(api_key=api_key, base_url='http://localhost:8000/')
-        assert bsce.base_url == 'http://localhost:8000'
+        client = ASTRIA(api_key=api_key, base_url='http://localhost:8000/')
+        assert client.base_url == 'http://localhost:8000'
 
     def test_init_rejects_empty_api_key(self):
         """Test que api_key vide lève ValueError."""
         with pytest.raises(ValueError, match="API key is required"):
-            BSCE(api_key="")
+            ASTRIA(api_key="")
         with pytest.raises(ValueError, match="API key is required"):
-            BSCE(api_key="   ")
+            ASTRIA(api_key="   ")
         with pytest.raises(ValueError, match="API key is required"):
-            BSCE(api_key=None)
+            ASTRIA(api_key=None)
 
 
 class TestErrorHandling:
@@ -52,7 +52,7 @@ class TestErrorHandling:
 
     def test_rate_limit_error(self, api_key, base_url):
         """Test gestion erreur 429 (rate limit)."""
-        bsce = BSCE(api_key=api_key, base_url=base_url)
+        client = ASTRIA(api_key=api_key, base_url=base_url)
 
         mock_response = Mock()
         mock_response.status_code = 429
@@ -60,14 +60,14 @@ class TestErrorHandling:
         mock_response.headers = {"Retry-After": "60"}
         mock_response.ok = False
 
-        with patch.object(bsce.session, 'post', return_value=mock_response):
+        with patch.object(client.session, 'post', return_value=mock_response):
             with pytest.raises(RateLimitError) as exc_info:
-                bsce.simulate({'scenarios': 100, 'steps': 12, 'variables': []})
+                client.simulate({'scenarios': 100, 'steps': 12, 'variables': []})
             assert "Rate limit" in str(exc_info.value)
 
     def test_quota_exceeded_error(self, api_key, base_url):
         """Test gestion erreur 429 (quota mensuel)."""
-        bsce = BSCE(api_key=api_key, base_url=base_url)
+        client = ASTRIA(api_key=api_key, base_url=base_url)
 
         mock_response = Mock()
         mock_response.status_code = 429
@@ -75,28 +75,28 @@ class TestErrorHandling:
         mock_response.headers = {}
         mock_response.ok = False
 
-        with patch.object(bsce.session, 'post', return_value=mock_response):
+        with patch.object(client.session, 'post', return_value=mock_response):
             with pytest.raises(QuotaExceededError) as exc_info:
-                bsce.simulate({'scenarios': 100, 'steps': 12, 'variables': []})
+                client.simulate({'scenarios': 100, 'steps': 12, 'variables': []})
             assert "quota" in str(exc_info.value).lower()
 
     def test_authentication_error(self, api_key, base_url):
         """Test gestion erreur 401 (API key invalide)."""
-        bsce = BSCE(api_key=api_key, base_url=base_url)
+        client = ASTRIA(api_key=api_key, base_url=base_url)
 
         mock_response = Mock()
         mock_response.status_code = 401
         mock_response.text = "Invalid API key"
         mock_response.ok = False
 
-        with patch.object(bsce.session, 'post', return_value=mock_response):
+        with patch.object(client.session, 'post', return_value=mock_response):
             with pytest.raises(AuthenticationError) as exc_info:
-                bsce.simulate({'scenarios': 100, 'steps': 12, 'variables': []})
+                client.simulate({'scenarios': 100, 'steps': 12, 'variables': []})
             assert "API key" in str(exc_info.value)
 
     def test_validation_error(self, api_key, base_url):
         """Test gestion erreur 400 (validation)."""
-        bsce = BSCE(api_key=api_key, base_url=base_url)
+        client = ASTRIA(api_key=api_key, base_url=base_url)
 
         mock_response = Mock()
         mock_response.status_code = 400
@@ -104,23 +104,23 @@ class TestErrorHandling:
         mock_response.json.return_value = {'detail': 'Invalid formula'}
         mock_response.ok = False
 
-        with patch.object(bsce.session, 'post', return_value=mock_response):
+        with patch.object(client.session, 'post', return_value=mock_response):
             with pytest.raises(ValidationError) as exc_info:
-                bsce.validate({'scenarios': 1, 'steps': 12, 'variables': []})
+                client.validate({'scenarios': 1, 'steps': 12, 'variables': []})
             assert "validation" in str(exc_info.value).lower()
 
     def test_generic_error(self, api_key, base_url):
         """Test gestion erreur générique (500)."""
-        bsce = BSCE(api_key=api_key, base_url=base_url)
+        client = ASTRIA(api_key=api_key, base_url=base_url)
 
         mock_response = Mock()
         mock_response.status_code = 500
         mock_response.text = "Internal server error"
         mock_response.ok = False
 
-        with patch.object(bsce.session, 'post', return_value=mock_response):
-            with pytest.raises(BSCEError) as exc_info:
-                bsce.simulate({'scenarios': 100, 'steps': 12, 'variables': []})
+        with patch.object(client.session, 'post', return_value=mock_response):
+            with pytest.raises(SubspaceError) as exc_info:
+                client.simulate({'scenarios': 100, 'steps': 12, 'variables': []})
             assert "500" in str(exc_info.value)
 
 
@@ -129,7 +129,7 @@ class TestEndpoints:
 
     def test_project_success(self, api_key, base_url, simple_spec):
         """Test endpoint project() avec succès."""
-        bsce = BSCE(api_key=api_key, base_url=base_url)
+        client = ASTRIA(api_key=api_key, base_url=base_url)
 
         mock_response = Mock()
         mock_response.status_code = 200
@@ -142,15 +142,15 @@ class TestEndpoints:
             'performance': {'execution_time_ms': 0.5}
         }
 
-        with patch.object(bsce.session, 'post', return_value=mock_response):
-            result = bsce.project(simple_spec)
+        with patch.object(client.session, 'post', return_value=mock_response):
+            result = client.project(simple_spec)
             assert result['scenarios'] == 1
             assert 'final_values' in result
             assert 'trajectory' in result
 
     def test_simulate_success(self, api_key, base_url, simulation_spec):
         """Test endpoint simulate() avec succès."""
-        bsce = BSCE(api_key=api_key, base_url=base_url)
+        client = ASTRIA(api_key=api_key, base_url=base_url)
 
         mock_response = Mock()
         mock_response.status_code = 200
@@ -169,15 +169,15 @@ class TestEndpoints:
             'performance': {'execution_time_ms': 12.5}
         }
 
-        with patch.object(bsce.session, 'post', return_value=mock_response):
-            result = bsce.simulate(simulation_spec)
+        with patch.object(client.session, 'post', return_value=mock_response):
+            result = client.simulate(simulation_spec)
             assert result['scenarios'] == 100
             assert 'last_mean' in result
             assert 'statistics' in result
 
     def test_project_batch_success(self, api_key, base_url, batch_spec_simple):
         """Test endpoint project_batch() avec succès."""
-        bsce = BSCE(api_key=api_key, base_url=base_url)
+        client = ASTRIA(api_key=api_key, base_url=base_url)
 
         mock_response = Mock()
         mock_response.status_code = 200
@@ -197,8 +197,8 @@ class TestEndpoints:
             'performance': {'execution_time_ms': 25.0}
         }
 
-        with patch.object(bsce.session, 'post', return_value=mock_response):
-            result = bsce.project_batch(
+        with patch.object(client.session, 'post', return_value=mock_response):
+            result = client.project_batch(
                 template=batch_spec_simple['template'],
                 batch_params=batch_spec_simple['batch_params']
             )
@@ -207,7 +207,7 @@ class TestEndpoints:
 
     def test_validate_success(self, api_key, base_url, simple_spec):
         """Test endpoint validate() avec succès."""
-        bsce = BSCE(api_key=api_key, base_url=base_url)
+        client = ASTRIA(api_key=api_key, base_url=base_url)
 
         mock_response = Mock()
         mock_response.status_code = 200
@@ -218,14 +218,14 @@ class TestEndpoints:
             'warnings': []
         }
 
-        with patch.object(bsce.session, 'post', return_value=mock_response):
-            result = bsce.validate(simple_spec)
+        with patch.object(client.session, 'post', return_value=mock_response):
+            result = client.validate(simple_spec)
             assert result['valid'] is True
             assert len(result['errors']) == 0
 
     def test_get_examples_success(self, api_key, base_url):
         """Test endpoint get_examples() avec succès."""
-        bsce = BSCE(api_key=api_key, base_url=base_url)
+        client = ASTRIA(api_key=api_key, base_url=base_url)
 
         mock_response = Mock()
         mock_response.status_code = 200
@@ -237,13 +237,13 @@ class TestEndpoints:
             ]
         }
 
-        bsce.session.get = Mock(return_value=mock_response)
-        result = bsce.get_examples()
+        client.session.get = Mock(return_value=mock_response)
+        result = client.get_examples()
         assert len(result['examples']) == 2
 
     def test_get_usage_success(self, api_key, base_url):
         """Test endpoint get_usage() avec succès."""
-        bsce = BSCE(api_key=api_key, base_url=base_url)
+        client = ASTRIA(api_key=api_key, base_url=base_url)
 
         mock_response = Mock()
         mock_response.status_code = 200
@@ -259,14 +259,14 @@ class TestEndpoints:
             }
         }
 
-        with patch.object(bsce.session, 'get', return_value=mock_response):
-            result = bsce.get_usage()
+        with patch.object(client.session, 'get', return_value=mock_response):
+            result = client.get_usage()
             assert 'usage' in result
             assert result['usage']['simulations_used'] == 45
 
     def test_replay_run_success(self, api_key, base_url):
         """Test endpoint replay_run() avec succès."""
-        bsce = BSCE(api_key=api_key, base_url=base_url)
+        client = ASTRIA(api_key=api_key, base_url=base_url)
 
         mock_response = Mock()
         mock_response.status_code = 200
@@ -281,8 +281,8 @@ class TestEndpoints:
             'run_id': 'run-123'
         }
 
-        with patch.object(bsce.session, 'post', return_value=mock_response):
-            result = bsce.replay_run(run_id='run-123', scenario_id=2)
+        with patch.object(client.session, 'post', return_value=mock_response):
+            result = client.replay_run(run_id='run-123', scenario_id=2)
             assert result['scenarios'] == 1
             assert result['steps'] == 6
             assert 'final_values' in result
@@ -294,7 +294,7 @@ class TestBatchParameters:
 
     def test_project_batch_with_aggregations(self, api_key, base_url):
         """Test project_batch() avec agrégations."""
-        bsce = BSCE(api_key=api_key, base_url=base_url)
+        client = ASTRIA(api_key=api_key, base_url=base_url)
 
         template = {
             'scenarios': 1,
@@ -319,8 +319,8 @@ class TestBatchParameters:
             'aggregations': {'capital_total': 3000.0}
         }
 
-        with patch.object(bsce.session, 'post', return_value=mock_response) as mock_post:
-            result = bsce.project_batch(
+        with patch.object(client.session, 'post', return_value=mock_response) as mock_post:
+            result = client.project_batch(
                 template=template,
                 batch_params=batch_params,
                 aggregations=aggregations
@@ -337,43 +337,43 @@ class TestRateLimitQuotaInfo:
 
     def test_get_rate_limit_info_unlimited(self, api_key, base_url):
         """get_rate_limit_info handles 'unlimited' without crashing."""
-        bsce = BSCE(api_key=api_key, base_url=base_url)
+        client = ASTRIA(api_key=api_key, base_url=base_url)
         mock_response = Mock()
         mock_response.headers = {"X-RateLimit-Limit": "unlimited", "X-RateLimit-Remaining": "999"}
-        bsce.last_response = mock_response
+        client.last_response = mock_response
 
-        result = bsce.get_rate_limit_info()
+        result = client.get_rate_limit_info()
         assert result["limit"] is None
         assert result["remaining"] == 999
 
     def test_get_quota_info_unlimited(self, api_key, base_url):
         """get_quota_info handles 'unlimited' in X-Quota-Limit."""
-        bsce = BSCE(api_key=api_key, base_url=base_url)
+        client = ASTRIA(api_key=api_key, base_url=base_url)
         mock_response = Mock()
         mock_response.headers = {
             "X-Quota-Limit": "unlimited",
             "X-Quota-Remaining": "100",
             "X-Quota-Used": "50",
         }
-        bsce.last_response = mock_response
+        client.last_response = mock_response
 
-        result = bsce.get_quota_info()
+        result = client.get_quota_info()
         assert result["limit"] is None
         assert result["remaining"] == 100
         assert result["used"] == 50
 
     def test_get_quota_info_invalid_values(self, api_key, base_url):
         """get_quota_info handles non-numeric values gracefully."""
-        bsce = BSCE(api_key=api_key, base_url=base_url)
+        client = ASTRIA(api_key=api_key, base_url=base_url)
         mock_response = Mock()
         mock_response.headers = {
             "X-Quota-Limit": "N/A",
             "X-Quota-Remaining": "remaining",
             "X-Quota-Used": "50",
         }
-        bsce.last_response = mock_response
+        client.last_response = mock_response
 
-        result = bsce.get_quota_info()
+        result = client.get_quota_info()
         assert result["limit"] is None
         assert result["remaining"] is None
         assert result["used"] == 50

subspacecomputing-0.1.1/subspacecomputing/__init__.py

@@ -1,24 +0,0 @@
-"""
-Subspace Computing Engine - Python SDK
-
-Python SDK for the Subspace Computing Engine API (by Beausoft).
-"""
-
-from .client import BSCE
-from .errors import (
-    BSCEError,
-    QuotaExceededError,
-    RateLimitError,
-    AuthenticationError,
-    ValidationError,
-)
-
-__version__ = "0.1.1"
-__all__ = [
-    "BSCE",
-    "BSCEError",
-    "QuotaExceededError",
-    "RateLimitError",
-    "AuthenticationError",
-    "ValidationError",
-]