subspacecomputing 0.1.0__tar.gz

subspacecomputing-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Beausoft 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
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

subspacecomputing-0.1.0/MANIFEST.in

@@ -0,0 +1,10 @@
+# Fichiers à inclure dans la distribution PyPI
+
+include README.md
+include LICENSE
+include pyproject.toml
+recursive-include subspacecomputing *.py
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]
+recursive-exclude * .git*
+

subspacecomputing-0.1.0/PKG-INFO

@@ -0,0 +1,258 @@
+Metadata-Version: 2.4
+Name: subspacecomputing
+Version: 0.1.0
+Summary: Python SDK for Subspace Computing Engine API (by Beausoft)
+Home-page: https://www.subspacecomputing.com/developer
+Author: Beausoft
+Author-email: Beausoft <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
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Provides-Extra: pandas
+Requires-Dist: pandas>=2.0.0; extra == "pandas"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+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"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# Subspace Computing Engine - Python SDK
+
+Python SDK for the Subspace Computing Engine API (by Beausoft).
+
+## Installation
+
+```bash
+pip install subspacecomputing
+```
+
+## Usage
+
+### Initialization
+
+```python
+from subspacecomputing import BSCE
+
+# Initialize the client (defaults to production URL)
+bsce = BSCE(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')
+```
+
+### Simple Projection (1 scenario)
+
+```python
+# Create a simple SP Model
+spec = {
+    'scenarios': 1,  # Must be 1 for /project
+    'steps': 12,
+    'variables': [
+        {
+            'name': 'capital',
+            'init': 1000.0,
+            'formula': 'capital[t-1] * 1.05'  # 5% growth per period
+        }
+    ]
+}
+
+# Run the projection
+result = bsce.project(spec)
+
+# Display results
+print(f"Final capital: {result['final_values']['capital']}")
+print(f"Trajectory: {result['trajectory']['capital']}")
+```
+
+### Monte Carlo Simulation (Multiple scenarios)
+
+```python
+# SP Model with random variables
+spec = {
+    'scenarios': 1000,  # 1000 Monte Carlo scenarios
+    'steps': 12,
+    'variables': [
+        {
+            'name': 'taux',
+            'dist': 'uniform',
+            'params': {'min': 0.03, 'max': 0.07},
+            'per': 'scenario'
+        },
+        {
+            'name': 'capital',
+            'init': 1000.0,
+            'formula': 'capital[t-1] * (1 + taux)'
+        }
+    ]
+}
+
+# Run the simulation
+result = bsce.simulate(spec)
+
+# Analyze results
+print(f"Mean final capital: {result['last_mean']['capital']}")
+print(f"Median: {result['statistics']['capital']['median']}")
+print(f"P5: {result['statistics']['capital']['percentiles']['5']}")
+print(f"P95: {result['statistics']['capital']['percentiles']['95']}")
+```
+
+### Batch Mode (Multiple Entities)
+
+```python
+# SP Model template
+template = {
+    'scenarios': 1,
+    'steps': '65 - batch_params.age',  # Dynamic steps
+    'variables': [
+        {
+            'name': 'age_actuel',
+            'init': 'batch_params.age'
+        },
+        {
+            'name': 'salaire',
+            'init': 'batch_params.salary',
+            'formula': 'salaire[t-1] * 1.03'  # 3% annual increase
+        },
+        {
+            'name': 'capital_retraite',
+            'init': 0.0,
+            'formula': 'capital_retraite[t-1] * 1.05 + salaire[t] * 0.10'
+        }
+    ]
+}
+
+# Entity data
+batch_params = [
+    {'entity_id': 'emp_001', 'age': 45, 'salary': 60000},
+    {'entity_id': 'emp_002', 'age': 50, 'salary': 80000},
+    {'entity_id': 'emp_003', 'age': 35, 'salary': 50000}
+]
+
+# Global aggregations (optional)
+aggregations = [
+    {
+        'name': 'capital_total',
+        'formula': 'sum(capital_retraite[t_final])'
+    },
+    {
+        'name': 'moyenne_capital',
+        'formula': 'mean(capital_retraite[t_final])'
+    }
+]
+
+# Run batch
+result = bsce.project_batch(
+    template=template,
+    batch_params=batch_params,
+    aggregations=aggregations
+)
+
+# Analyze results
+for entity in result['entities']:
+    print(f"{entity['_entity_id']}: Capital = {entity['final_values']['capital_retraite']}")
+
+print(f"Total capital: {result['aggregations']['capital_total']}")
+print(f"Average: {result['aggregations']['moyenne_capital']}")
+```
+
+### Validation
+
+```python
+# Validate an SP Model before execution
+validation = bsce.validate(spec)
+
+if validation['is_valid']:
+    print("✅ SP Model is valid")
+    if validation.get('warnings'):
+        print(f"⚠️  Warnings: {validation['warnings']}")
+else:
+    print(f"❌ Errors: {validation['errors']}")
+```
+
+### Utilities
+
+```python
+# Get examples
+examples = bsce.get_examples()
+print(f"Available examples: {len(examples['examples'])}")
+
+# Check usage
+usage = bsce.get_usage()
+print(f"Simulations used: {usage['usage']['simulations_used']}/{usage['usage']['simulations_limit']}")
+
+# Get plans
+plans = bsce.get_plans()
+for plan in plans['plans']:
+    print(f"{plan['name']}: ${plan['price_monthly']}/month")
+```
+
+### Error Handling
+
+```python
+from subspacecomputing import (
+    BSCE,
+    QuotaExceededError,
+    RateLimitError,
+    AuthenticationError,
+    ValidationError,
+    BSCEError
+)
+
+try:
+    result = bsce.simulate(spec)
+except QuotaExceededError as e:
+    print(f"Monthly quota exceeded: {e}")
+except RateLimitError as e:
+    print(f"Rate limit exceeded: {e}")
+    print(f"Retry after: {e.response.headers.get('Retry-After')} seconds")
+except AuthenticationError as e:
+    print(f"Invalid API key: {e}")
+except ValidationError as e:
+    print(f"Validation error: {e.detail}")
+except BSCEError as e:
+    print(f"API error: {e}")
+```
+
+### Rate Limit and Quota Information
+
+After making a request, you can check your rate limit and quota status:
+
+```python
+# Make a request
+result = bsce.project(spec)
+
+# Check rate limit info
+rate_limit = bsce.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()
+if quota:
+    print(f"Quota: {quota['used']}/{quota['limit']} used, {quota['remaining']} remaining")
+```
+
+## Documentation
+
+Check out the full documentation at https://www.subspacecomputing.com/developer
+
+API reference is available at https://api.subspacecomputing.com/docs
+
+For support, reach out to contact@beausoft.ca
+
+## License
+
+MIT License. Check the LICENSE file for details.
+
+## Copyright
+
+© 2025 Beausoft Inc. All Rights Reserved

subspacecomputing-0.1.0/README.md

@@ -0,0 +1,231 @@
+# Subspace Computing Engine - Python SDK
+
+Python SDK for the Subspace Computing Engine API (by Beausoft).
+
+## Installation
+
+```bash
+pip install subspacecomputing
+```
+
+## Usage
+
+### Initialization
+
+```python
+from subspacecomputing import BSCE
+
+# Initialize the client (defaults to production URL)
+bsce = BSCE(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')
+```
+
+### Simple Projection (1 scenario)
+
+```python
+# Create a simple SP Model
+spec = {
+    'scenarios': 1,  # Must be 1 for /project
+    'steps': 12,
+    'variables': [
+        {
+            'name': 'capital',
+            'init': 1000.0,
+            'formula': 'capital[t-1] * 1.05'  # 5% growth per period
+        }
+    ]
+}
+
+# Run the projection
+result = bsce.project(spec)
+
+# Display results
+print(f"Final capital: {result['final_values']['capital']}")
+print(f"Trajectory: {result['trajectory']['capital']}")
+```
+
+### Monte Carlo Simulation (Multiple scenarios)
+
+```python
+# SP Model with random variables
+spec = {
+    'scenarios': 1000,  # 1000 Monte Carlo scenarios
+    'steps': 12,
+    'variables': [
+        {
+            'name': 'taux',
+            'dist': 'uniform',
+            'params': {'min': 0.03, 'max': 0.07},
+            'per': 'scenario'
+        },
+        {
+            'name': 'capital',
+            'init': 1000.0,
+            'formula': 'capital[t-1] * (1 + taux)'
+        }
+    ]
+}
+
+# Run the simulation
+result = bsce.simulate(spec)
+
+# Analyze results
+print(f"Mean final capital: {result['last_mean']['capital']}")
+print(f"Median: {result['statistics']['capital']['median']}")
+print(f"P5: {result['statistics']['capital']['percentiles']['5']}")
+print(f"P95: {result['statistics']['capital']['percentiles']['95']}")
+```
+
+### Batch Mode (Multiple Entities)
+
+```python
+# SP Model template
+template = {
+    'scenarios': 1,
+    'steps': '65 - batch_params.age',  # Dynamic steps
+    'variables': [
+        {
+            'name': 'age_actuel',
+            'init': 'batch_params.age'
+        },
+        {
+            'name': 'salaire',
+            'init': 'batch_params.salary',
+            'formula': 'salaire[t-1] * 1.03'  # 3% annual increase
+        },
+        {
+            'name': 'capital_retraite',
+            'init': 0.0,
+            'formula': 'capital_retraite[t-1] * 1.05 + salaire[t] * 0.10'
+        }
+    ]
+}
+
+# Entity data
+batch_params = [
+    {'entity_id': 'emp_001', 'age': 45, 'salary': 60000},
+    {'entity_id': 'emp_002', 'age': 50, 'salary': 80000},
+    {'entity_id': 'emp_003', 'age': 35, 'salary': 50000}
+]
+
+# Global aggregations (optional)
+aggregations = [
+    {
+        'name': 'capital_total',
+        'formula': 'sum(capital_retraite[t_final])'
+    },
+    {
+        'name': 'moyenne_capital',
+        'formula': 'mean(capital_retraite[t_final])'
+    }
+]
+
+# Run batch
+result = bsce.project_batch(
+    template=template,
+    batch_params=batch_params,
+    aggregations=aggregations
+)
+
+# Analyze results
+for entity in result['entities']:
+    print(f"{entity['_entity_id']}: Capital = {entity['final_values']['capital_retraite']}")
+
+print(f"Total capital: {result['aggregations']['capital_total']}")
+print(f"Average: {result['aggregations']['moyenne_capital']}")
+```
+
+### Validation
+
+```python
+# Validate an SP Model before execution
+validation = bsce.validate(spec)
+
+if validation['is_valid']:
+    print("✅ SP Model is valid")
+    if validation.get('warnings'):
+        print(f"⚠️  Warnings: {validation['warnings']}")
+else:
+    print(f"❌ Errors: {validation['errors']}")
+```
+
+### Utilities
+
+```python
+# Get examples
+examples = bsce.get_examples()
+print(f"Available examples: {len(examples['examples'])}")
+
+# Check usage
+usage = bsce.get_usage()
+print(f"Simulations used: {usage['usage']['simulations_used']}/{usage['usage']['simulations_limit']}")
+
+# Get plans
+plans = bsce.get_plans()
+for plan in plans['plans']:
+    print(f"{plan['name']}: ${plan['price_monthly']}/month")
+```
+
+### Error Handling
+
+```python
+from subspacecomputing import (
+    BSCE,
+    QuotaExceededError,
+    RateLimitError,
+    AuthenticationError,
+    ValidationError,
+    BSCEError
+)
+
+try:
+    result = bsce.simulate(spec)
+except QuotaExceededError as e:
+    print(f"Monthly quota exceeded: {e}")
+except RateLimitError as e:
+    print(f"Rate limit exceeded: {e}")
+    print(f"Retry after: {e.response.headers.get('Retry-After')} seconds")
+except AuthenticationError as e:
+    print(f"Invalid API key: {e}")
+except ValidationError as e:
+    print(f"Validation error: {e.detail}")
+except BSCEError as e:
+    print(f"API error: {e}")
+```
+
+### Rate Limit and Quota Information
+
+After making a request, you can check your rate limit and quota status:
+
+```python
+# Make a request
+result = bsce.project(spec)
+
+# Check rate limit info
+rate_limit = bsce.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()
+if quota:
+    print(f"Quota: {quota['used']}/{quota['limit']} used, {quota['remaining']} remaining")
+```
+
+## Documentation
+
+Check out the full documentation at https://www.subspacecomputing.com/developer
+
+API reference is available at https://api.subspacecomputing.com/docs
+
+For support, reach out to contact@beausoft.ca
+
+## License
+
+MIT License. Check the LICENSE file for details.
+
+## Copyright
+
+© 2025 Beausoft Inc. All Rights Reserved

subspacecomputing-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+# pyproject.toml pour le SDK Python (configuration moderne)
+
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "subspacecomputing"
+version = "0.1.0"
+description = "Python SDK for Subspace Computing Engine API (by Beausoft)"
+authors = [{name = "Beausoft", email = "contact@beausoft.ca"}]
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "requests>=2.31.0",
+]
+
+[project.optional-dependencies]
+pandas = ["pandas>=2.0.0"]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "black>=23.0.0",
+    "ruff>=0.1.0",
+    "fastapi>=0.100.0",  # Pour tests d'intégration
+]
+
+[project.urls]
+Documentation = "https://www.subspacecomputing.com/developer"
+Homepage = "https://www.subspacecomputing.com/developer"
+Support = "https://www.subspacecomputing.com/developer"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["subspacecomputing*"]
+
+[tool.black]
+line-length = 100
+target-version = ['py310']
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+

subspacecomputing-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

subspacecomputing-0.1.0/setup.py

@@ -0,0 +1,45 @@
+"""
+Setup.py pour le SDK Python Beausoft Subspace Computing Engine.
+"""
+
+from setuptools import setup, find_packages
+
+# Lire le README pour la description longue
+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)"
+
+setup(
+    name="subspacecomputing",
+    version="0.1.0",
+    description="Python SDK for Subspace Computing Engine API (by Beausoft)",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    author="Beausoft",
+    author_email="contact@beausoft.ca",
+    url="https://www.subspacecomputing.com/developer",
+    packages=find_packages(),
+    install_requires=[
+        "requests>=2.31.0",
+    ],
+    python_requires=">=3.10",
+    classifiers=[
+        "Development Status :: 3 - Alpha",
+        "Intended Audience :: Developers",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+    ],
+    keywords="actuarial, finance, simulation, monte-carlo, projection, subspace",
+    project_urls={
+        "Documentation": "https://www.subspacecomputing.com/developer",
+        "Homepage": "https://www.subspacecomputing.com/developer",
+        "Support": "https://www.subspacecomputing.com/developer",
+    },
+)
+

subspacecomputing-0.1.0/subspacecomputing/__init__.py

@@ -0,0 +1,24 @@
+"""
+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.0"
+__all__ = [
+    "BSCE",
+    "BSCEError",
+    "QuotaExceededError",
+    "RateLimitError",
+    "AuthenticationError",
+    "ValidationError",
+]