subspacecomputing 0.1.2__tar.gz → 0.1.5__tar.gz

{subspacecomputing-0.1.2 → subspacecomputing-0.1.5}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Beausoft Inc.
+Copyright (c) 2025 Subspace Computing Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{subspacecomputing-0.1.2 → subspacecomputing-0.1.5}/MANIFEST.in

@@ -4,6 +4,12 @@ include README.md
 include LICENSE
 include pyproject.toml
 recursive-include subspacecomputing *.py
+prune tests
+prune doc
+prune examples
+recursive-exclude tests *
+recursive-exclude doc *
+recursive-exclude examples *
 recursive-exclude * __pycache__
 recursive-exclude * *.py[co]
 recursive-exclude * .git*

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

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: subspacecomputing
-Version: 0.1.2
-Summary: Python SDK for Subspace Computing Engine API (by Beausoft)
+Version: 0.1.5
+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 Inc.
+Author-email: "Subspace Computing Inc." <contact@subspacecomputing.com>
 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,14 +20,15 @@ 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
 Dynamic: requires-python
 
-# Subspace Computing Engine - Python SDK
+# ASTRIA — Python SDK
 
-Python SDK for the Subspace Computing Engine API (by Beausoft).
+Python SDK for ASTRIA, the Subspace Computing Engine.
 
 ## Installation
 
@@ -40,13 +41,13 @@ 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`)
@@ -56,8 +57,8 @@ Keys can carry a `default_team_id` from the portal. If the user is in **several*
 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
+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)
@@ -77,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']}")
@@ -107,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']}")
@@ -161,7 +162,7 @@ aggregations = [
 ]
 
 # Run batch
-result = bsce.project_batch(
+result = client.project_batch(
     template=template,
     batch_params=batch_params,
     aggregations=aggregations
@@ -175,11 +176,52 @@ print(f"Total capital: {result['aggregations']['capital_total']}")
 print(f"Average: {result['aggregations']['moyenne_capital']}")
 ```
 
+### Runs: read, artifact, rerun, replay
+
+Four distinct operations on persisted runs:
+
+| Method | What it does |
+|--------|----------------|
+| `get_run(run_id)` | Read metadata, stored SP Model snapshot, and `result_summary` |
+| `get_run_artifact(artifact_id)` | Read heavy results already computed (`final_values` / URL) |
+| `rerun_run(run_id, spec_patch=None)` | Re-execute the run's snapshot in Astria; creates a **new** run |
+| `replay_run(run_id, scenario_id)` | Reproduce **one** Monte Carlo scenario when seeds were stored |
+
+```python
+# Cross-language analysis: app computed → Python reads original results
+run = client.get_run(run_id)
+print(run["result_summary"])
+if run.get("artefact_id"):
+    artifact = client.get_run_artifact(run["artefact_id"])
+    print(artifact.get("final_values"))
+
+# Re-execute the exact snapshot (validation) — new run, same projection
+baseline = client.rerun_run(run_id)
+print(baseline["run_id"], baseline["source_spec_hash"], baseline["spec_changed"])
+
+# What-if: fork the snapshot with a JSON Merge Patch (source run unchanged)
+what_if = client.rerun_run(
+    run_id,
+    spec_patch={"meta": {"seed": 42}},
+)
+print(what_if["executed_spec_hash"], what_if["final_values"])
+
+# Exact MC scenario reproduction (requires meta.store_seeds_for_replay at creation)
+replay = client.replay_run(run_id, scenario_id=0)
+```
+
+**Notes**
+
+- `rerun_run` does **not** load the projection's current `dsl_template`; it uses the run's stored `spec`.
+- Requires `persist_mode=full` (headless minimal/metadata keys cannot create a new run).
+- Exact stochastic reproduction of one scenario uses `replay_run` + stored seeds; a plain `rerun_run` of a Monte Carlo may draw new samples unless `meta.seed` was in the snapshot.
+- Live `table_refs` may resolve to newer data than at original execution time.
+
 ### Validation
 
 ```python
 # Validate an SP Model before execution
-validation = bsce.validate(spec)
+validation = client.validate(spec)
 
 if validation['is_valid']:
     print("✅ SP Model is valid")
@@ -193,15 +235,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")
 ```
@@ -210,16 +252,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:
@@ -229,7 +271,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}")
 ```
 
@@ -239,15 +281,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")
 ```
@@ -258,7 +300,7 @@ Check out the full documentation at https://www.subspacecomputing.com/developer
 
 API reference is available at https://www.subspacecomputing.com/docs
 
-For support, reach out to contact@beausoft.ca
+For support, reach out to contact@subspacecomputing.com
 
 ## License
 
@@ -266,4 +308,4 @@ MIT License. Check the LICENSE file for details.
 
 ## Copyright
 
-© 2025 Beausoft Inc. All Rights Reserved
+© 2026 Subspace Computing Inc. All Rights Reserved

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

@@ -1,6 +1,6 @@
-# Subspace Computing Engine - Python SDK
+# ASTRIA — Python SDK
 
-Python SDK for the Subspace Computing Engine API (by Beausoft).
+Python SDK for ASTRIA, the Subspace Computing Engine.
 
 ## Installation
 
@@ -13,13 +13,13 @@ 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`)
@@ -29,8 +29,8 @@ Keys can carry a `default_team_id` from the portal. If the user is in **several*
 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
+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)
@@ -50,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']}")
@@ -80,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']}")
@@ -134,7 +134,7 @@ aggregations = [
 ]
 
 # Run batch
-result = bsce.project_batch(
+result = client.project_batch(
     template=template,
     batch_params=batch_params,
     aggregations=aggregations
@@ -148,11 +148,52 @@ print(f"Total capital: {result['aggregations']['capital_total']}")
 print(f"Average: {result['aggregations']['moyenne_capital']}")
 ```
 
+### Runs: read, artifact, rerun, replay
+
+Four distinct operations on persisted runs:
+
+| Method | What it does |
+|--------|----------------|
+| `get_run(run_id)` | Read metadata, stored SP Model snapshot, and `result_summary` |
+| `get_run_artifact(artifact_id)` | Read heavy results already computed (`final_values` / URL) |
+| `rerun_run(run_id, spec_patch=None)` | Re-execute the run's snapshot in Astria; creates a **new** run |
+| `replay_run(run_id, scenario_id)` | Reproduce **one** Monte Carlo scenario when seeds were stored |
+
+```python
+# Cross-language analysis: app computed → Python reads original results
+run = client.get_run(run_id)
+print(run["result_summary"])
+if run.get("artefact_id"):
+    artifact = client.get_run_artifact(run["artefact_id"])
+    print(artifact.get("final_values"))
+
+# Re-execute the exact snapshot (validation) — new run, same projection
+baseline = client.rerun_run(run_id)
+print(baseline["run_id"], baseline["source_spec_hash"], baseline["spec_changed"])
+
+# What-if: fork the snapshot with a JSON Merge Patch (source run unchanged)
+what_if = client.rerun_run(
+    run_id,
+    spec_patch={"meta": {"seed": 42}},
+)
+print(what_if["executed_spec_hash"], what_if["final_values"])
+
+# Exact MC scenario reproduction (requires meta.store_seeds_for_replay at creation)
+replay = client.replay_run(run_id, scenario_id=0)
+```
+
+**Notes**
+
+- `rerun_run` does **not** load the projection's current `dsl_template`; it uses the run's stored `spec`.
+- Requires `persist_mode=full` (headless minimal/metadata keys cannot create a new run).
+- Exact stochastic reproduction of one scenario uses `replay_run` + stored seeds; a plain `rerun_run` of a Monte Carlo may draw new samples unless `meta.seed` was in the snapshot.
+- Live `table_refs` may resolve to newer data than at original execution time.
+
 ### Validation
 
 ```python
 # Validate an SP Model before execution
-validation = bsce.validate(spec)
+validation = client.validate(spec)
 
 if validation['is_valid']:
     print("✅ SP Model is valid")
@@ -166,15 +207,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")
 ```
@@ -183,16 +224,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:
@@ -202,7 +243,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}")
 ```
 
@@ -212,15 +253,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")
 ```
@@ -231,7 +272,7 @@ Check out the full documentation at https://www.subspacecomputing.com/developer
 
 API reference is available at https://www.subspacecomputing.com/docs
 
-For support, reach out to contact@beausoft.ca
+For support, reach out to contact@subspacecomputing.com
 
 ## License
 
@@ -239,4 +280,4 @@ MIT License. Check the LICENSE file for details.
 
 ## Copyright
 
-© 2025 Beausoft Inc. All Rights Reserved
+© 2026 Subspace Computing Inc. All Rights Reserved

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

@@ -6,9 +6,9 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "subspacecomputing"
-version = "0.1.2"
-description = "Python SDK for Subspace Computing Engine API (by Beausoft)"
-authors = [{name = "Beausoft", email = "contact@beausoft.ca"}]
+version = "0.1.5"
+description = "Python SDK for ASTRIA — Subspace Computing Engine"
+authors = [{name = "Subspace Computing Inc.", email = "contact@subspacecomputing.com"}]
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
@@ -22,7 +22,8 @@ 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.

{subspacecomputing-0.1.2 → subspacecomputing-0.1.5}/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
@@ -9,16 +9,16 @@ try:
     with open("README.md", "r", encoding="utf-8") as fh:
         long_description = fh.read()
 except FileNotFoundError:
-    long_description = "Python SDK for Subspace Computing Engine API (by Beausoft)"
+    long_description = "Python SDK for ASTRIA — Subspace Computing Engine API"
 
 setup(
     name="subspacecomputing",
-    version="0.1.2",
-    description="Python SDK for Subspace Computing Engine API (by Beausoft)",
+    version="0.1.5",
+    description="Python SDK for ASTRIA — Subspace Computing Engine",
     long_description=long_description,
     long_description_content_type="text/markdown",
-    author="Beausoft",
-    author_email="contact@beausoft.ca",
+    author="Subspace Computing Inc.",
+    author_email="contact@subspacecomputing.com",
     url="https://www.subspacecomputing.com/developer",
     packages=find_packages(),
     install_requires=[

subspacecomputing-0.1.5/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.5"
+__all__ = [
+    "ASTRIA",
+    "SubspaceError",
+    "QuotaExceededError",
+    "RateLimitError",
+    "AuthenticationError",
+    "ValidationError",
+    # Backward compatibility
+    "Subspace",
+    "BSCE",
+    "BSCEError",
+]