xenfra 0.4.3__tar.gz → 0.4.4__tar.gz

xenfra-0.4.4/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.3
+Name: xenfra
+Version: 0.4.4
+Summary: Xenfra CLI: Hands for AI to deploy on DigitalOcean.
+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: click>=8.1.7
+Requires-Dist: rich>=14.2.0
+Requires-Dist: sqlmodel>=0.0.16
+Requires-Dist: python-digitalocean>=1.17.0
+Requires-Dist: python-dotenv>=1.2.1
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: fabric>=3.2.2
+Requires-Dist: xenfra-sdk>=0.2.2
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: keyring>=25.7.0
+Requires-Dist: keyrings-alt>=5.0.2
+Requires-Dist: tenacity>=8.2.3
+Requires-Dist: cryptography>=43.0.0
+Requires-Dist: toml>=0.10.2
+Requires-Dist: pytest>=8.0.0 ; extra == 'test'
+Requires-Dist: pytest-mock>=3.12.0 ; extra == 'test'
+Requires-Python: >=3.11
+Project-URL: Homepage, https://github.com/xenfra-cloud/xenfra-cli
+Project-URL: Issues, https://github.com/xenfra-cloud/xenfra-cli/issues
+Provides-Extra: test
+Description-Content-Type: text/markdown
+
+# Xenfra CLI (The Interface) 🖥️
+
+[![PyPI](https://img.shields.io/pypi/v/xenfra)](https://pypi.org/project/xenfra/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+The official command-line interface for **Xenfra** (The Sovereign Cloud OS). It empowers developers to deploy, monitor, and manage applications on their own infrastructure (DigitalOcean) with the ease of Heroku.
+
+## 🚀 Features
+
+- **Zero-Config Deployment**: `xenfra deploy` detects your stack (Python, Node.js) and ships it.
+- **Sovereign Auth**: `xenfra auth login` connects securely to your cloud provider.
+- **Live Logs**: `xenfra logs` streams colorized, PII-scrubbed logs from your servers.
+- **Doctor**: `xenfra doctor` runs a battery of health checks on your deployment environment.
+- **Zen Mode**: Automatically applies fix patches when deployments fail.
+
+## 📦 Installation
+
+```bash
+# Recommended: Install via uv
+uv tool install xenfra
+
+# Or via pip
+pip install xenfra
+```
+
+## 🛠️ Quick Start
+
+### 1. Login
+
+Authenticate with your cloud provider (DigitalOcean via Xenfra Platform).
+
+```bash
+xenfra auth login
+```
+
+### 2. Deploy Your App
+
+Navigate to your project directory and blast off.
+
+```bash
+cd ~/my-projects/awesome-api
+xenfra deploy
+```
+
+_That's it._ Xenfra handles Dockerfile generation, server provisioning, SSL (Caddy), and database connections.
+
+### 3. Check Status
+
+```bash
+xenfra status
+```
+
+## 🎛️ Command Reference
+
+| Command             | Description                             |
+| :------------------ | :-------------------------------------- |
+| `xenfra auth login` | Start the OAuth flow                    |
+| `xenfra deploy`     | Deploy current directory                |
+| `xenfra logs`       | Tail logs (Ctrl+C to stop)              |
+| `xenfra status`     | Show health metrics (CPU/RAM)           |
+| `xenfra list`       | List all your projects                  |
+| `xenfra init`       | Generate config files without deploying |
+
+## 🔗 The Xenfra Ecosystem
+
+This CLI is the "Interface" of the Xenfra Open Core architecture:
+
+- **[xenfra-sdk](https://github.com/xenfracloud/xenfra-sdk)**: The Core Engine (Used by this CLI).
+- **[xenfra-mcp](https://github.com/xenfracloud/xenfra-mcp)**: The AI Agent Interface.
+- **xenfra-platform**: The Private SaaS Backend.
+
+## 🤝 Contributing
+
+We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+## 📄 License
+
+MIT © [Xenfra Cloud](https://xenfra.tech)

xenfra-0.4.4/README.md

@@ -0,0 +1,78 @@
+# Xenfra CLI (The Interface) 🖥️
+
+[![PyPI](https://img.shields.io/pypi/v/xenfra)](https://pypi.org/project/xenfra/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+The official command-line interface for **Xenfra** (The Sovereign Cloud OS). It empowers developers to deploy, monitor, and manage applications on their own infrastructure (DigitalOcean) with the ease of Heroku.
+
+## 🚀 Features
+
+- **Zero-Config Deployment**: `xenfra deploy` detects your stack (Python, Node.js) and ships it.
+- **Sovereign Auth**: `xenfra auth login` connects securely to your cloud provider.
+- **Live Logs**: `xenfra logs` streams colorized, PII-scrubbed logs from your servers.
+- **Doctor**: `xenfra doctor` runs a battery of health checks on your deployment environment.
+- **Zen Mode**: Automatically applies fix patches when deployments fail.
+
+## 📦 Installation
+
+```bash
+# Recommended: Install via uv
+uv tool install xenfra
+
+# Or via pip
+pip install xenfra
+```
+
+## 🛠️ Quick Start
+
+### 1. Login
+
+Authenticate with your cloud provider (DigitalOcean via Xenfra Platform).
+
+```bash
+xenfra auth login
+```
+
+### 2. Deploy Your App
+
+Navigate to your project directory and blast off.
+
+```bash
+cd ~/my-projects/awesome-api
+xenfra deploy
+```
+
+_That's it._ Xenfra handles Dockerfile generation, server provisioning, SSL (Caddy), and database connections.
+
+### 3. Check Status
+
+```bash
+xenfra status
+```
+
+## 🎛️ Command Reference
+
+| Command             | Description                             |
+| :------------------ | :-------------------------------------- |
+| `xenfra auth login` | Start the OAuth flow                    |
+| `xenfra deploy`     | Deploy current directory                |
+| `xenfra logs`       | Tail logs (Ctrl+C to stop)              |
+| `xenfra status`     | Show health metrics (CPU/RAM)           |
+| `xenfra list`       | List all your projects                  |
+| `xenfra init`       | Generate config files without deploying |
+
+## 🔗 The Xenfra Ecosystem
+
+This CLI is the "Interface" of the Xenfra Open Core architecture:
+
+- **[xenfra-sdk](https://github.com/xenfracloud/xenfra-sdk)**: The Core Engine (Used by this CLI).
+- **[xenfra-mcp](https://github.com/xenfracloud/xenfra-mcp)**: The AI Agent Interface.
+- **xenfra-platform**: The Private SaaS Backend.
+
+## 🤝 Contributing
+
+We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+## 📄 License
+
+MIT © [Xenfra Cloud](https://xenfra.tech)

{xenfra-0.4.3 → xenfra-0.4.4}/pyproject.toml

@@ -1,56 +1,54 @@
-[project]
-name = "xenfra"
-version = "0.4.3"
-description = "A 'Zen Mode' infrastructure engine for Python developers."
-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 = [
-    "click>=8.1.7",
-    "rich>=14.2.0",
-    "sqlmodel>=0.0.16",
-    "python-digitalocean>=1.17.0",
-    "python-dotenv>=1.2.1",
-    "pyyaml>=6.0.1",
-    "fabric>=3.2.2",
-    "xenfra-sdk",
-    "httpx>=0.27.0",
-    "keyring>=25.7.0",
-    "keyrings.alt>=5.0.2",
-    "tenacity>=8.2.3", # For retry logic
-    "cryptography>=43.0.0", # For encrypted file-based token storage
-    "toml>=0.10.2",
-]
-requires-python = ">=3.13"
-
-[tool.uv.sources]
-xenfra-sdk = { workspace = true }
-
-[project.urls]
-Homepage = "https://github.com/xenfra-cloud/xenfra"
-Issues = "https://github.com/xenfra-cloud/xenfra/issues"
-
-[project.optional-dependencies]
-test = [
-    "pytest>=8.0.0",
-    "pytest-mock>=3.12.0",
-]
-
-[project.scripts]
-xenfra = "xenfra.main:main"
-
-[build-system]
-requires = ["uv_build>=0.9.18,<0.10.0"]
-build-backend = "uv_build"
+[project]
+name = "xenfra"
+version = "0.4.4"
+description = "Xenfra CLI: Hands for AI to deploy on DigitalOcean."
+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 = [
+    "click>=8.1.7",
+    "rich>=14.2.0",
+    "sqlmodel>=0.0.16",
+    "python-digitalocean>=1.17.0",
+    "python-dotenv>=1.2.1",
+    "pyyaml>=6.0.1",
+    "fabric>=3.2.2",
+    "xenfra-sdk>=0.2.2",
+    "httpx>=0.27.0",
+    "keyring>=25.7.0",
+    "keyrings.alt>=5.0.2",
+    "tenacity>=8.2.3", # For retry logic
+    "cryptography>=43.0.0", # For encrypted file-based token storage
+    "toml>=0.10.2",
+]
+requires-python = ">=3.11"
+
+
+[project.urls]
+Homepage = "https://github.com/xenfra-cloud/xenfra-cli"
+Issues = "https://github.com/xenfra-cloud/xenfra-cli/issues"
+
+[project.optional-dependencies]
+test = [
+    "pytest>=8.0.0",
+    "pytest-mock>=3.12.0",
+]
+
+[project.scripts]
+xenfra = "xenfra.main:main"
+
+[build-system]
+requires = ["uv_build>=0.9.18,<0.10.0"]
+build-backend = "uv_build"

{xenfra-0.4.3 → xenfra-0.4.4}/src/xenfra/commands/__init__.py

@@ -1,3 +1,3 @@
-"""
-CLI command modules for Xenfra.
-"""
+"""
+CLI command modules for Xenfra.
+"""

{xenfra-0.4.3 → xenfra-0.4.4}/src/xenfra/commands/auth.py

@@ -1,144 +1,144 @@
-"""
-Authentication commands for Xenfra CLI.
-"""
-
-import base64
-import hashlib
-import secrets
-import urllib.parse
-import webbrowser
-from http.server import HTTPServer
-
-import click
-import httpx
-import keyring
-from rich.console import Console
-from tenacity import (
-    retry,
-    retry_if_exception_type,
-    stop_after_attempt,
-    wait_exponential,
-)
-
-from ..utils.auth import (
-    API_BASE_URL,
-    CLI_CLIENT_ID,
-    CLI_LOCAL_SERVER_END_PORT,
-    CLI_LOCAL_SERVER_START_PORT,
-    CLI_REDIRECT_PATH,
-    SERVICE_ID,
-    AuthCallbackHandler,
-    clear_tokens,
-    get_auth_token,
-)
-
-console = Console()
-
-# HTTP request timeout (30 seconds)
-HTTP_TIMEOUT = 30.0
-
-
-@click.group()
-def auth():
-    """Authentication commands (login, logout, whoami)."""
-    pass
-
-
-@retry(
-    stop=stop_after_attempt(3),
-    wait=wait_exponential(multiplier=1, min=2, max=10),
-    retry=retry_if_exception_type((httpx.TimeoutException, httpx.NetworkError)),
-    reraise=True,
-)
-def _exchange_code_for_tokens_with_retry(code: str, code_verifier: str, redirect_uri: str) -> dict:
-    """
-    Exchange authorization code for tokens with retry logic.
-
-    Returns token data dictionary.
-    """
-    with httpx.Client(timeout=HTTP_TIMEOUT) as client:
-        response = client.post(
-            f"{API_BASE_URL}/auth/token",
-            data={
-                "grant_type": "authorization_code",
-                "client_id": CLI_CLIENT_ID,
-                "code": code,
-                "code_verifier": code_verifier,
-                "redirect_uri": redirect_uri,
-            },
-            headers={"Accept": "application/json"},
-        )
-        response.raise_for_status()
-
-        # Safe JSON parsing with content-type check
-        content_type = response.headers.get("content-type", "")
-        if "application/json" not in content_type:
-            raise ValueError(f"Expected JSON response, got {content_type}")
-
-        try:
-            token_data = response.json()
-        except (ValueError, TypeError) as e:
-            raise ValueError(f"Failed to parse JSON response: {e}")
-
-        return token_data
-
-
-@auth.command()
-def login():
-    """Login to Xenfra using Device Authorization Flow (like GitHub CLI, Claude Code)."""
-    from .auth_device import device_login
-    device_login()
-
-    # Removed old PKCE flow - now using Device Authorization Flow
-
-
-@auth.command()
-def logout():
-    """Logout and clear stored tokens."""
-    try:
-        clear_tokens()
-        console.print("[bold green]Logged out successfully.[/bold green]")
-    except Exception as e:
-        console.print(f"[yellow]Warning: Error during logout: {e}[/yellow]")
-        console.print("[dim]Tokens may still be stored in keyring.[/dim]")
-
-
-@auth.command()
-@click.option("--token", is_flag=True, help="Show access token")
-def whoami(token):
-    """Show current authenticated user."""
-    access_token = get_auth_token()
-
-    if not access_token:
-        console.print("[bold red]Not logged in. Run 'xenfra login' first.[/bold red]")
-        return
-
-    try:
-        import base64
-        import json
-
-        # Manually decode JWT payload without verification
-        # JWT format: header.payload.signature
-        parts = access_token.split(".")
-        if len(parts) != 3:
-            console.print("[bold red]Invalid token format[/bold red]")
-            return
-
-        # Decode payload (second part)
-        payload_b64 = parts[1]
-        # Add padding if needed
-        padding = 4 - len(payload_b64) % 4
-        if padding != 4:
-            payload_b64 += "=" * padding
-
-        payload_bytes = base64.urlsafe_b64decode(payload_b64)
-        claims = json.loads(payload_bytes)
-
-        console.print("[bold green]Logged in as:[/bold green]")
-        console.print(f"  Email: {claims.get('sub', 'N/A')}")
-        console.print(f"  User ID: {claims.get('user_id', 'N/A')}")
-
-        if token:
-            console.print(f"\n[dim]Access Token:[/dim]\n{access_token}")
-    except Exception as e:
-        console.print(f"[bold red]Failed to decode token: {e}[/bold red]")
+"""
+Authentication commands for Xenfra CLI.
+"""
+
+import base64
+import hashlib
+import secrets
+import urllib.parse
+import webbrowser
+from http.server import HTTPServer
+
+import click
+import httpx
+import keyring
+from rich.console import Console
+from tenacity import (
+    retry,
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential,
+)
+
+from ..utils.auth import (
+    API_BASE_URL,
+    CLI_CLIENT_ID,
+    CLI_LOCAL_SERVER_END_PORT,
+    CLI_LOCAL_SERVER_START_PORT,
+    CLI_REDIRECT_PATH,
+    SERVICE_ID,
+    AuthCallbackHandler,
+    clear_tokens,
+    get_auth_token,
+)
+
+console = Console()
+
+# HTTP request timeout (30 seconds)
+HTTP_TIMEOUT = 30.0
+
+
+@click.group()
+def auth():
+    """Authentication commands (login, logout, whoami)."""
+    pass
+
+
+@retry(
+    stop=stop_after_attempt(3),
+    wait=wait_exponential(multiplier=1, min=2, max=10),
+    retry=retry_if_exception_type((httpx.TimeoutException, httpx.NetworkError)),
+    reraise=True,
+)
+def _exchange_code_for_tokens_with_retry(code: str, code_verifier: str, redirect_uri: str) -> dict:
+    """
+    Exchange authorization code for tokens with retry logic.
+
+    Returns token data dictionary.
+    """
+    with httpx.Client(timeout=HTTP_TIMEOUT) as client:
+        response = client.post(
+            f"{API_BASE_URL}/auth/token",
+            data={
+                "grant_type": "authorization_code",
+                "client_id": CLI_CLIENT_ID,
+                "code": code,
+                "code_verifier": code_verifier,
+                "redirect_uri": redirect_uri,
+            },
+            headers={"Accept": "application/json"},
+        )
+        response.raise_for_status()
+
+        # Safe JSON parsing with content-type check
+        content_type = response.headers.get("content-type", "")
+        if "application/json" not in content_type:
+            raise ValueError(f"Expected JSON response, got {content_type}")
+
+        try:
+            token_data = response.json()
+        except (ValueError, TypeError) as e:
+            raise ValueError(f"Failed to parse JSON response: {e}")
+
+        return token_data
+
+
+@auth.command()
+def login():
+    """Login to Xenfra using Device Authorization Flow (like GitHub CLI, Claude Code)."""
+    from .auth_device import device_login
+    device_login()
+
+    # Removed old PKCE flow - now using Device Authorization Flow
+
+
+@auth.command()
+def logout():
+    """Logout and clear stored tokens."""
+    try:
+        clear_tokens()
+        console.print("[bold green]Logged out successfully.[/bold green]")
+    except Exception as e:
+        console.print(f"[yellow]Warning: Error during logout: {e}[/yellow]")
+        console.print("[dim]Tokens may still be stored in keyring.[/dim]")
+
+
+@auth.command()
+@click.option("--token", is_flag=True, help="Show access token")
+def whoami(token):
+    """Show current authenticated user."""
+    access_token = get_auth_token()
+
+    if not access_token:
+        console.print("[bold red]Not logged in. Run 'xenfra login' first.[/bold red]")
+        return
+
+    try:
+        import base64
+        import json
+
+        # Manually decode JWT payload without verification
+        # JWT format: header.payload.signature
+        parts = access_token.split(".")
+        if len(parts) != 3:
+            console.print("[bold red]Invalid token format[/bold red]")
+            return
+
+        # Decode payload (second part)
+        payload_b64 = parts[1]
+        # Add padding if needed
+        padding = 4 - len(payload_b64) % 4
+        if padding != 4:
+            payload_b64 += "=" * padding
+
+        payload_bytes = base64.urlsafe_b64decode(payload_b64)
+        claims = json.loads(payload_bytes)
+
+        console.print("[bold green]Logged in as:[/bold green]")
+        console.print(f"  Email: {claims.get('sub', 'N/A')}")
+        console.print(f"  User ID: {claims.get('user_id', 'N/A')}")
+
+        if token:
+            console.print(f"\n[dim]Access Token:[/dim]\n{access_token}")
+    except Exception as e:
+        console.print(f"[bold red]Failed to decode token: {e}[/bold red]")