xenfra-sdk 0.1.0__tar.gz

xenfra_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.3
+Name: xenfra-sdk
+Version: 0.1.0
+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.1.0/README.md

@@ -0,0 +1,91 @@
+# 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.0/pyproject.toml

@@ -0,0 +1,37 @@
+[project]
+name = "xenfra-sdk"
+version = "0.1.0"
+description = "Xenfra SDK: Core engine and utilities for the Xenfra platform."
+readme = "README.md"
+authors = [
+    { name = "xenfra-cloud", email = "xenfracloud@gmail.com" }
+]
+
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Build Tools",
+    "Topic :: System :: Systems Administration",
+]
+
+dependencies = [
+    "fabric>=3.2.2",
+    "python-digitalocean>=1.17.0",
+    "python-dotenv>=1.2.1",
+    "rich>=14.2.0",
+    "sqlmodel>=0.0.16",
+    "PyYAML>=6.0.1",
+    "httpx>=0.27.0",
+    "Jinja2>=3.1.3",
+    "python-jose[cryptography]>=3.3.0",
+    "passlib>=1.7.4",
+    "cryptography>=41.0.0",
+]
+requires-python = ">=3.13"
+
+[build-system]
+requires = ["uv_build>=0.9.18,<0.10.0"]
+build-backend = "uv_build"

xenfra_sdk-0.1.0/src/xenfra_sdk/__init__.py

@@ -0,0 +1,21 @@
+# This file makes src/xenfra_sdk a Python package.
+
+from .client import XenfraClient
+from .exceptions import AuthenticationError, XenfraAPIError, XenfraError
+from .models import (
+    CodebaseAnalysisResponse,
+    DiagnosisResponse,
+    PatchObject,
+    ProjectRead,
+)
+
+__all__ = [
+    "XenfraClient",
+    "XenfraError",
+    "AuthenticationError",
+    "XenfraAPIError",
+    "DiagnosisResponse",
+    "CodebaseAnalysisResponse",
+    "PatchObject",
+    "ProjectRead",
+]

xenfra_sdk-0.1.0/src/xenfra_sdk/cli/main.py

@@ -0,0 +1,226 @@
+import click
+import yaml
+from rich.console import Console
+from rich.table import Table
+from xenfra_sdk import dockerizer
+from xenfra_sdk.db.session import create_db_and_tables
+from xenfra_sdk.engine import DeploymentError, InfraEngine
+
+console = Console()
+
+
+@click.group()
+@click.pass_context
+def main(ctx):
+    """
+    Xenfra CLI: A 'Zen Mode' infrastructure engine for Python developers.
+    """
+    try:
+        create_db_and_tables()
+        ctx.obj = {"engine": InfraEngine()}
+        user_info = ctx.obj["engine"].get_user_info()
+        console.print(
+            f"[bold underline]Xenfra CLI[/bold underline] - Logged in as [green]{user_info.email}[/green]"
+        )
+    except Exception as e:
+        console.print(f"[bold red]CRITICAL ERROR:[/bold red] Failed to initialize engine: {e}")
+        exit(1)
+
+
+@main.command()
+@click.pass_context
+def init(ctx):
+    """Initializes a project by creating a xenfra.yaml configuration file."""
+    console.print("\n[bold blue]🔎 INITIALIZING PROJECT[/bold blue]")
+
+    framework, _, _ = dockerizer.detect_framework()
+    if not framework:
+        console.print("[yellow]   Warning: No recognizable web framework detected.[/yellow]")
+
+    console.print(f"   - Detected [cyan]{framework or 'unknown'}[/cyan] project.")
+
+    use_db = click.confirm(
+        "\n   Would you like to add a PostgreSQL database to your deployment?", default=False
+    )
+
+    config = {
+        "name": "xenfra-app",
+        "digitalocean": {"region": "nyc3", "size": "s-1vcpu-1gb", "image": "ubuntu-22-04-x64"},
+        "app": {"framework": framework},
+    }
+
+    if use_db:
+        config["database"] = {
+            "type": "postgres",
+            "user": "db_user",
+            "password": "db_password",  # In a real scenario, this should be handled more securely
+            "name": "app_db",
+        }
+        console.print("   - Added [bold green]PostgreSQL[/bold green] to the configuration.")
+
+    with open("xenfra.yaml", "w") as f:
+        yaml.dump(config, f, default_flow_style=False, sort_keys=False)
+
+    console.print("\n[bold green]✅ SUCCESS![/bold green]")
+    console.print("   - Created [cyan]xenfra.yaml[/cyan].")
+    console.print("\n   Next step: Review the configuration and run 'xenfra deploy'!")
+
+
+@main.command()
+@click.pass_context
+def deploy(ctx):
+    """Deploys the project based on the xenfra.yaml configuration."""
+    console.print("\n[bold green]🚀 INITIATING DEPLOYMENT FROM CONFIGURATION[/bold green]")
+
+    try:
+        with open("xenfra.yaml", "r") as f:
+            config = yaml.safe_load(f)
+    except FileNotFoundError:
+        raise click.ClickException(
+            "No 'xenfra.yaml' found. Run 'xenfra init' to create a configuration file."
+        )
+
+    engine = ctx.obj["engine"]
+
+    # Extract config values
+    name = config.get("name", "xenfra-app")
+    do_config = config.get("digitalocean", {})
+    region = do_config.get("region", "nyc3")
+    size = do_config.get("size", "s-1vcpu-1gb")
+    image = do_config.get("image", "ubuntu-22-04-x64")
+
+    # Build context for templates
+    template_context = {
+        "database": config.get("database", {}).get("type"),
+        "db_user": config.get("database", {}).get("user"),
+        "db_password": config.get("database", {}).get("password"),
+        "db_name": config.get("database", {}).get("name"),
+        "email": ctx.obj["engine"].get_user_info().email,
+    }
+
+    console.print(f"   - App Name: [cyan]{name}[/cyan]")
+    console.print(f"   - Region: [cyan]{region}[/cyan], Size: [cyan]{size}[/cyan]")
+    if template_context.get("database"):
+        console.print(f"   - Including Database: [cyan]{template_context['database']}[/cyan]")
+
+    if not click.confirm(f"\n   Ready to deploy '{name}' from 'xenfra.yaml'?"):
+        return
+
+    with console.status("[bold green]Deployment in progress...[/bold green]"):
+        result = engine.deploy_server(
+            name=name, region=region, size=size, image=image, logger=console.log, **template_context
+        )
+
+    console.print("\n[bold green]✅ DEPLOYMENT COMPLETE![/bold green]")
+    console.print(result)
+
+
+@main.command(name="list")
+@click.option("--refresh", is_flag=True, help="Sync with the cloud provider before listing.")
+@click.pass_context
+def list_projects(ctx, refresh):
+    """Lists all active Xenfra projects from the local database."""
+    engine = ctx.obj["engine"]
+
+    if refresh:
+        console.print("\n[bold]📡 SYNCING WITH CLOUD PROVIDER...[/bold]")
+        with console.status("Calling DigitalOcean API and reconciling state..."):
+            projects = engine.sync_with_provider()
+    else:
+        console.print("\n[bold]⚡️ LISTING PROJECTS FROM LOCAL DATABASE[/bold]")
+        projects = engine.list_projects_from_db()
+
+    if not projects:
+        console.print(
+            "[yellow]   No active projects found. Run 'xenfra deploy' to create one.[/yellow]"
+        )
+    else:
+        table = Table(show_header=True, header_style="bold magenta")
+        table.add_column("Droplet ID", style="dim", width=12)
+        table.add_column("Name", style="cyan")
+        table.add_column("IP Address", style="green")
+        table.add_column("Status")
+        table.add_column("Region")
+        table.add_column("Size")
+        for p in projects:
+            table.add_row(str(p.droplet_id), p.name, p.ip_address, p.status, p.region, p.size)
+        console.print(table)
+
+
+@main.command(name="logs")
+@click.pass_context
+def logs(ctx):
+    """Streams real-time logs from a deployed project."""
+    engine = ctx.obj["engine"]
+
+    console.print("\n[bold yellow]📡 SELECT A PROJECT TO STREAM LOGS[/bold yellow]")
+    projects = engine.list_projects_from_db()
+
+    if not projects:
+        console.print("[yellow]   No active projects to stream logs from.[/yellow]")
+        return
+
+    project_map = {str(i + 1): p for i, p in enumerate(projects)}
+    for k, p in project_map.items():
+        console.print(f"   [{k}] {p.name} ({p.ip_address})")
+
+    choice_key = click.prompt(
+        "\n   Select Project (0 to cancel)",
+        type=click.Choice(["0"] + list(project_map.keys())),
+        show_choices=False,
+    )
+    if choice_key == "0":
+        return
+
+    target = project_map[choice_key]
+
+    try:
+        console.print(
+            f"\n[bold green]-- Attaching to logs for {target.name} (Press Ctrl+C to stop) --[/bold green]"
+        )
+        engine.stream_logs(target.droplet_id)
+    except DeploymentError as e:
+        console.print(f"[bold red]ERROR:[/bold red] {e.message}")
+    except KeyboardInterrupt:
+        console.print("\n[bold yellow]-- Log streaming stopped by user. --[/bold yellow]")
+    except Exception as e:
+        console.print(f"[bold red]An unexpected error occurred:[/bold red] {e}")
+
+
+@main.command()
+@click.pass_context
+def destroy(ctx):
+    """Destroys a deployed project."""
+    engine = ctx.obj["engine"]
+
+    console.print("\n[bold red]🧨 SELECT A PROJECT TO DESTROY[/bold red]")
+    projects = engine.list_projects_from_db()
+
+    if not projects:
+        console.print("[yellow]   No active projects to destroy.[/yellow]")
+        return
+
+    project_map = {str(i + 1): p for i, p in enumerate(projects)}
+    for k, p in project_map.items():
+        console.print(f"   [{k}] {p.name} ({p.ip_address})")
+
+    choice_key = click.prompt(
+        "\n   Select Project to DESTROY (0 to cancel)",
+        type=click.Choice(["0"] + list(project_map.keys())),
+        show_choices=False,
+    )
+    if choice_key == "0":
+        return
+
+    target = project_map[choice_key]
+
+    if click.confirm(
+        f"   Are you SURE you want to permanently delete [red]{target.name}[/red] (Droplet ID: {target.droplet_id})? This action cannot be undone."
+    ):
+        with console.status(f"💥 Destroying {target.name}..."):
+            engine.destroy_server(target.droplet_id)
+        console.print(f"[green]   Project '{target.name}' has been destroyed.[/green]")
+
+
+if __name__ == "__main__":
+    main()

xenfra_sdk-0.1.0/src/xenfra_sdk/client.py

@@ -0,0 +1,69 @@
+import os
+
+import httpx
+
+from .exceptions import AuthenticationError, XenfraAPIError, XenfraError
+from .resources.deployments import DeploymentsManager
+from .resources.intelligence import IntelligenceManager
+from .resources.projects import ProjectsManager
+
+
+class XenfraClient:
+    def __init__(self, token: str = None, api_url: str = "http://localhost:8000"):
+        self.api_url = api_url
+        self._token = token or os.getenv("XENFRA_TOKEN")
+        if not self._token:
+            raise AuthenticationError(
+                "No API token provided. Pass it to the client or set XENFRA_TOKEN."
+            )
+
+        self._http_client = httpx.Client(
+            base_url=self.api_url,
+            headers={"Authorization": f"Bearer {self._token}", "Content-Type": "application/json"},
+            timeout=30.0,  # Add a reasonable timeout
+        )
+
+        # Track if client is closed
+        self._closed = False
+
+        # Initialize resource managers
+        self.projects = ProjectsManager(self)
+        self.deployments = DeploymentsManager(self)
+        self.intelligence = IntelligenceManager(self)
+
+    def _request(self, method: str, path: str, json: dict = None) -> httpx.Response:
+        """Internal method to handle all HTTP requests."""
+        if self._closed:
+            raise XenfraError("Client is closed. Create a new client or use context manager.")
+
+        try:
+            response = self._http_client.request(method, path, json=json)
+            response.raise_for_status()  # Raise HTTPStatusError for 4xx/5xx
+            return response
+        except httpx.HTTPStatusError as e:
+            # Convert httpx error to our custom SDK error
+            detail = e.response.json().get("detail", e.response.text)
+            raise XenfraAPIError(status_code=e.response.status_code, detail=detail) from e
+        except httpx.RequestError as e:
+            # Handle connection errors, timeouts, etc.
+            raise XenfraError(f"HTTP request failed: {e}")
+
+    def close(self):
+        """Close the HTTP client and cleanup resources."""
+        if not self._closed:
+            self._http_client.close()
+            self._closed = True
+
+    def __enter__(self):
+        """Context manager entry - allows 'with XenfraClient() as client:' usage."""
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        """Context manager exit - ensures cleanup."""
+        self.close()
+        return False  # Don't suppress exceptions
+
+    def __del__(self):
+        """Destructor - cleanup if not already closed."""
+        if hasattr(self, '_closed') and not self._closed:
+            self.close()