xenfra 0.1.7__py3-none-any.whl → 0.1.8__py3-none-any.whl

xenfra/models.py

@@ -0,0 +1,54 @@
+from enum import Enum
+from datetime import datetime
+from pydantic import BaseModel, Field
+
+class DeploymentStatus(str, Enum):
+    PENDING = "pending"
+    IN_PROGRESS = "in_progress"
+    SUCCESS = "success"
+    FAILED = "failed"
+
+class SourceType(str, Enum):
+    LOCAL = "local"
+    GIT = "git"
+
+class Deployment(BaseModel):
+    id: str = Field(..., description="Unique identifier for the deployment")
+    projectId: str = Field(..., description="Identifier of the project being deployed")
+    status: DeploymentStatus = Field(..., description="Current status of the deployment")
+    source: str = Field(..., description="Source of the deployment (e.g., 'cli', 'api')")
+    created_at: datetime = Field(..., description="Timestamp when the deployment was created")
+    finished_at: datetime | None = Field(None, description="Timestamp when the deployment finished")
+
+class DeploymentRecord(BaseModel):
+    deployment_id: str = Field(..., description="Unique identifier for this deployment instance.")
+    timestamp: datetime = Field(..., description="Timestamp of when the deployment succeeded.")
+    source_type: SourceType = Field(..., description="The type of the source code (local or git).")
+    source_identifier: str = Field(..., description="The identifier for the source (commit SHA for git, archive path for local).")
+
+class BalanceRead(BaseModel):
+    month_to_date_balance: str
+    account_balance: str
+    month_to_date_usage: str
+    generated_at: str
+    error: str | None = None
+
+class DropletCostRead(BaseModel):
+    id: int
+    name: str
+    ip_address: str
+    status: str
+    size_slug: str
+    monthly_price: float
+
+class ProjectRead(BaseModel):
+    id: int
+    name: str
+    ip_address: str | None = None
+    status: str
+    region: str
+    size_slug: str
+    estimated_monthly_cost: float | None = None
+    created_at: datetime
+
+

xenfra/recipes.py

@@ -1,121 +1,23 @@
-def generate_stack(context, is_dockerized=False):
+from jinja2 import Environment, FileSystemLoader
+from pathlib import Path
+
+def generate_stack(context: dict):
     """
-    Generates a startup script.
-    INCLUDES 'AGGRESSIVE MODE' to kill background updates.
+    Generates a cloud-init startup script from a Jinja2 template.
+    
+    Args:
+        context: A dictionary containing information for rendering the template,
+                 e.g., {'domain': 'example.com', 'email': 'user@example.com'}
     """
-    project_type = context.get("type", "pip")
-    packages = context.get("packages", "")
-
-    script = """#!/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
-systemctl stop apt-daily.service
-systemctl stop apt-daily-upgrade.service
-systemctl kill --kill-who=all apt-daily.service
-systemctl kill --kill-who=all apt-daily-upgrade.service
-
-# Force remove locks if they exist (The Nuclear Option)
-rm -f /var/lib/dpkg/lock*
-rm -f /var/lib/apt/lists/lock
-rm -f /var/cache/apt/archives/lock
-dpkg --configure -a
-# -----------------------------------------------
-
-# 1. System Updates
-echo "🔄 [1/6] Refreshing Package Lists..." >> $LOG
-apt-get update
-apt-get install -y python3-pip python3-venv git curl
-
-# 2. Install Docker & Compose
-echo "🐳 [2/6] Installing Docker..." >> $LOG
-apt-get install -y docker.io || (curl -fsSL https://get.docker.com | sh)
-echo "🎶 [3/6] Installing Docker Compose..." >> $LOG
-apt-get install -y docker-compose-v2
-"""
-
-    if is_dockerized:
-        script += """
-# --- DOCKERIZED DEPLOYMENT ---
-echo "📦 [4/6] 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
-
-# --- Stop and disable global Caddy to prevent port conflicts ---
-echo "🛑 Stopping global Caddy service to free up ports..." >> $LOG
-systemctl stop caddy || true
-systemctl disable caddy || true
-# ------------------------------------------------------------------
-
-echo "🚀 [5/6] Starting application with Docker Compose..." >> $LOG
-cd /root/app
-docker-compose -f /root/app/docker-compose.yml up -d
-
-echo "🔒 [6/6] Reloading Caddy..." >> $LOG
-# Caddy will automatically use the Caddyfile from the mounted volume in docker-compose
-# We just need to make sure it's running. Docker-compose handles this.
-# A system reload might be useful if Caddy was installed as a host service.
-systemctl reload caddy || systemctl start caddy
-"""
-    else:
-        # 3. Virtual Environment Setup (Non-Dockerized)
-        if project_type == "uv":
-            script += """
-# --- STANDARD NON-DOCKER DEPLOYMENT (UV) ---
-echo "⚡ [4/6] Installing UV..." >> $LOG
-curl -LsSf https://astral.sh/uv/install.sh | sh
-source $HOME/.local/bin/env
-export PATH="/root/.local/bin:$PATH"
-
-echo "⚡ [5/6] Creating UV Venv..." >> $LOG
-uv venv /root/venv
-source /root/venv/bin/activate
-"""
-        else:
-            script += """
-# --- STANDARD NON-DOCKER DEPLOYMENT (PIP) ---
-echo "🐍 [4/6] Creating Python Venv..." >> $LOG
-python3 -m venv /root/venv
-source /root/venv/bin/activate
-echo "🐍 [5/6] Upgrading Pip..." >> $LOG
-pip install --upgrade pip
-"""
-        # 4. Install Packages (Non-Dockerized)
-        if packages:
-            if project_type == "uv":
-                script += f"""
-echo "📦 [6/6] UV Installing Deps: {packages}..." >> $LOG
-source /root/venv/bin/activate
-uv pip install {packages}
-"""
-            else:
-                script += f"""
-echo "📦 [6/6] Pip Installing Deps: {packages}..." >> $LOG
-source /root/venv/bin/activate
-pip install {packages}
-"""
-        else:
-            script += 'echo "ℹ️  [6/6] No packages detected." >> $LOG\n'
-
-    # Finish
-    script += """
-
-echo "✅ SETUP COMPLETE" >> $LOG
-touch /root/setup_complete
-"""
+    # Path to the templates directory
+    template_dir = Path(__file__).parent / "templates"
+    env = Environment(loader=FileSystemLoader(template_dir))
+
+    template = env.get_template("cloud-init.sh.j2")
+    
+    # The non-dockerized logic has been removed as we are focusing on
+    # a purely Docker-based deployment strategy for simplicity and scalability.
+    # The context will contain all necessary variables for the template.
+    script = template.render(context)
+    
     return script

xenfra/security.py

@@ -0,0 +1,58 @@
+# src/xenfra/security.py
+
+from datetime import datetime, timedelta, timezone
+from typing import Optional
+from passlib.context import CryptContext
+from jose import JWTError, jwt
+from cryptography.fernet import Fernet
+
+from xenfra.config import settings
+
+# --- Configuration ---
+SECRET_KEY = settings.SECRET_KEY
+ALGORITHM = "HS256"
+ACCESS_TOKEN_EXPIRE_MINUTES = 30
+
+# This key MUST be 32 url-safe base64-encoded bytes.
+fernet = Fernet(settings.ENCRYPTION_KEY.encode())
+
+# --- Password Hashing ---
+# Explicitly use passlib.backends.bcrypt
+pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")
+
+def verify_password(plain_password: str, hashed_password: str) -> bool:
+    return pwd_context.verify(plain_password, hashed_password)
+
+def get_password_hash(password: str) -> str:
+    # bcrypt passwords cannot be longer than 72 bytes. Truncate if necessary.
+    # Note: Frontend should also enforce password length limits.
+    if len(password.encode('utf-8')) > 72:
+        password = password[:72]
+    return pwd_context.hash(password)
+
+# --- JWT Handling ---
+def create_access_token(data: dict, expires_delta: Optional[timedelta] = None):
+    to_encode = data.copy()
+    if expires_delta:
+        expire = datetime.now(timezone.utc) + expires_delta
+    else:
+        expire = datetime.now(timezone.utc) + timedelta(minutes=ACCESS_TOKEN_EXPIRE_MINUTES)
+    to_encode.update({"exp": expire})
+    encoded_jwt = jwt.encode(to_encode, SECRET_KEY, algorithm=ALGORITHM)
+    return encoded_jwt
+
+def decode_token(token: str) -> Optional[dict]:
+    try:
+        payload = jwt.decode(token, SECRET_KEY, algorithms=[ALGORITHM])
+        return payload
+    except JWTError:
+        return None
+
+# --- Token Encryption ---
+def encrypt_token(token: str) -> str:
+    """Encrypts a token using Fernet symmetric encryption."""
+    return fernet.encrypt(token.encode()).decode()
+
+def decrypt_token(encrypted_token: str) -> str:
+    """Decrypts a token."""
+    return fernet.decrypt(encrypted_token.encode()).decode()

xenfra/templates/Dockerfile.j2

@@ -0,0 +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
+

xenfra/templates/cloud-init.sh.j2

@@ -0,0 +1,72 @@
+#!/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/6] Refreshing Package Lists..." >> $LOG
+apt-get update
+apt-get install -y python3-pip git curl
+
+# 2. Install Docker & Compose
+echo "🐳 [2/6] Installing Docker..." >> $LOG
+apt-get install -y docker.io || (curl -fsSL https://get.docker.com | sh)
+echo "🎶 [3/6] Installing Docker Compose..." >> $LOG
+apt-get install -y docker-compose-v2
+
+# --- DOCKERIZED DEPLOYMENT ---
+echo "📦 [4/6] 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 %}
+
+echo "🚀 [5/6] Starting application with Docker Compose..." >> $LOG
+cd /root/app
+docker-compose -f /root/app/docker-compose.yml up -d
+
+{% if domain %}
+echo "🔒 [6/6] Starting Caddy..." >> $LOG
+systemctl restart caddy
+{% else %}
+echo "✅ [6/6] Skipping Caddy start (no domain specified)." >> $LOG
+{% endif %}
+
+# Finish
+echo "✅ SETUP SCRIPT COMPLETE" >> $LOG
+touch /root/setup_complete

xenfra/templates/docker-compose.yml.j2

@@ -0,0 +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 %}

{xenfra-0.1.7.dist-info → xenfra-0.1.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: xenfra
-Version: 0.1.7
+Version: 0.1.8
 Summary: A 'Zen Mode' infrastructure engine for Python developers.
 Author: xenfra-cloud
 Author-email: xenfra-cloud <xenfracloud@gmail.com>
@@ -15,6 +15,19 @@ 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: fastapi>=0.110.0
+Requires-Dist: uvicorn[standard]>=0.27.1
+Requires-Dist: click>=8.1.7
+Requires-Dist: sqlmodel>=0.0.16
+Requires-Dist: psycopg2-binary>=2.9.9
+Requires-Dist: python-jose[cryptography]>=3.3.0
+Requires-Dist: passlib>=1.7.4
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: python-multipart>=0.0.21
+Requires-Dist: bcrypt==4.0.1
+Requires-Dist: jinja2>=3.1.3
+Requires-Dist: pytest>=9.0.2
 Requires-Dist: pytest>=8.0.0 ; extra == 'test'
 Requires-Dist: pytest-mock>=3.12.0 ; extra == 'test'
 Requires-Python: >=3.13
@@ -35,83 +48,37 @@ It handles the complexity of server provisioning, context-aware configuration, D
 *   **Clients as the Face**: Frontends like the default CLI (`xenfra.cli`) are thin, stateless clients responsible only for user interaction.
 *   **Zen Mode**: If a server setup fails due to common issues like a locked package manager, the Engine automatically fixes it without exposing raw errors to the user.
 
-## 🚀 Quickstart: As a Library
+## 🚀 Quickstart
 
-This demonstrates the power of Xenfra's engine for programmatic infrastructure management.
+Using the Xenfra CLI involves a simple workflow: **Configure**, **Initialize**, and then **Deploy & Manage**.
 
-### 1. Installation
+### 1. Configure
 
-```bash
-# Install from PyPI (once published)
-pip install xenfra
-```
-
-### 2. Prerequisites
-
-Ensure your DigitalOcean API token is available as an environment variable:
+Xenfra needs your DigitalOcean API token to manage infrastructure on your behalf. Export it as an environment variable:
 
 ```bash
-export DIGITAL_OCEAN_TOKEN="your_secret_token_here"
+export DIGITAL_OCEAN_TOKEN="dop_v1_your_secret_token_here"
 ```
 
-### 3. Programmatic Usage
-
-```python
-from xenfra.engine import InfraEngine
+### 2. Initialize
 
-# Optional: a logger to receive status updates
-def my_logger(message):
-    print(f"[My App] {message}")
-
-try:
-    # The engine automatically finds and validates the API token
-    engine = InfraEngine()
-
-    # Define the server and deploy
-    result = engine.deploy_server(
-        name="my-app-server",
-        region="nyc3",
-        size="s-1vcpu-1gb",
-        image="ubuntu-24-04-x64",
-        logger=my_logger
-    )
-
-    print(f"🎉 Deployment successful! IP Address: {result.get('ip')}")
-
-except Exception as e:
-    print(f"❌ Deployment failed: {e}")
-```
-
-## 💻 CLI Usage
-
-Xenfra also provides a beautiful, interactive CLI for manual control.
-
-### 1. Installation
+Navigate to your project's root directory and run the `init` command. This command scans your project, asks a few questions, and creates a `xenfra.yaml` configuration file.
 
 ```bash
-pip install xenfra
+xenfra init
 ```
+You should review the generated `xenfra.yaml` and commit it to your repository.
 
-### 2. Configuration
+### 3. Deploy & Manage
 
-Create a `.env` file in your project root with your DigitalOcean token:
-
-```env
-DIGITAL_OCEAN_TOKEN=dop_v1_your_token_here
-```
+Once your project is initialized, you can use the following commands to manage your application:
 
-### 3. Run the CLI
-
-Once installed, simply run the `xenfra` command:
-
-```bash
-xenfra
-```
+*   **`xenfra deploy`**: Deploys your application based on the settings in `xenfra.yaml`.
+*   **`xenfra list`**: Instantly lists all your deployed projects from a local cache.
+    *   Use `xenfra list --refresh` to force a sync with your cloud provider.
+*   **`xenfra logs`**: Streams real-time logs from a selected project.
+*   **`xenfra destroy`**: Decommissions and deletes a deployed project.
 
-This will launch the interactive menu where you can:
-- **🚀 Deploy New Server**: A guided workflow to provision and deploy your application.
-- **📋 List Active Servers**: View your current DigitalOcean droplets.
-- **🧨 Destroy a Server**: Decommission servers you no longer need.
 
 ## 📦 Supported Frameworks & Features
 

xenfra-0.1.8.dist-info/RECORD

@@ -0,0 +1,25 @@
+xenfra/__init__.py,sha256=ja0-Vc9T61EXZnPeX84Fi-UOjoGAWu5r90_1t-0WjVw,46
+xenfra/api/auth.py,sha256=WxepMKeF8Xnf9imqYip_EyGT0xFXgKoAhFIYx7uqWvA,1848
+xenfra/api/billing.py,sha256=hoviKgpzjMoWcz0KW7I5HUhwLKPlRov5-3TIqzbdpAs,2871
+xenfra/api/connections.py,sha256=IQfOA9jZV6Gcz0_E69Sgp3poAMQKwGwn19GV84Sn61I,7328
+xenfra/api/main.py,sha256=psdVAOKsSM9vMmTSdZBuGceJNG50mqtJFbfa3UrTpmo,6392
+xenfra/api/webhooks.py,sha256=Ek--AVzzKxvukway-vLt_wprBMaQjuWy7q35BbUKeiA,6367
+xenfra/cli/main.py,sha256=1RiznGbrlaSDw37nD8i7wrpXMQsHnNuqk1YOYzxWdII,7841
+xenfra/config.py,sha256=g7ahyI4kbYITRcliCbzXCRfKJ3uh8E2VMjmpR-n51s8,621
+xenfra/db/models.py,sha256=nRqbG9cbcX8LWz2Jr4inKysAq47yALcxNl3_UYEpSoQ,1305
+xenfra/db/session.py,sha256=Q03RIiPlYBtPD-qVHlTqQtacnOPTZnOy6_f9p6lABPU,510
+xenfra/dependencies.py,sha256=pQ7bFNZHC24chMxRa_69mu2fIqcoc8DG9MD1POSGgjA,1211
+xenfra/dockerizer.py,sha256=5qzgqw2MZrBwI4IFzXPJZ6k3F3IRdFnX-KGIpv5cjXc,3126
+xenfra/engine.py,sha256=fzdBIW1CmOQtTETjlaMtltt0cgH8r4HN7ImH-s2Wnzk,11793
+xenfra/mcp_client.py,sha256=IxkTC3NPHvPJn-2dl5BUHQ3d-A9MBiKP9fIftzhmCuA,5756
+xenfra/models.py,sha256=9Dvr1_kb29LJIR0a-uwx_tsCWt3GZeko6FKQtYY8F4g,1852
+xenfra/recipes.py,sha256=q5ilpDzGuUM6GyvlW97pOpPS9nzQAJGI4pgzSU_URik,862
+xenfra/security.py,sha256=w7aIFnHDHOH2zDjYD_LnJnSE01NeGeoAh_V8hC1HipY,2003
+xenfra/templates/Dockerfile.j2,sha256=apWts895OOoUYwj_fOa6OiylFB5m8zFEYvJ1Nki32YM,664
+xenfra/templates/cloud-init.sh.j2,sha256=Ln7XO4rwaHgauevMKfkxAgBFNLHPnWv-TnJl3NJbU8c,2359
+xenfra/templates/docker-compose.yml.j2,sha256=zKUT2cd_FrxXvRxE-vAAjuQk3-nLNQjRe-StkhAWRQA,860
+xenfra/utils.py,sha256=aGXjJm-pwVCHuCn5UBdrxRcYvM8aJwHQ1kihl7gcxiM,2387
+xenfra-0.1.8.dist-info/WHEEL,sha256=ZyFSCYkV2BrxH6-HRVRg3R9Fo7MALzer9KiPYqNxSbo,79
+xenfra-0.1.8.dist-info/entry_points.txt,sha256=O6JNPm-inoMzmW29WPYl6jHHlWCrcs8ShHEo-CXvERs,49
+xenfra-0.1.8.dist-info/METADATA,sha256=hebQ0mFii9qF8Gs7PeVgzbBizBZ8qQ7GuFA0FycJTT4,4128
+xenfra-0.1.8.dist-info/RECORD,,

xenfra-0.1.8.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+xenfra = xenfra.cli.main:main
+