xenfra 0.4.3__tar.gz → 0.4.5__tar.gz

xenfra-0.4.5/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.3
+Name: xenfra
+Version: 0.4.5
+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.5/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.5}/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.5"
+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",
+]
+
+requires-python = ">=3.11"
+
+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",
+]
+
+[project.optional-dependencies]
+test = [
+    "pytest>=8.0.0",
+    "pytest-mock>=3.12.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/xenfra-cloud/xenfra-cli"
+Issues = "https://github.com/xenfra-cloud/xenfra-cli/issues"
+
+[project.scripts]
+xenfra = "xenfra.main:main"
+
+[build-system]
+requires = ["uv_build>=0.9.18,<0.10.0"]
+build-backend = "uv_build"

xenfra-0.4.5/src/xenfra/blueprints/__init__.py

@@ -0,0 +1,55 @@
+"""
+Blueprint factory for framework detection and build plan generation.
+
+Implements Railpack-first routing with 3-tier dry-run validation:
+- Tier 1: Local validation (~100ms) - Syntax, imports, config
+- Tier 2: Railpack plan (~1-2s) - Build plan generation  
+- Tier 3: E2B Sandbox (~30-60s) - Full build validation via Xenfra API
+
+Tier 3 runs on Xenfra's servers - users don't need E2B installed.
+
+Environment Variables:
+- XENFRA_AI=off: Disable all AI features
+- XENFRA_SANDBOX=force: Always run Tier 3 validation
+- XENFRA_SANDBOX=skip: Skip Tier 3 validation  
+- XENFRA_SANDBOX=auto: Smart detection (default)
+"""
+
+from .base import Blueprint, BuildPlan
+from .factory import BlueprintFactory, get_factory, detect_project
+from .railpack import RailpackBlueprint
+from .dry_run import (
+    DryRunEngine,
+    DryRunResult,
+    run_dry_run,
+    quick_validate,
+)
+from .validation import ValidationResult, validate_project
+from .e2b import E2BSandbox, SandboxResult, get_sandbox
+
+__all__ = [
+    # Base classes
+    "Blueprint",
+    "BuildPlan",
+    
+    # Factory
+    "BlueprintFactory",
+    "get_factory",
+    "detect_project",
+    "RailpackBlueprint",
+    
+    # 3-Tier Dry Run
+    "DryRunEngine",
+    "DryRunResult",
+    "run_dry_run",
+    "quick_validate",
+    
+    # Tier 1
+    "ValidationResult",
+    "validate_project",
+    
+    # Tier 3
+    "E2BSandbox",
+    "SandboxResult",
+    "get_sandbox",
+]

xenfra-0.4.5/src/xenfra/blueprints/base.py

@@ -0,0 +1,85 @@
+"""
+Base blueprint interface for build plan generation.
+"""
+
+from abc import ABC, abstractmethod
+from dataclasses import dataclass, field
+from typing import Optional
+from pathlib import Path
+
+
+@dataclass
+class BuildPlan:
+    """A build plan containing all information needed to build and deploy."""
+    
+    framework: str
+    language: str
+    package_manager: str
+    dependency_file: str
+    build_command: Optional[str] = None
+    start_command: Optional[str] = None
+    port: int = 8000
+    dockerfile: Optional[str] = None
+    env_vars: dict = field(default_factory=dict)
+    detected_from: str = "unknown"  # How the framework was detected
+    
+    def to_dict(self) -> dict:
+        """Convert build plan to dictionary."""
+        return {
+            "framework": self.framework,
+            "language": self.language,
+            "package_manager": self.package_manager,
+            "dependency_file": self.dependency_file,
+            "build_command": self.build_command,
+            "start_command": self.start_command,
+            "port": self.port,
+            "dockerfile": self.dockerfile,
+            "env_vars": self.env_vars,
+            "detected_from": self.detected_from,
+        }
+
+
+class Blueprint(ABC):
+    """
+    Abstract base class for deployment blueprints.
+    
+    Blueprints analyze project structure and generate build plans.
+    """
+    
+    name: str = "base"
+    languages: list[str] = []
+    
+    @abstractmethod
+    def detect(self, project_path: Path) -> bool:
+        """
+        Detect if this blueprint applies to the given project.
+        
+        Args:
+            project_path: Path to the project directory
+            
+        Returns:
+            True if this blueprint can handle the project
+        """
+        pass
+    
+    @abstractmethod
+    def generate_plan(self, project_path: Path) -> BuildPlan:
+        """
+        Generate a build plan for the project.
+        
+        Args:
+            project_path: Path to the project directory
+            
+        Returns:
+            BuildPlan with all build/deployment information
+        """
+        pass
+    
+    def get_priority(self) -> int:
+        """
+        Get the priority of this blueprint (higher = tried first).
+        
+        Returns:
+            Priority integer
+        """
+        return 100