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

xenfra_sdk/resources/intelligence.py

@@ -1,105 +1,95 @@
-"""
-Intelligence resource manager for Xenfra SDK.
-Provides AI-powered deployment diagnosis and codebase analysis.
-"""
-import logging
-
-from ..exceptions import XenfraAPIError, XenfraError
-from ..models import CodebaseAnalysisResponse, DiagnosisResponse
-from ..utils import safe_json_parse
-from .base import BaseManager
-
-logger = logging.getLogger(__name__)
-
-
-class IntelligenceManager(BaseManager):
-    """
-    Manager for AI-powered intelligence operations.
-
-    Provides:
-    - Deployment failure diagnosis (Zen Nod)
-    - Codebase analysis for zero-config init (Zen Init)
-    """
-
-    def diagnose(
-        self,
-        logs: str,
-        package_manager: str | None = None,
-        dependency_file: str | None = None
-    ) -> DiagnosisResponse:
-        """
-        Diagnose deployment failure from logs using AI.
-
-        Args:
-            logs: The deployment logs to analyze
-            package_manager: Optional package manager context (uv, pip, poetry, npm, etc.)
-                           If provided, AI will target this manager's dependency file
-            dependency_file: Optional dependency file context (pyproject.toml, requirements.txt, etc.)
-                           If provided, AI will suggest patches for this file
-
-        Returns:
-            DiagnosisResponse with diagnosis, suggestion, and optional patch
-
-        Raises:
-            XenfraAPIError: If the API request fails
-            XenfraError: If parsing the response fails
-        """
-        try:
-            # Build request payload
-            payload = {"logs": logs}
-            if package_manager:
-                payload["package_manager"] = package_manager
-            if dependency_file:
-                payload["dependency_file"] = dependency_file
-
-            response = self._client._request(
-                "POST",
-                "/intelligence/diagnose",
-                json=payload
-            )
-
-            logger.debug(
-                f"IntelligenceManager.diagnose response: status={response.status_code}"
-            )
-
-            # Safe JSON parsing
-            data = safe_json_parse(response)
-            return DiagnosisResponse(**data)
-        except XenfraAPIError:
-            raise
-        except Exception as e:
-            raise XenfraError(f"Failed to diagnose logs: {e}")
-
-    def analyze_codebase(self, code_snippets: dict[str, str]) -> CodebaseAnalysisResponse:
-        """
-        Analyze codebase to detect framework, dependencies, and deployment config.
-
-        Args:
-            code_snippets: Dictionary of filename -> content
-                           e.g., {"main.py": "...", "requirements.txt": "..."}
-
-        Returns:
-            CodebaseAnalysisResponse with detected configuration
-
-        Raises:
-            XenfraAPIError: If the API request fails
-            XenfraError: If parsing the response fails
-        """
-        try:
-            response = self._client._request(
-                "POST",
-                "/intelligence/analyze-codebase",
-                json={"code_snippets": code_snippets}
-            )
-
-            logger.debug(
-                f"IntelligenceManager.analyze_codebase response: status={response.status_code}"
-            )
-
-            # Safe JSON parsing
-            data = safe_json_parse(response)
-            return CodebaseAnalysisResponse(**data)
-        except XenfraAPIError:
-            raise
-        except Exception as e:
-            raise XenfraError(f"Failed to analyze codebase: {e}")
+"""
+Intelligence resource manager for Xenfra SDK.
+Provides AI-powered deployment diagnosis and codebase analysis.
+"""
+
+import logging
+
+from ..exceptions import XenfraAPIError, XenfraError
+from ..models import CodebaseAnalysisResponse, DiagnosisResponse
+from ..utils import safe_json_parse
+from .base import BaseManager
+
+logger = logging.getLogger(__name__)
+
+
+class IntelligenceManager(BaseManager):
+    """
+    Manager for AI-powered intelligence operations.
+
+    Provides:
+    - Deployment failure diagnosis (Zen Nod)
+    - Codebase analysis for zero-config init (Zen Init)
+    """
+
+    def diagnose(
+        self, logs: str, package_manager: str | None = None, dependency_file: str | None = None
+    ) -> DiagnosisResponse:
+        """
+        Diagnose deployment failure from logs using AI.
+
+        Args:
+            logs: The deployment logs to analyze
+            package_manager: Optional package manager context (uv, pip, poetry, npm, etc.)
+                           If provided, AI will target this manager's dependency file
+            dependency_file: Optional dependency file context (pyproject.toml, requirements.txt, etc.)
+                           If provided, AI will suggest patches for this file
+
+        Returns:
+            DiagnosisResponse with diagnosis, suggestion, and optional patch
+
+        Raises:
+            XenfraAPIError: If the API request fails
+            XenfraError: If parsing the response fails
+        """
+        try:
+            # Build request payload
+            payload = {"logs": logs}
+            if package_manager:
+                payload["package_manager"] = package_manager
+            if dependency_file:
+                payload["dependency_file"] = dependency_file
+
+            response = self._client._request("POST", "/intelligence/diagnose", json=payload)
+
+            logger.debug(f"IntelligenceManager.diagnose response: status={response.status_code}")
+
+            # Safe JSON parsing
+            data = safe_json_parse(response)
+            return DiagnosisResponse(**data)
+        except XenfraAPIError:
+            raise
+        except Exception as e:
+            raise XenfraError(f"Failed to diagnose logs: {e}")
+
+    def analyze_codebase(self, code_snippets: dict[str, str]) -> CodebaseAnalysisResponse:
+        """
+        Analyze codebase to detect framework, dependencies, and deployment config.
+
+        Args:
+            code_snippets: Dictionary of filename -> content
+                           e.g., {"main.py": "...", "requirements.txt": "..."}
+
+        Returns:
+            CodebaseAnalysisResponse with detected configuration
+
+        Raises:
+            XenfraAPIError: If the API request fails
+            XenfraError: If parsing the response fails
+        """
+        try:
+            response = self._client._request(
+                "POST", "/intelligence/analyze-codebase", json={"code_snippets": code_snippets}
+            )
+
+            logger.debug(
+                f"IntelligenceManager.analyze_codebase response: status={response.status_code}"
+            )
+
+            # Safe JSON parsing
+            data = safe_json_parse(response)
+            return CodebaseAnalysisResponse(**data)
+        except XenfraAPIError:
+            raise
+        except Exception as e:
+            raise XenfraError(f"Failed to analyze codebase: {e}")

xenfra_sdk/resources/projects.py

@@ -24,7 +24,9 @@ class ProjectsManager(BaseManager):
             projects = safe_get_json_field(data, "projects", [])
 
             if not isinstance(projects, list):
-                raise XenfraError(f"Expected 'projects' to be a list, got {type(projects).__name__}")
+                raise XenfraError(
+                    f"Expected 'projects' to be a list, got {type(projects).__name__}"
+                )
 
             return [ProjectRead(**p) for p in projects]
         except XenfraAPIError:
@@ -58,10 +60,7 @@ class ProjectsManager(BaseManager):
             raise XenfraError(f"Failed to get project {project_id}: {e}")
 
     def create(
-        self,
-        name: str,
-        region: str = "nyc3",
-        size_slug: str = "s-1vcpu-1gb"
+        self, name: str, region: str = "nyc3", size_slug: str = "s-1vcpu-1gb"
     ) -> ProjectRead:
         """Create a new project.
 
@@ -78,11 +77,7 @@ class ProjectsManager(BaseManager):
             XenfraError: If there's a network or parsing error.
         """
         try:
-            payload = {
-                "name": name,
-                "region": region,
-                "size_slug": size_slug
-            }
+            payload = {"name": name, "region": region, "size_slug": size_slug}
             logger.debug(f"ProjectsManager.create payload: {payload}")
             response = self._client._request("POST", "/projects/", json=payload)
             # Safe JSON parsing

xenfra_sdk/security.py

@@ -1,41 +1,41 @@
-# src/xenfra_sdk/security.py
-"""
-Security utilities for the Xenfra SDK.
-Provides token encryption/decryption for storing OAuth credentials.
-"""
-
-import os
-from typing import Optional
-
-from cryptography.fernet import Fernet
-
-# --- Configuration from Environment ---
-# These should be set in the service's environment
-ENCRYPTION_KEY = os.getenv("ENCRYPTION_KEY", "")
-
-
-def _get_fernet() -> Optional[Fernet]:
-    """Get Fernet instance for encryption/decryption."""
-    if not ENCRYPTION_KEY:
-        return None
-    try:
-        return Fernet(ENCRYPTION_KEY.encode())
-    except Exception:
-        return None
-
-
-# --- Token Encryption ---
-def encrypt_token(token: str) -> str:
-    """Encrypts a token using Fernet symmetric encryption."""
-    fernet = _get_fernet()
-    if fernet is None:
-        raise ValueError("ENCRYPTION_KEY environment variable is not set or invalid")
-    return fernet.encrypt(token.encode()).decode()
-
-
-def decrypt_token(encrypted_token: str) -> str:
-    """Decrypts a token."""
-    fernet = _get_fernet()
-    if fernet is None:
-        raise ValueError("ENCRYPTION_KEY environment variable is not set or invalid")
-    return fernet.decrypt(encrypted_token.encode()).decode()
+# src/xenfra_sdk/security.py
+"""
+Security utilities for the Xenfra SDK.
+Provides token encryption/decryption for storing OAuth credentials.
+"""
+
+import os
+from typing import Optional
+
+from cryptography.fernet import Fernet
+
+# --- Configuration from Environment ---
+# These should be set in the service's environment
+ENCRYPTION_KEY = os.getenv("ENCRYPTION_KEY", "")
+
+
+def _get_fernet() -> Optional[Fernet]:
+    """Get Fernet instance for encryption/decryption."""
+    if not ENCRYPTION_KEY:
+        return None
+    try:
+        return Fernet(ENCRYPTION_KEY.encode())
+    except Exception:
+        return None
+
+
+# --- Token Encryption ---
+def encrypt_token(token: str) -> str:
+    """Encrypts a token using Fernet symmetric encryption."""
+    fernet = _get_fernet()
+    if fernet is None:
+        raise ValueError("ENCRYPTION_KEY environment variable is not set or invalid")
+    return fernet.encrypt(token.encode()).decode()
+
+
+def decrypt_token(encrypted_token: str) -> str:
+    """Decrypts a token."""
+    fernet = _get_fernet()
+    if fernet is None:
+        raise ValueError("ENCRYPTION_KEY environment variable is not set or invalid")
+    return fernet.decrypt(encrypted_token.encode()).decode()

xenfra_sdk/templates/Dockerfile.j2

@@ -1,25 +1,25 @@
-# Dockerfile template for Python web applications
-FROM {{ python_version | default('python:3.11-slim') }}
-
-WORKDIR /app
-
-# Install uv, our preferred package manager
-RUN apt-get update && apt-get install -y curl && \
-    curl -LsSf https://astral.sh/uv/install.sh | sh && \
-    apt-get remove -y curl && \
-    apt-get clean && \
-    rm -rf /var/lib/apt/lists/*
-
-COPY requirements.txt .
-
-# Install dependencies
-RUN /root/.cargo/bin/uv pip install --system --no-cache -r requirements.txt
-
-COPY . .
-
-# Expose the application port
-EXPOSE {{ port | default(8000) }}
-
-# The command to run the application will be in docker-compose.yml
-# This allows for more flexibility
-
+# Dockerfile template for Python web applications
+FROM {{ python_version | default('python:3.11-slim') }}
+
+WORKDIR /app
+
+# Install uv, our preferred package manager
+RUN apt-get update && apt-get install -y curl && \
+    curl -LsSf https://astral.sh/uv/install.sh | sh && \
+    apt-get remove -y curl && \
+    apt-get clean && \
+    rm -rf /var/lib/apt/lists/*
+
+COPY requirements.txt .
+
+# Install dependencies
+RUN /root/.cargo/bin/uv pip install --system --no-cache -r requirements.txt
+
+COPY . .
+
+# Expose the application port
+EXPOSE {{ port | default(8000) }}
+
+# The command to run the application will be in docker-compose.yml
+# This allows for more flexibility
+

xenfra_sdk/templates/cloud-init.sh.j2

@@ -1,68 +1,68 @@
-#!/bin/bash
-export DEBIAN_FRONTEND=noninteractive
-LOG="/root/setup.log"
-touch $LOG
-
-echo "--------------------------------" >> $LOG
-echo "🧘 XENFRA: Context-Aware Boot" >> $LOG
-echo "--------------------------------" >> $LOG
-
-# Create App Directory
-mkdir -p /root/app
-cd /root/app
-
-# --- AGGRESSIVE FIX: KILL BACKGROUND UPDATES ---
-echo "⚔️  [0/6] Stopping Background Updates..." >> $LOG
-systemctl stop unattended-upgrades.service || true
-systemctl stop apt-daily.service || true
-systemctl stop apt-daily-upgrade.service || true
-systemctl kill --kill-who=all apt-daily.service || true
-systemctl kill --kill-who=all apt-daily-upgrade.service || true
-
-# Force remove locks if they exist
-rm -f /var/lib/dpkg/lock*
-rm -f /var/lib/apt/lists/lock
-rm -f /var/cache/apt/archives/lock
-dpkg --configure -a || true
-# -----------------------------------------------
-
-# 1. System Updates
-echo "🔄 [1/5] Refreshing Package Lists..." >> $LOG
-apt-get update
-apt-get install -y python3-pip git curl
-
-# 2. Install Docker & Compose
-echo "🐳 [2/5] Installing Docker..." >> $LOG
-apt-get install -y docker.io || (curl -fsSL https://get.docker.com | sh)
-echo "🎶 [3/5] Installing Docker Compose..." >> $LOG
-apt-get install -y docker-compose-v2
-
-# --- DOCKERIZED DEPLOYMENT ---
-echo "📦 [4/5] Installing Caddy..." >> $LOG
-apt-get install -y debian-keyring debian-archive-keyring apt-transport-https
-curl -LsSf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
-curl -LsSf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | tee /etc/apt/sources.list.d/caddy-stable.list
-apt-get update
-apt-get install -y caddy
-
-{% if domain %}
-# Dynamically generate Caddyfile content
-echo "🔒 Writing Caddyfile for {{ domain }}..." >> $LOG
-cat << EOF > /etc/caddy/Caddyfile
-{{ domain }}:80, {{ domain }}:443 {
-    reverse_proxy localhost:{{ port | default(8000) }}
-    tls {{ email }}
-}
-EOF
-{% endif %}
-
-{% if domain %}
-echo "🚀 [5/5] Starting Caddy..." >> $LOG
-systemctl restart caddy
-{% else %}
-echo "✅ [5/5] Skipping Caddy start (no domain specified)." >> $LOG
-{% endif %}
-
-# Finish
-echo "✅ SETUP SCRIPT COMPLETE" >> $LOG
-touch /root/setup_complete
+#!/bin/bash
+export DEBIAN_FRONTEND=noninteractive
+LOG="/root/setup.log"
+touch $LOG
+
+echo "--------------------------------" >> $LOG
+echo "🧘 XENFRA: Context-Aware Boot" >> $LOG
+echo "--------------------------------" >> $LOG
+
+# Create App Directory
+mkdir -p /root/app
+cd /root/app
+
+# --- AGGRESSIVE FIX: KILL BACKGROUND UPDATES ---
+echo "⚔️  [0/6] Stopping Background Updates..." >> $LOG
+systemctl stop unattended-upgrades.service || true
+systemctl stop apt-daily.service || true
+systemctl stop apt-daily-upgrade.service || true
+systemctl kill --kill-who=all apt-daily.service || true
+systemctl kill --kill-who=all apt-daily-upgrade.service || true
+
+# Force remove locks if they exist
+rm -f /var/lib/dpkg/lock*
+rm -f /var/lib/apt/lists/lock
+rm -f /var/cache/apt/archives/lock
+dpkg --configure -a || true
+# -----------------------------------------------
+
+# 1. System Updates
+echo "🔄 [1/5] Refreshing Package Lists..." >> $LOG
+apt-get update
+apt-get install -y python3-pip git curl
+
+# 2. Install Docker & Compose
+echo "🐳 [2/5] Installing Docker..." >> $LOG
+apt-get install -y docker.io || (curl -fsSL https://get.docker.com | sh)
+echo "🎶 [3/5] Installing Docker Compose..." >> $LOG
+apt-get install -y docker-compose-v2
+
+# --- DOCKERIZED DEPLOYMENT ---
+echo "📦 [4/5] Installing Caddy..." >> $LOG
+apt-get install -y debian-keyring debian-archive-keyring apt-transport-https
+curl -LsSf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
+curl -LsSf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | tee /etc/apt/sources.list.d/caddy-stable.list
+apt-get update
+apt-get install -y caddy
+
+{% if domain %}
+# Dynamically generate Caddyfile content
+echo "🔒 Writing Caddyfile for {{ domain }}..." >> $LOG
+cat << EOF > /etc/caddy/Caddyfile
+{{ domain }}:80, {{ domain }}:443 {
+    reverse_proxy localhost:{{ port | default(8000) }}
+    tls {{ email }}
+}
+EOF
+{% endif %}
+
+{% if domain %}
+echo "🚀 [5/5] Starting Caddy..." >> $LOG
+systemctl restart caddy
+{% else %}
+echo "✅ [5/5] Skipping Caddy start (no domain specified)." >> $LOG
+{% endif %}
+
+# Finish
+echo "✅ SETUP SCRIPT COMPLETE" >> $LOG
+touch /root/setup_complete

xenfra_sdk/templates/docker-compose.yml.j2

@@ -1,33 +1,33 @@
-# docker-compose.yml template
-version: '3.8'
-
-services:
-  app:
-    build: .
-    ports:
-      - "{{ port | default(8000) }}:{{ port | default(8000) }}"
-    volumes:
-      - .:/app
-    command: {{ command }}
-    {% if database == 'postgres' %}
-    depends_on:
-      - db
-    environment:
-      - DATABASE_URL=postgresql://{{ db_user | default('user') }}:{{ db_password | default('password') }}@db:5432/{{ db_name | default('appdb') }}
-    {% endif %}
-
-  {% if database == 'postgres' %}
-  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') }}
-  {% endif %}
-
-volumes:
-  {% if database == 'postgres' %}
-  postgres_data:
-  {% endif %}
+# docker-compose.yml template
+version: '3.8'
+
+services:
+  app:
+    build: .
+    ports:
+      - "{{ port | default(8000) }}:{{ port | default(8000) }}"
+    volumes:
+      - .:/app
+    command: {{ command }}
+    {% if database == 'postgres' %}
+    depends_on:
+      - db
+    environment:
+      - DATABASE_URL=postgresql://{{ db_user | default('user') }}:{{ db_password | default('password') }}@db:5432/{{ db_name | default('appdb') }}
+    {% endif %}
+
+  {% if database == 'postgres' %}
+  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') }}
+  {% endif %}
+
+volumes:
+  {% if database == 'postgres' %}
+  postgres_data:
+  {% endif %}

xenfra_sdk/utils.py

@@ -1,6 +1,6 @@
 import os
 import tomllib  # Python 3.11+
-from typing import Any, Dict, Optional
+from typing import Any, Dict
 
 import httpx
 
@@ -92,9 +92,7 @@ def safe_json_parse(response: httpx.Response) -> Dict[str, Any]:
     if "application/json" not in content_type:
         # Try to get error text for better error messages
         error_text = response.text[:500] if response.text else "Unknown error"
-        raise XenfraError(
-            f"Expected JSON response, got {content_type}. Response: {error_text}"
-        )
+        raise XenfraError(f"Expected JSON response, got {content_type}. Response: {error_text}")
 
     try:
         return response.json()