xenfra-sdk 0.2.1__py3-none-any.whl → 0.2.3__py3-none-any.whl

xenfra_sdk/templates/docker-compose-multi.yml.j2

@@ -0,0 +1,29 @@
+# docker-compose.yml template for multi-service deployments
+# Generated by Xenfra for microservices
+
+services:
+{% for service in services %}
+  {{ service.name }}:
+    build: {{ service.path }}
+    ports:
+      - "{{ service.port }}:{{ service.port }}"
+{% if service.command %}
+    command: {{ service.command }}
+{% elif service.entrypoint %}
+{% if service.framework == 'fastapi' %}
+    command: uvicorn {{ service.entrypoint }} --host 0.0.0.0 --port {{ service.port }}
+{% elif service.framework == 'flask' %}
+    command: gunicorn {{ service.entrypoint }} -b 0.0.0.0:{{ service.port }}
+{% elif service.framework == 'django' %}
+    command: gunicorn {{ service.entrypoint }} --bind 0.0.0.0:{{ service.port }}
+{% endif %}
+{% endif %}
+{% if service.env %}
+    environment:
+{% for key, value in service.env.items() %}
+      - {{ key }}={{ value }}
+{% endfor %}
+{% endif %}
+    restart: unless-stopped
+
+{% endfor %}

xenfra_sdk/templates/docker-compose.yml.j2

@@ -1,27 +1,30 @@
-# docker-compose.yml template
-version: '3.8'
-
-services:
-  app:
-    build: .
-    ports:
-      - "{{ port | default(8000) }}:{{ port | default(8000) }}"
-    command: {{ command | default('uvicorn main:app --host 0.0.0.0 --port 8000') }}
-{% if database == 'postgres' or database == 'postgresql' %}
-    depends_on:
-      - db
-    environment:
-      - DATABASE_URL=postgresql://{{ db_user | default('user') }}:{{ db_password | default('password') }}@db:5432/{{ db_name | default('appdb') }}
-
-  db:
-    image: postgres:15-alpine
-    volumes:
-      - postgres_data:/var/lib/postgresql/data/
-    environment:
-      - POSTGRES_USER={{ db_user | default('user') }}
-      - POSTGRES_PASSWORD={{ db_password | default('password') }}
-      - POSTGRES_DB={{ db_name | default('appdb') }}
-
-volumes:
-  postgres_data:
-{% endif %}
+# docker-compose.yml template
+
+services:
+  app:
+    build: .
+    ports:
+      - "{{ port | default(8000) }}:{{ port | default(8000) }}"
+{% if command and command != 'None' %}
+    command: {{ command }}
+{% else %}
+    command: ["uvicorn", "{{ entrypoint | default('src.main:app') }}", "--host", "0.0.0.0", "--port", "{{ port | default(8000) }}"]
+{% endif %}
+{% if database == 'postgres' or database == 'postgresql' %}
+    depends_on:
+      - db
+    environment:
+      - DATABASE_URL=postgresql://{{ db_user | default('user') }}:{{ db_password | default('password') }}@db:5432/{{ db_name | default('appdb') }}
+
+  db:
+    image: postgres:15-alpine
+    volumes:
+      - postgres_data:/var/lib/postgresql/data/
+    environment:
+      - POSTGRES_USER={{ db_user | default('user') }}
+      - POSTGRES_PASSWORD={{ db_password | default('password') }}
+      - POSTGRES_DB={{ db_name | default('appdb') }}
+
+volumes:
+  postgres_data:
+{% endif %}

xenfra_sdk-0.2.3.dist-info/METADATA

@@ -0,0 +1,116 @@
+Metadata-Version: 2.3
+Name: xenfra-sdk
+Version: 0.2.3
+Summary: Xenfra SDK: Core engine and utilities for the Xenfra platform.
+Author: xenfra-cloud
+Author-email: xenfra-cloud <xenfracloud@gmail.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: System :: Systems Administration
+Requires-Dist: fabric>=3.2.2
+Requires-Dist: python-digitalocean>=1.17.0
+Requires-Dist: python-dotenv>=1.2.1
+Requires-Dist: rich>=14.2.0
+Requires-Dist: sqlmodel>=0.0.16
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: jinja2>=3.1.3
+Requires-Dist: python-jose[cryptography]>=3.3.0
+Requires-Dist: passlib>=1.7.4
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: pytest>=8.0.0 ; extra == 'dev'
+Requires-Dist: pytest-mock>=3.12.0 ; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0 ; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0 ; extra == 'dev'
+Requires-Python: >=3.13
+Project-URL: Homepage, https://github.com/xenfra-cloud/xenfra-sdk
+Project-URL: Issues, https://github.com/xenfra-cloud/xenfra-sdk/issues
+Provides-Extra: dev
+Description-Content-Type: text/markdown
+
+# Xenfra SDK (The Engine) 📦
+
+[![PyPI](https://img.shields.io/pypi/v/xenfra-sdk)](https://pypi.org/project/xenfra-sdk/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python](https://img.shields.io/pypi/pyversions/xenfra-sdk.svg)](https://pypi.org/project/xenfra-sdk/)
+
+The core infrastructure automation engine behind **Xenfra** (The Sovereign Cloud OS). This SDK provides the primitives for deploying, managing, and diagnosing applications on DigitalOcean with "Zen Mode" auto-healing.
+
+## 🚀 Features
+
+- **InfraEngine**: A robust 9-phase deployment pipeline (Setup -> Asset Gen -> Droplet -> Code -> Build -> Health).
+- **Dockerizer**: Deterministic Dockerfile and Compose generation using Jinja2 templates.
+- **Zen Mode**: Utilities to automatically heal common failures (e.g., locked dpkg, exhausted ports).
+- **Privacy-First**: Built-in PII scrubbing for logs before they touch any AI services.
+- **Security**: Fernet encryption for tokens and RS256 JWT validation helpers.
+
+## 📦 Installation
+
+```bash
+pip install xenfra-sdk
+# or with uv
+uv add xenfra-sdk
+```
+
+## 🛠️ Usage
+
+### 1. Initialize the Engine
+
+```python
+from xenfra_sdk import XenfraClient, InfraEngine
+
+# Authenticate (Token usually comes from the CLI)
+client = XenfraClient(token="xenfra_...")
+engine = InfraEngine(client)
+```
+
+### 2. Deploy a Project
+
+```python
+project_path = "/path/to/my-fastapi-app"
+
+# The engine handles detection (Python/Node), dockerization, and provisioning
+deployment = await engine.deploy(
+    path=project_path,
+    project_id="proj_123",
+    env_vars={"DATABASE_URL": "..."}
+)
+
+print(f"🚀 Deployed successfully to: http://{deployment.ip_address}")
+```
+
+### 3. Diagnose a Failure
+
+```python
+from xenfra_sdk.intelligence import diagnose_failure
+
+logs = client.deployments.get_logs(deployment.id)
+analysis = await diagnose_failure(logs)
+
+print(f"Diagnosis: {analysis.root_cause}")
+print(f"Suggested Fix: {analysis.suggestion}")
+```
+
+## 🔗 The Xenfra Ecosystem
+
+This SDK is the "Body" of the Xenfra Open Core architecture:
+
+- **[xenfra-cli](https://github.com/xenfracloud/xenfra-cli)**: The Terminal Interface (Uses this SDK).
+- **[xenfra-mcp](https://github.com/xenfracloud/xenfra-mcp)**: The AI Agent Interface (Uses this SDK).
+- **xenfra-platform**: The Private SaaS Backend (Uses this SDK).
+
+## 🤝 Contributing
+
+We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+1.  Clone: `git clone https://github.com/xenfracloud/xenfra-sdk`
+2.  Install: `uv sync`
+3.  Test: `pytest`
+
+## 📄 License
+
+MIT © [Xenfra Cloud](https://xenfra.tech)

xenfra_sdk-0.2.3.dist-info/RECORD

@@ -0,0 +1,38 @@
+xenfra_sdk/__init__.py,sha256=ZPdW5mFBa9UbmJXRjyBeodbIHWCQsOvmJ2MmUn0aApY,1420
+xenfra_sdk/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xenfra_sdk/cli/main.py,sha256=541nlIUYFFeu4h1sCXivaHMC7SqpskazI0YocM8ylh4,7958
+xenfra_sdk/client.py,sha256=88M-ram8wDVfVEPpa3q1z4hXToBg4kSOgsIBOLXxsBo,3597
+xenfra_sdk/client_with_hooks.py,sha256=iN-xTGdeSPizktM6UG-aZEsuwQc5OgosNYUf1_Tq4Dc,10046
+xenfra_sdk/config.py,sha256=gaT4k5iJgW9guNVmlnYkCFGDSU1_er4LRZA2CgfKmJ0,588
+xenfra_sdk/db/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xenfra_sdk/db/models.py,sha256=ysAvkbVuLdOjhD2iA-oJ1xggPrNBsUNLY3Cfm-FFJ_Q,682
+xenfra_sdk/db/session.py,sha256=0MA0404QU9eUabDgTqi-wNIUP0DpIKKG-OvB4Jzf7rc,885
+xenfra_sdk/dependencies.py,sha256=WHGfIrEYkss5yuBd_uOFrB6lPBWM2X0mEuG26ILAjXI,1211
+xenfra_sdk/detection.py,sha256=t8FA_AaNphvv-G0dGL6hLYqOdC9an6-QnVrtFoiTd7M,13993
+xenfra_sdk/dockerizer.py,sha256=KuVGcS5RacR91fGo_6pPlQ4wvJYqnenz0C6x9JoLPWU,7291
+xenfra_sdk/engine.py,sha256=1APOo3DWQBeZscYs9Ay6BdYrp0VzialZiz06L3X4gng,35710
+xenfra_sdk/exceptions.py,sha256=aMVtDVlzG7-FT2G_b-pJSuuey22B4YvC-b-L37GaImM,477
+xenfra_sdk/manifest.py,sha256=49wfCr0VK9AJBCF8HGOJ_K0ru8iUbjRDczH3MPzPJBc,6613
+xenfra_sdk/mcp_client.py,sha256=NZtQz_qK_8i504rVPXlE1vPdzt75hg8Lkp4d8BA8dk0,5777
+xenfra_sdk/models.py,sha256=qSUvtsBMaiTKCHxOcdgY9ghJc-rwwZEOHMp1qiTuvMI,7198
+xenfra_sdk/orchestrator.py,sha256=vRRBC9dl8A8HwQ7gHGwzC31MeZ7aXvyqhfjK4t4Yvno,27211
+xenfra_sdk/patterns.json,sha256=xHxbc0ogHDwysMczi30_hW1Ylfdsf-nsQdAom7RZ4KI,446
+xenfra_sdk/privacy.py,sha256=Bscv7bopCQTeJhvU8Z2jxdBfc5tCZDY5kuODonTcgSk,5509
+xenfra_sdk/recipes.py,sha256=-LLMz1ye6sqHb9zg3YGhOXzYO6-S9I13xTEKhca7C5U,947
+xenfra_sdk/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xenfra_sdk/resources/base.py,sha256=5n-HTKAnIX2lTgXwio0xtwoaBn-nksjdm8qRTpe3iDk,81
+xenfra_sdk/resources/deployments.py,sha256=kqSxxAwJx_3TveNH-075RQH9IbQ9w-qJ9uM29CETuJU,11941
+xenfra_sdk/resources/files.py,sha256=opdxZt6GWMU-qu5ltfWfv2hm8TscdaK-r9o4k743Irs,3087
+xenfra_sdk/resources/intelligence.py,sha256=_jCIqny-gTV5cBjC6RF5CAs86xzXUKuoqNSAtkNnIYY,3560
+xenfra_sdk/resources/projects.py,sha256=EsCVXmqkhWl_Guz_8WDQDi3kAm1Wyg1rjXcyAigPD6E,3712
+xenfra_sdk/security.py,sha256=6vMZpbglhkRGBVVj4RCTu45-MCnQ15wt94-996zmaT8,1199
+xenfra_sdk/security_scanner.py,sha256=US9QdMjHdTUkqObrGPHvDPxMP0QXCxmwK5e28d8KT2E,12957
+xenfra_sdk/templates/Caddyfile.j2,sha256=PVXffF6dQN06xZ5KyiaSBTK31742v3GN4ISSwiJAXC4,320
+xenfra_sdk/templates/Dockerfile.j2,sha256=qEMnFo2kfYNWaeTpyjh6qeKciHv0dBBNxSVRmnmAIQQ,1176
+xenfra_sdk/templates/cloud-init.sh.j2,sha256=xOwf-VERYXnL8vNMU13SnrmRX0H-hEh3l1A4zSmLG0c,2999
+xenfra_sdk/templates/docker-compose-multi.yml.j2,sha256=PWSPdWsGb-sWJ-XCutMdHiz-uhChIwEN6QMaZ0_Spxs,911
+xenfra_sdk/templates/docker-compose.yml.j2,sha256=TQ__p3-TYAUbU0RNeZCxTjJ9gt81-Rry1B1QnuPzBzc,935
+xenfra_sdk/utils.py,sha256=d8eCjjV32QwqoJa759CEcETnnsjG5qVKDLQ84yYtlus,3898
+xenfra_sdk-0.2.3.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
+xenfra_sdk-0.2.3.dist-info/METADATA,sha256=qL2_Q18avUxvCt4x3vJKUyDrrKlzJk7tBaSSz8dLVWk,3982
+xenfra_sdk-0.2.3.dist-info/RECORD,,

{xenfra_sdk-0.2.1.dist-info → xenfra_sdk-0.2.3.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.9.24
+Generator: uv 0.9.26
 Root-Is-Purelib: true
-Tag: py3-none-any
+Tag: py3-none-any

xenfra_sdk-0.2.1.dist-info/METADATA

@@ -1,118 +0,0 @@
-Metadata-Version: 2.3
-Name: xenfra-sdk
-Version: 0.2.1
-Summary: Xenfra SDK: Core engine and utilities for the Xenfra platform.
-Author: xenfra-cloud
-Author-email: xenfra-cloud <xenfracloud@gmail.com>
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: Topic :: Software Development :: Build Tools
-Classifier: Topic :: System :: Systems Administration
-Requires-Dist: fabric>=3.2.2
-Requires-Dist: python-digitalocean>=1.17.0
-Requires-Dist: python-dotenv>=1.2.1
-Requires-Dist: rich>=14.2.0
-Requires-Dist: sqlmodel>=0.0.16
-Requires-Dist: pyyaml>=6.0.1
-Requires-Dist: httpx>=0.27.0
-Requires-Dist: jinja2>=3.1.3
-Requires-Dist: python-jose[cryptography]>=3.3.0
-Requires-Dist: passlib>=1.7.4
-Requires-Dist: cryptography>=41.0.0
-Requires-Python: >=3.13
-Description-Content-Type: text/markdown
-
-# Xenfra Python SDK
-
-The official, open-source Python SDK for interacting with the Xenfra API.
-
-This SDK provides a simple and Pythonic interface for developers and AI Agents to programmatically manage infrastructure, deployments, and other platform resources.
-
-## Installation
-
-```bash
-pip install xenfra-sdk
-```
-
-## Basic Usage
-
-Initialize the client with your API token (or ensure the `XENFRA_TOKEN` environment variable is set).
-
-```python
-import os
-from xenfra_sdk import XenfraClient
-from xenfra_sdk.exceptions import XenfraAPIError
-
-client = XenfraClient(token=os.getenv("XENFRA_TOKEN"))
-
-try:
-    projects = client.projects.list()
-    for p in projects:
-        print(f"Found project: {p.name} (Status: {p.status})")
-except XenfraAPIError as e:
-    print(f"API Error: {e.detail}")
-```
-
-## Usage for Agentic Workflows
-
-The Xenfra SDK is designed to be used as a "tool" by AI Agents (e.g., OpenAI Assistants). The Pydantic models are compatible with function-calling schemas, allowing an agent to easily call these methods.
-
-Here is a conceptual example of how an agent might use the SDK to fulfill a user's request.
-
-```python
-# This is a conceptual representation of an agent's internal logic.
-# The agent would be configured with functions that call these SDK methods.
-
-def list_all_projects():
-    """Lists all available projects in the Xenfra account."""
-    return client.projects.list()
-
-def create_new_deployment(project_name: str, git_repo: str, branch: str = "main"):
-    """
-    Creates a new deployment for a project.
-    
-    Args:
-        project_name: The name for the new deployment.
-        git_repo: The URL of the git repository to deploy.
-        branch: The branch to deploy (defaults to 'main').
-    """
-    return client.deployments.create(
-        project_name=project_name,
-        git_repo=git_repo,
-        branch=branch,
-        framework="fastapi" # Framework detection would be part of a more complex agent
-    )
-
-# --- Agent Execution Flow ---
-
-# User prompt: "Deploy my new app from github.com/user/my-app"
-
-# 1. Agent decides which tool to use: `create_new_deployment`
-# 2. Agent extracts parameters:
-#    - project_name = "my-app" (inferred)
-#    - git_repo = "https://github.com/user/my-app"
-# 3. Agent calls the tool:
-#    create_new_deployment(
-#        project_name="my-app",
-#        git_repo="https://github.com/user/my-app"
-#    )
-```
-
-## Error Handling
-
-The SDK uses custom exceptions for clear error handling. All API-related errors will raise a `XenfraAPIError`, which contains the `status_code` and a `detail` message from the API response.
-
-```python
-from xenfra_sdk.exceptions import XenfraAPIError, AuthenticationError
-
-try:
-    # Make an API call
-    ...
-except AuthenticationError as e:
-    print("Authentication failed. Please check your token.")
-except XenfraAPIError as e:
-    print(f"An API error occurred with status {e.status_code}: {e.detail}")
-```

xenfra_sdk-0.2.1.dist-info/RECORD

@@ -1,31 +0,0 @@
-xenfra_sdk/__init__.py,sha256=ILBGPKNWJjEwvLWxYD2ulOYLD43nf3-Xu71FwcraH5c,488
-xenfra_sdk/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xenfra_sdk/cli/main.py,sha256=9uQja07LxLfBCHeCRlDCStK1X248h9kMRPep6iFShyk,8184
-xenfra_sdk/client.py,sha256=ufxjjVY3UG1roR0q8LYBmCHOJ13uRQuycqTqYuHgqTs,3514
-xenfra_sdk/client_with_hooks.py,sha256=iN-xTGdeSPizktM6UG-aZEsuwQc5OgosNYUf1_Tq4Dc,10046
-xenfra_sdk/config.py,sha256=omb3SQMAk5NXOuCrLZe4bp_bX7F0SXA1ERJ5PdDaxMU,614
-xenfra_sdk/db/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xenfra_sdk/db/models.py,sha256=oNT9UhYzr_SgzDJdPu5fF6IiiztWjm2tHZzpIAYVJ4Y,706
-xenfra_sdk/db/session.py,sha256=ul6tFBBDKU8UErJsZ-g7b8cryLr9-yA6jGY3d8fD15Q,853
-xenfra_sdk/dependencies.py,sha256=k7tiy_5dayr_iQx_i2klGeNjGWhxfivGVC38SpvQvzE,1250
-xenfra_sdk/dockerizer.py,sha256=Fml-1QpUtQqslHYG12igxDvGEpYjx1E9qp0oWbBsofk,3962
-xenfra_sdk/engine.py,sha256=ACle-suwDNu-KY2Sv3W86aXP5-HFHdJ6vnpK4w5TSk8,20820
-xenfra_sdk/exceptions.py,sha256=FaKctVJNMFIw09G8Lm2yd_DHhSngGcyh2j_BTgXMM60,496
-xenfra_sdk/mcp_client.py,sha256=GPsVJtWT87G7k_GxePATLfCqFkYFFNIbpW5AsZi4Bhk,5931
-xenfra_sdk/models.py,sha256=-QkHFAnimEQA1hZ70YcordlbKWbO9mgzDUdO03qg5BI,7278
-xenfra_sdk/patterns.json,sha256=RBuQdU59UEXF5pxUvcWq_ZegsK0iUfh4wusWaY77qxo,459
-xenfra_sdk/privacy.py,sha256=ksGf5L9PVtRP-xZS3T-Gj7MKfexTqIMgbFLoYkIESOE,5662
-xenfra_sdk/recipes.py,sha256=jSFlPLIze3rKpBaeFKNVkWESQzBXWGkoSwSH1jwx0Vs,973
-xenfra_sdk/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xenfra_sdk/resources/base.py,sha256=C6BuZfhR-oU5ecHSfkGG6ZLU6MHGXUyCWoy1F-yTIf8,84
-xenfra_sdk/resources/deployments.py,sha256=0IS54LyoLLCB6h25a2jgM2jk3tvYmb2Auf49p11C2nU,9751
-xenfra_sdk/resources/intelligence.py,sha256=Y11K6_iXfm2QKTbH1vUmt45MifLoVtZtlHEkqbzmTzs,3418
-xenfra_sdk/resources/projects.py,sha256=EsCVXmqkhWl_Guz_8WDQDi3kAm1Wyg1rjXcyAigPD6E,3712
-xenfra_sdk/security.py,sha256=Px887RRb1BUDXaPUrxmQITJ1mHyOyupCJqEDZ78F7Tk,1240
-xenfra_sdk/templates/Dockerfile.j2,sha256=GXc0JiaF-HsxTQS15Gs2fcvsIhA1EHnwapdFVitUWS0,689
-xenfra_sdk/templates/cloud-init.sh.j2,sha256=fxQP2GVAAVVvDAqlOVH3eNmeKSTFQ2soErQQRD5RX3U,3072
-xenfra_sdk/templates/docker-compose.yml.j2,sha256=93AvztUyUMgYbdycB9EHow1qCkeNmQ2NR2G9FD5zh5A,840
-xenfra_sdk/utils.py,sha256=d8eCjjV32QwqoJa759CEcETnnsjG5qVKDLQ84yYtlus,3898
-xenfra_sdk-0.2.1.dist-info/WHEEL,sha256=eycQt0QpYmJMLKpE3X9iDk8R04v2ZF0x82ogq-zP6bQ,79
-xenfra_sdk-0.2.1.dist-info/METADATA,sha256=-nLfpSQm2a5dz_hhGafkZ1OVyVX9ZU6IRCmQKGMu5es,3980
-xenfra_sdk-0.2.1.dist-info/RECORD,,