xenfra 0.4.3__py3-none-any.whl → 0.4.4__py3-none-any.whl

xenfra/utils/validation.py

@@ -1,234 +1,234 @@
-"""
-Validation utilities for CLI commands.
-"""
-
-import re
-import uuid
-from typing import Optional
-from urllib.parse import urlparse
-
-
-def validate_deployment_id(deployment_id: str) -> tuple[bool, Optional[str]]:
-    """
-    Validate deployment ID format (UUID or positive integer).
-
-    Returns (is_valid, error_message).
-    """
-    if not deployment_id or not isinstance(deployment_id, str):
-        return False, "Deployment ID cannot be empty"
-
-    deployment_id = deployment_id.strip()
-
-    # Try UUID format first
-    try:
-        uuid.UUID(deployment_id)
-        return True, None
-    except ValueError:
-        pass
-
-    # Try positive integer
-    try:
-        if int(deployment_id) > 0:
-            return True, None
-    except ValueError:
-        pass
-
-    return False, "Deployment ID must be a valid UUID or positive integer"
-
-
-def validate_project_id(project_id: int) -> tuple[bool, Optional[str]]:
-    """
-    Validate project ID (must be positive integer).
-
-    Returns (is_valid, error_message).
-    """
-    if not isinstance(project_id, int):
-        return False, "Project ID must be an integer"
-
-    if project_id <= 0:
-        return False, "Project ID must be a positive integer"
-
-    return True, None
-
-
-def validate_git_repo_url(git_repo: str) -> tuple[bool, Optional[str]]:
-    """
-    Validate git repository URL format.
-
-    Returns (is_valid, error_message).
-    """
-    if not git_repo or not isinstance(git_repo, str):
-        return False, "Git repository URL cannot be empty"
-
-    git_repo = git_repo.strip()
-
-    if len(git_repo) > 2048:
-        return False, "Git repository URL is too long (max 2048 characters)"
-
-    try:
-        parsed = urlparse(git_repo)
-
-        # Must have scheme
-        if parsed.scheme not in ["http", "https", "git"]:
-            return False, "Git repository URL must use http, https, or git scheme"
-
-        # Must have hostname
-        if not parsed.hostname:
-            return False, "Git repository URL must have a hostname"
-
-        # Common git hosting patterns
-        if not any(
-            domain in parsed.hostname.lower()
-            for domain in ["github.com", "gitlab.com", "bitbucket.org", "gitea.com"]
-        ):
-            # Allow custom domains but warn
-            pass
-
-        return True, None
-
-    except Exception as e:
-        return False, f"Invalid git repository URL format: {e}"
-
-
-def validate_project_name(project_name: str) -> tuple[bool, Optional[str]]:
-    """
-    Validate project name format.
-
-    Returns (is_valid, error_message).
-    """
-    if not project_name or not isinstance(project_name, str):
-        return False, "Project name cannot be empty"
-
-    project_name = project_name.strip()
-
-    if len(project_name) > 100:
-        return False, "Project name is too long (max 100 characters)"
-
-    if len(project_name) < 1:
-        return False, "Project name is too short (min 1 character)"
-
-    # Alphanumeric, hyphens, underscores, dots
-    if not re.match(r"^[a-zA-Z0-9._-]+$", project_name):
-        return (
-            False,
-            "Project name can only contain alphanumeric characters, dots, hyphens, and underscores",
-        )
-
-    # Reserved names
-    reserved_names = ["admin", "api", "www", "root", "system", "xenfra"]
-    if project_name.lower() in reserved_names:
-        return False, f"Project name '{project_name}' is reserved"
-
-    return True, None
-
-
-def validate_branch_name(branch: str) -> tuple[bool, Optional[str]]:
-    """
-    Validate git branch name format.
-
-    Returns (is_valid, error_message).
-    """
-    if not branch or not isinstance(branch, str):
-        return False, "Branch name cannot be empty"
-
-    branch = branch.strip()
-
-    if len(branch) > 255:
-        return False, "Branch name is too long (max 255 characters)"
-
-    # Git branch name rules: no spaces, no special chars except /, -, _
-    if not re.match(r"^[a-zA-Z0-9/._-]+$", branch):
-        return (
-            False,
-            "Branch name can only contain alphanumeric characters, slashes, dots, hyphens, and underscores",
-        )
-
-    # Cannot start with . or end with .lock
-    if branch.startswith(".") or branch.endswith(".lock"):
-        return False, "Branch name cannot start with '.' or end with '.lock'"
-
-    return True, None
-
-
-def validate_framework(framework: str) -> tuple[bool, Optional[str]]:
-    """
-    Validate framework name.
-
-    Returns (is_valid, error_message).
-    """
-    if not framework or not isinstance(framework, str):
-        return False, "Framework cannot be empty"
-
-    framework = framework.strip().lower()
-
-    allowed_frameworks = ["fastapi", "flask", "django", "other"]
-    if framework not in allowed_frameworks:
-        return False, f"Framework must be one of: {', '.join(allowed_frameworks)}"
-
-    return True, None
-
-
-def validate_port(port: int) -> tuple[bool, Optional[str]]:
-    """
-    Validate port number.
-
-    Returns (is_valid, error_message).
-    """
-    if not isinstance(port, int):
-        return False, "Port must be an integer"
-
-    if port < 1 or port > 65535:
-        return False, "Port must be between 1 and 65535"
-
-    return True, None
-
-
-def validate_region(region: str) -> tuple[bool, Optional[str]]:
-    """
-    Validate DigitalOcean region.
-
-    Returns (is_valid, error_message).
-    """
-    if not region or not isinstance(region, str):
-        return False, "Region cannot be empty"
-
-    region = region.strip().lower()
-
-    # Common DigitalOcean regions (not exhaustive, but validates format)
-    if not re.match(r"^[a-z]{3}[0-9]$", region):
-        return False, "Region must be in format 'xxx1' (e.g., 'nyc3', 'sfo3')"
-
-    return True, None
-
-
-def validate_size_slug(size_slug: str) -> tuple[bool, Optional[str]]:
-    """
-    Validate DigitalOcean size slug.
-
-    Returns (is_valid, error_message).
-    """
-    if not size_slug or not isinstance(size_slug, str):
-        return False, "Size slug cannot be empty"
-
-    size_slug = size_slug.strip().lower()
-
-    # DigitalOcean size slug format: s-{vcpu}vcpu-{ram}gb
-    if not re.match(r"^s-[0-9]+vcpu-[0-9]+gb$", size_slug):
-        return False, "Size slug must be in format 's-Xvcpu-Ygb' (e.g., 's-1vcpu-1gb')"
-
-    return True, None
-
-
-def validate_codebase_scan_limits(max_files: int, max_size: int) -> tuple[bool, Optional[str]]:
-    """
-    Validate codebase scan limits.
-
-    Returns (is_valid, error_message).
-    """
-    if not isinstance(max_files, int) or max_files < 1 or max_files > 100:
-        return False, "max_files must be between 1 and 100"
-
-    if not isinstance(max_size, int) or max_size < 1024 or max_size > 10 * 1024 * 1024:
-        return False, "max_size must be between 1KB and 10MB"
-
-    return True, None
+"""
+Validation utilities for CLI commands.
+"""
+
+import re
+import uuid
+from typing import Optional
+from urllib.parse import urlparse
+
+
+def validate_deployment_id(deployment_id: str) -> tuple[bool, Optional[str]]:
+    """
+    Validate deployment ID format (UUID or positive integer).
+
+    Returns (is_valid, error_message).
+    """
+    if not deployment_id or not isinstance(deployment_id, str):
+        return False, "Deployment ID cannot be empty"
+
+    deployment_id = deployment_id.strip()
+
+    # Try UUID format first
+    try:
+        uuid.UUID(deployment_id)
+        return True, None
+    except ValueError:
+        pass
+
+    # Try positive integer
+    try:
+        if int(deployment_id) > 0:
+            return True, None
+    except ValueError:
+        pass
+
+    return False, "Deployment ID must be a valid UUID or positive integer"
+
+
+def validate_project_id(project_id: int) -> tuple[bool, Optional[str]]:
+    """
+    Validate project ID (must be positive integer).
+
+    Returns (is_valid, error_message).
+    """
+    if not isinstance(project_id, int):
+        return False, "Project ID must be an integer"
+
+    if project_id <= 0:
+        return False, "Project ID must be a positive integer"
+
+    return True, None
+
+
+def validate_git_repo_url(git_repo: str) -> tuple[bool, Optional[str]]:
+    """
+    Validate git repository URL format.
+
+    Returns (is_valid, error_message).
+    """
+    if not git_repo or not isinstance(git_repo, str):
+        return False, "Git repository URL cannot be empty"
+
+    git_repo = git_repo.strip()
+
+    if len(git_repo) > 2048:
+        return False, "Git repository URL is too long (max 2048 characters)"
+
+    try:
+        parsed = urlparse(git_repo)
+
+        # Must have scheme
+        if parsed.scheme not in ["http", "https", "git"]:
+            return False, "Git repository URL must use http, https, or git scheme"
+
+        # Must have hostname
+        if not parsed.hostname:
+            return False, "Git repository URL must have a hostname"
+
+        # Common git hosting patterns
+        if not any(
+            domain in parsed.hostname.lower()
+            for domain in ["github.com", "gitlab.com", "bitbucket.org", "gitea.com"]
+        ):
+            # Allow custom domains but warn
+            pass
+
+        return True, None
+
+    except Exception as e:
+        return False, f"Invalid git repository URL format: {e}"
+
+
+def validate_project_name(project_name: str) -> tuple[bool, Optional[str]]:
+    """
+    Validate project name format.
+
+    Returns (is_valid, error_message).
+    """
+    if not project_name or not isinstance(project_name, str):
+        return False, "Project name cannot be empty"
+
+    project_name = project_name.strip()
+
+    if len(project_name) > 100:
+        return False, "Project name is too long (max 100 characters)"
+
+    if len(project_name) < 1:
+        return False, "Project name is too short (min 1 character)"
+
+    # Alphanumeric, hyphens, underscores, dots
+    if not re.match(r"^[a-zA-Z0-9._-]+$", project_name):
+        return (
+            False,
+            "Project name can only contain alphanumeric characters, dots, hyphens, and underscores",
+        )
+
+    # Reserved names
+    reserved_names = ["admin", "api", "www", "root", "system", "xenfra"]
+    if project_name.lower() in reserved_names:
+        return False, f"Project name '{project_name}' is reserved"
+
+    return True, None
+
+
+def validate_branch_name(branch: str) -> tuple[bool, Optional[str]]:
+    """
+    Validate git branch name format.
+
+    Returns (is_valid, error_message).
+    """
+    if not branch or not isinstance(branch, str):
+        return False, "Branch name cannot be empty"
+
+    branch = branch.strip()
+
+    if len(branch) > 255:
+        return False, "Branch name is too long (max 255 characters)"
+
+    # Git branch name rules: no spaces, no special chars except /, -, _
+    if not re.match(r"^[a-zA-Z0-9/._-]+$", branch):
+        return (
+            False,
+            "Branch name can only contain alphanumeric characters, slashes, dots, hyphens, and underscores",
+        )
+
+    # Cannot start with . or end with .lock
+    if branch.startswith(".") or branch.endswith(".lock"):
+        return False, "Branch name cannot start with '.' or end with '.lock'"
+
+    return True, None
+
+
+def validate_framework(framework: str) -> tuple[bool, Optional[str]]:
+    """
+    Validate framework name.
+
+    Returns (is_valid, error_message).
+    """
+    if not framework or not isinstance(framework, str):
+        return False, "Framework cannot be empty"
+
+    framework = framework.strip().lower()
+
+    allowed_frameworks = ["fastapi", "flask", "django", "other"]
+    if framework not in allowed_frameworks:
+        return False, f"Framework must be one of: {', '.join(allowed_frameworks)}"
+
+    return True, None
+
+
+def validate_port(port: int) -> tuple[bool, Optional[str]]:
+    """
+    Validate port number.
+
+    Returns (is_valid, error_message).
+    """
+    if not isinstance(port, int):
+        return False, "Port must be an integer"
+
+    if port < 1 or port > 65535:
+        return False, "Port must be between 1 and 65535"
+
+    return True, None
+
+
+def validate_region(region: str) -> tuple[bool, Optional[str]]:
+    """
+    Validate DigitalOcean region.
+
+    Returns (is_valid, error_message).
+    """
+    if not region or not isinstance(region, str):
+        return False, "Region cannot be empty"
+
+    region = region.strip().lower()
+
+    # Common DigitalOcean regions (not exhaustive, but validates format)
+    if not re.match(r"^[a-z]{3}[0-9]$", region):
+        return False, "Region must be in format 'xxx1' (e.g., 'nyc3', 'sfo3')"
+
+    return True, None
+
+
+def validate_size_slug(size_slug: str) -> tuple[bool, Optional[str]]:
+    """
+    Validate DigitalOcean size slug.
+
+    Returns (is_valid, error_message).
+    """
+    if not size_slug or not isinstance(size_slug, str):
+        return False, "Size slug cannot be empty"
+
+    size_slug = size_slug.strip().lower()
+
+    # DigitalOcean size slug format: s-{vcpu}vcpu-{ram}gb
+    if not re.match(r"^s-[0-9]+vcpu-[0-9]+gb$", size_slug):
+        return False, "Size slug must be in format 's-Xvcpu-Ygb' (e.g., 's-1vcpu-1gb')"
+
+    return True, None
+
+
+def validate_codebase_scan_limits(max_files: int, max_size: int) -> tuple[bool, Optional[str]]:
+    """
+    Validate codebase scan limits.
+
+    Returns (is_valid, error_message).
+    """
+    if not isinstance(max_files, int) or max_files < 1 or max_files > 100:
+        return False, "max_files must be between 1 and 100"
+
+    if not isinstance(max_size, int) or max_size < 1024 or max_size > 10 * 1024 * 1024:
+        return False, "max_size must be between 1KB and 10MB"
+
+    return True, None

xenfra-0.4.4.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,21 @@
+xenfra/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xenfra/commands/__init__.py,sha256=bdugTOErbWUhDvnwFl17KkGPPV7gtmDkSOzhF_NEHX0,40
+xenfra/commands/auth.py,sha256=_KzQpdYx-9V1cd5gCC__UGgCOzCl7wjPZvzgkeuCqTw,4034
+xenfra/commands/auth_device.py,sha256=Z9bCK6TzDD5Tzl14dl-oDtLy6Klrk-PAsmfww74XPXg,6546
+xenfra/commands/deployments.py,sha256=2jfgYItrryR__y5BzFdlE9xBcFo9HXQKwzpJO0vVc58,49792
+xenfra/commands/intelligence.py,sha256=9s2CgnPha7lbyLG3URE4EswL_b84nFxogueoxHoO41o,21684
+xenfra/commands/projects.py,sha256=O2tG--iDWN5oCcHOv1jp88kl9bAK61oGRCLJ60M0b7E,6492
+xenfra/commands/security_cmd.py,sha256=MJxbjQksKrtRn21FSAhTY3ESn_S_tUCGfdNRWL7kNsc,7094
+xenfra/main.py,sha256=TWr0Ir6m9nlpkbJLh22g1KOfG_t6BQFnpWgeQK_Hkxs,1990
+xenfra/utils/__init__.py,sha256=57o8j7Tibrhyid84zTFLHjFmRP5sCnNbtLEfpRqIpMk,42
+xenfra/utils/auth.py,sha256=bMzjZt92eenVmZFSyURPe0KTu52kxnNc0ORlY0nuTwE,13395
+xenfra/utils/codebase.py,sha256=s5oWg1uToQ_B8lzQ7heVhqzWWoPye5flwa2zAq8OvDo,5780
+xenfra/utils/config.py,sha256=eirrFYYy9vRCftfGvODJI8hQp7xEvPHhHazKuOGS2us,16144
+xenfra/utils/errors.py,sha256=x0DKEfx9BXhlt48RKk5zg4-OFmB-yzRpOnH0NJtTN6c,4095
+xenfra/utils/file_sync.py,sha256=P4hCsndU10molrjhNfojE2FeFx3NT3G2_XoeKYmpvzc,7647
+xenfra/utils/security.py,sha256=V0CqA47ZYt-8AesWb7FPRzzygqEY_g2WF1Duvs5BZ_Y,11143
+xenfra/utils/validation.py,sha256=6mGC5CqAbx-CBp06omWLBpKjnEWXsEzlYWq71wjDeX8,6678
+xenfra-0.4.4.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
+xenfra-0.4.4.dist-info/entry_points.txt,sha256=a_2cGhYK__X6eW05Ba8uB6RIM_61c2sHtXsPY8N0mic,45
+xenfra-0.4.4.dist-info/METADATA,sha256=Kfjav54itPcVq9gA5GlDvdjjFy2isDW0PzpmAOWVdK4,3811
+xenfra-0.4.4.dist-info/RECORD,,