xenfra-sdk 0.1.2__py3-none-any.whl → 0.1.3__py3-none-any.whl

{xenfra_sdk-0.1.2.dist-info → xenfra_sdk-0.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: xenfra-sdk
-Version: 0.1.2
+Version: 0.1.3
 Summary: Xenfra SDK: Core engine and utilities for the Xenfra platform.
 Author: xenfra-cloud
 Author-email: xenfra-cloud <xenfracloud@gmail.com>
@@ -25,94 +25,94 @@ 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 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.1.3.dist-info/RECORD

@@ -0,0 +1,31 @@
+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=hOXy6dKl3QGFamRN2WZ0rAh6Vguykhkdyal3grhGAOI,3146
+xenfra_sdk/engine.py,sha256=-EyDw5BrsyjgaH8NgYYi-UFWMRvPMm2UAou_TxRvRvY,17055
+xenfra_sdk/exceptions.py,sha256=FaKctVJNMFIw09G8Lm2yd_DHhSngGcyh2j_BTgXMM60,496
+xenfra_sdk/mcp_client.py,sha256=GPsVJtWT87G7k_GxePATLfCqFkYFFNIbpW5AsZi4Bhk,5931
+xenfra_sdk/models.py,sha256=VDd41JxqyzrsNZugXe5IP9OKkNuGVRFSnoTrHBOSKjk,7185
+xenfra_sdk/patterns.json,sha256=RBuQdU59UEXF5pxUvcWq_ZegsK0iUfh4wusWaY77qxo,459
+xenfra_sdk/privacy.py,sha256=ksGf5L9PVtRP-xZS3T-Gj7MKfexTqIMgbFLoYkIESOE,5662
+xenfra_sdk/recipes.py,sha256=g_UKQIcdSokYh7zn186mzDTr08P034-KZ1iiDNELyP4,877
+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=JwlsCUKQUyvUF0lYUv6A3n1EkglXoYsICNVssx8E6ec,3428
+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=NKIwtL9OgnlK2NnYRZI3gWC9aYl6wNPsS6r14g8eHQQ,2290
+xenfra_sdk/templates/docker-compose.yml.j2,sha256=qMHiatuZlxiYZ1pE_g2ag1M798MvQbeq0cVTVK07jkM,893
+xenfra_sdk/utils.py,sha256=d8eCjjV32QwqoJa759CEcETnnsjG5qVKDLQ84yYtlus,3898
+xenfra_sdk-0.1.3.dist-info/WHEEL,sha256=KSLUh82mDPEPk0Bx0ScXlWL64bc8KmzIPNcpQZFV-6E,79
+xenfra_sdk-0.1.3.dist-info/METADATA,sha256=0uvLdk5kr1Zts-HDNDqOTPNHJ0R2DkRFjG0Q64l4T0Q,3980
+xenfra_sdk-0.1.3.dist-info/RECORD,,

{xenfra_sdk-0.1.2.dist-info → xenfra_sdk-0.1.3.dist-info}/WHEEL

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

xenfra_sdk-0.1.2.dist-info/RECORD

@@ -1,31 +0,0 @@
-xenfra_sdk/__init__.py,sha256=lk9xo2msYvs_JgBePTIuxRb2sBW-egJS_EAOq4w4xQo,467
-xenfra_sdk/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xenfra_sdk/cli/main.py,sha256=541nlIUYFFeu4h1sCXivaHMC7SqpskazI0YocM8ylh4,7958
-xenfra_sdk/client.py,sha256=ufxjjVY3UG1roR0q8LYBmCHOJ13uRQuycqTqYuHgqTs,3514
-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=LqnpUbtSZ21jdPVzdyFyxpYqOXUkBVl5JGXq85ASI7g,875
-xenfra_sdk/db/session.py,sha256=LoTKFO3FTsx5AtZ-0ZsplxXjAdzOgcr3Yk-dkeJsz5U,823
-xenfra_sdk/dependencies.py,sha256=WHGfIrEYkss5yuBd_uOFrB6lPBWM2X0mEuG26ILAjXI,1211
-xenfra_sdk/dockerizer.py,sha256=73CFwztKogBmlX00tek0M8evncnZRDThQKmg7auw6mc,3059
-xenfra_sdk/engine.py,sha256=5qrtDc8qXC9xuZGPUwcUeGEtVuVksWY64sCxh-Wqa7o,15517
-xenfra_sdk/exceptions.py,sha256=aMVtDVlzG7-FT2G_b-pJSuuey22B4YvC-b-L37GaImM,477
-xenfra_sdk/mcp_client.py,sha256=NZtQz_qK_8i504rVPXlE1vPdzt75hg8Lkp4d8BA8dk0,5777
-xenfra_sdk/models.py,sha256=o03GUy4qcgAJa9KzR9UXWKLPWTR5gvE8GF6KSAj80eM,7003
-xenfra_sdk/patterns.json,sha256=xHxbc0ogHDwysMczi30_hW1Ylfdsf-nsQdAom7RZ4KI,446
-xenfra_sdk/privacy.py,sha256=Bscv7bopCQTeJhvU8Z2jxdBfc5tCZDY5kuODonTcgSk,5509
-xenfra_sdk/recipes.py,sha256=J6-7tDWVXv8IelkdBta5pDRhD0o5VgAM_jWDKvPvm5g,852
-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=QIOd-9L1m-FW5I6eXZEtQSteg_gkIzk2nnqr_hQs5gc,3339
-xenfra_sdk/resources/intelligence.py,sha256=ihkhv8jj4FDB4pbSezAnUL-5syZ77lLXPI6X38THcnQ,3323
-xenfra_sdk/resources/projects.py,sha256=EsCVXmqkhWl_Guz_8WDQDi3kAm1Wyg1rjXcyAigPD6E,3712
-xenfra_sdk/security.py,sha256=6vMZpbglhkRGBVVj4RCTu45-MCnQ15wt94-996zmaT8,1199
-xenfra_sdk/templates/Dockerfile.j2,sha256=apWts895OOoUYwj_fOa6OiylFB5m8zFEYvJ1Nki32YM,664
-xenfra_sdk/templates/cloud-init.sh.j2,sha256=QCWG8hL1V05bAQ7BQ70QfuhIvS4tnsL8ZTCVtyi9F0A,2222
-xenfra_sdk/templates/docker-compose.yml.j2,sha256=zKUT2cd_FrxXvRxE-vAAjuQk3-nLNQjRe-StkhAWRQA,860
-xenfra_sdk/utils.py,sha256=d8eCjjV32QwqoJa759CEcETnnsjG5qVKDLQ84yYtlus,3898
-xenfra_sdk-0.1.2.dist-info/WHEEL,sha256=ZyFSCYkV2BrxH6-HRVRg3R9Fo7MALzer9KiPYqNxSbo,79
-xenfra_sdk-0.1.2.dist-info/METADATA,sha256=sFTH52KuMEL0mWE3gFhKAYoOE_rS6iX_FOFJp19bhtU,3889
-xenfra_sdk-0.1.2.dist-info/RECORD,,