xenfra 0.2.8__py3-none-any.whl → 0.3.0__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.2.8.dist-info → xenfra-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: xenfra
-Version: 0.2.8
+Version: 0.3.0
 Summary: A 'Zen Mode' infrastructure engine for Python developers.
 Author: xenfra-cloud
 Author-email: xenfra-cloud <xenfracloud@gmail.com>
@@ -31,86 +31,86 @@ Project-URL: Issues, https://github.com/xenfra-cloud/xenfra/issues
 Provides-Extra: test
 Description-Content-Type: text/markdown
 
-# Xenfra CLI
-
-## Xenfra CLI: Deploy Python Apps with Zen Mode
-
-The Xenfra CLI is a powerful and intuitive command-line interface designed to streamline the deployment of Python applications to DigitalOcean. Built with a "Zen Mode" philosophy, it automates complex infrastructure tasks, allowing developers to focus on writing code.
-
-### ✨ Key Features
-
-- **Zero-Configuration Deployment:** Automatically detects your project's framework and dependencies.
-- **AI-Powered Auto-Healing:** Diagnoses common deployment failures and suggests, or even applies, fixes automatically.
-- **Real-time Monitoring:** View deployment status and stream live application logs directly from your terminal.
-- **Integrated Project Management:** Easily list, view, and destroy your deployed projects.
-- **Secure Authentication:** Uses OAuth2 PKCE flow for secure, token-based authentication.
-
-### 🚀 Quickstart
-
-#### 1. Installation
-
-Install the Xenfra CLI using `uv` (recommended) or `pip`:
-
-```bash
-uv pip install xenfra-cli
-# or
-pip install xenfra-cli
-```
-
-#### 2. Authentication
-
-Log in to your Xenfra account. This will open your web browser to complete the OAuth2 flow.
-
-```bash
-xenfra auth login
-```
-
-#### 3. Initialize Your Project
-
-Navigate to your Python project's root directory and run `init`. The CLI will scan your codebase, detect its characteristics, and generate a `xenfra.yaml` configuration file.
-
-```bash
-cd your-python-project/
-xenfra init
-```
-
-#### 4. Deploy Your Application
-
-Once `xenfra.yaml` is configured, deploy your application. The CLI will handle provisioning a DigitalOcean Droplet, setting up Docker, and deploying your code.
-
-```bash
-xenfra deploy
-```
-
-### 📋 Usage Examples
-
-- **Monitor Deployment Status:**
-  ```bash
-  xenfra status <deployment-id>
-  ```
-- **Stream Application Logs:**
-  ```bash
-  xenfra logs <deployment-id>
-  ```
-- **List Deployed Projects:**
-  ```bash
-  xenfra projects list
-  ```
-- **Diagnose a Failed Deployment (AI-Powered):**
-  ```bash
-  xenfra diagnose <deployment-id>
-  # Or to diagnose from a log file:
-  xenfra diagnose --logs error.log
-  ```
-
-### 📚 Documentation
-
-For more detailed information, advanced configurations, and API references, please refer to the [official Xenfra Documentation](https://docs.xenfra.tech/cli) (Link will be updated upon final deployment).
-
-### 🤝 Contributing
-
-We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for more details.
-
-### 📄 License
-
-This project is licensed under the [MIT License](LICENSE).
+# Xenfra CLI
+
+## Xenfra CLI: Deploy Python Apps with Zen Mode
+
+The Xenfra CLI is a powerful and intuitive command-line interface designed to streamline the deployment of Python applications to DigitalOcean. Built with a "Zen Mode" philosophy, it automates complex infrastructure tasks, allowing developers to focus on writing code.
+
+### ✨ Key Features
+
+- **Zero-Configuration Deployment:** Automatically detects your project's framework and dependencies.
+- **AI-Powered Auto-Healing:** Diagnoses common deployment failures and suggests, or even applies, fixes automatically.
+- **Real-time Monitoring:** View deployment status and stream live application logs directly from your terminal.
+- **Integrated Project Management:** Easily list, view, and destroy your deployed projects.
+- **Secure Authentication:** Uses OAuth2 PKCE flow for secure, token-based authentication.
+
+### 🚀 Quickstart
+
+#### 1. Installation
+
+Install the Xenfra CLI using `uv` (recommended) or `pip`:
+
+```bash
+uv pip install xenfra-cli
+# or
+pip install xenfra-cli
+```
+
+#### 2. Authentication
+
+Log in to your Xenfra account. This will open your web browser to complete the OAuth2 flow.
+
+```bash
+xenfra auth login
+```
+
+#### 3. Initialize Your Project
+
+Navigate to your Python project's root directory and run `init`. The CLI will scan your codebase, detect its characteristics, and generate a `xenfra.yaml` configuration file.
+
+```bash
+cd your-python-project/
+xenfra init
+```
+
+#### 4. Deploy Your Application
+
+Once `xenfra.yaml` is configured, deploy your application. The CLI will handle provisioning a DigitalOcean Droplet, setting up Docker, and deploying your code.
+
+```bash
+xenfra deploy
+```
+
+### 📋 Usage Examples
+
+- **Monitor Deployment Status:**
+  ```bash
+  xenfra status <deployment-id>
+  ```
+- **Stream Application Logs:**
+  ```bash
+  xenfra logs <deployment-id>
+  ```
+- **List Deployed Projects:**
+  ```bash
+  xenfra projects list
+  ```
+- **Diagnose a Failed Deployment (AI-Powered):**
+  ```bash
+  xenfra diagnose <deployment-id>
+  # Or to diagnose from a log file:
+  xenfra diagnose --logs error.log
+  ```
+
+### 📚 Documentation
+
+For more detailed information, advanced configurations, and API references, please refer to the [official Xenfra Documentation](https://docs.xenfra.tech/cli) (Link will be updated upon final deployment).
+
+### 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for more details.
+
+### 📄 License
+
+This project is licensed under the [MIT License](LICENSE).

xenfra-0.3.0.dist-info/RECORD

@@ -0,0 +1,19 @@
+xenfra/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xenfra/commands/__init__.py,sha256=kTTwVnTvoxikyPUhQiyTAbnw4PYafktuE1----TqQoA,43
+xenfra/commands/auth.py,sha256=UMtaIPsBqrVoYDmXkbQZoeEQrPyf6vHQmgPFS4PGwYQ,4109
+xenfra/commands/auth_device.py,sha256=BfSjyoOHgvfPH69QdD4fF_VdCktS99z2k7UGFPClWls,6364
+xenfra/commands/deployments.py,sha256=bI6d9lVYPhCDoQE3nke7s80MUQ75ILPqiEGhcbXDExo,28609
+xenfra/commands/intelligence.py,sha256=1lw1Pw6deyC52JmpK8YAVFuydAC7cvg_2qiRnw8B8Yc,13884
+xenfra/commands/projects.py,sha256=SAxF_pOr95K6uz35U-zENptKndKxJNZn6bcD45PHcpI,6696
+xenfra/commands/security_cmd.py,sha256=EI5sjX2lcMxgMH-LCFmPVkc9YqadOrcoSgTiKknkVRY,7327
+xenfra/main.py,sha256=2EPPuIdxjhW-I-e-Mc0i2ayeLaSJdmzddNThkXq7B7c,2033
+xenfra/utils/__init__.py,sha256=4ZRYkrb--vzoXjBHG8zRxz2jCXNGtAoKNtkyu2WRI2A,45
+xenfra/utils/auth.py,sha256=L6fDwYbvDhZ7gky68GxNEMHGxdi-k1kzFvjDSe-uqI4,9092
+xenfra/utils/codebase.py,sha256=57GthXOvOQnUHiDwIHqxK6hNUGWlWf6Nfs3T8647Wrc,4144
+xenfra/utils/config.py,sha256=F2zedd3JXP7TBdul0u8b4NVx-C1N6Hq4sH5szyWim6M,11947
+xenfra/utils/security.py,sha256=EA8CIPLt8Y-QP5uZ7c5NuC6ZLRV1aZS8NapS9ix_vok,11479
+xenfra/utils/validation.py,sha256=cvuL_AEFJ2oCoP0abCqoOIABOwz79Gkf-jh_dcFIQlM,6912
+xenfra-0.3.0.dist-info/WHEEL,sha256=RRVLqVugUmFOqBedBFAmA4bsgFcROUBiSUKlERi0Hcg,79
+xenfra-0.3.0.dist-info/entry_points.txt,sha256=a_2cGhYK__X6eW05Ba8uB6RIM_61c2sHtXsPY8N0mic,45
+xenfra-0.3.0.dist-info/METADATA,sha256=kA5doOVqpnopHTMwGnBbOS8CJ8xhg77_prwocC609j8,3834
+xenfra-0.3.0.dist-info/RECORD,,

{xenfra-0.2.8.dist-info → xenfra-0.3.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.9.18
+Generator: uv 0.9.21
 Root-Is-Purelib: true
 Tag: py3-none-any