xenfra 0.2.3__py3-none-any.whl → 0.2.5__py3-none-any.whl

xenfra/utils/validation.py

@@ -0,0 +1,229 @@
+"""
+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.3.dist-info → xenfra-0.2.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: xenfra
-Version: 0.2.3
+Version: 0.2.5
 Summary: A 'Zen Mode' infrastructure engine for Python developers.
 Author: xenfra-cloud
 Author-email: xenfra-cloud <xenfracloud@gmail.com>
@@ -22,6 +22,7 @@ Requires-Dist: xenfra-sdk
 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: pytest>=8.0.0 ; extra == 'test'
 Requires-Dist: pytest-mock>=3.12.0 ; extra == 'test'
 Requires-Python: >=3.13
@@ -38,11 +39,11 @@ The Xenfra CLI is a powerful and intuitive command-line interface designed to st
 
 ### ✨ 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.
+- **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
 
@@ -83,28 +84,28 @@ 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
-    ```
+- **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.com/cli) (Link will be updated upon final deployment).
+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
 

xenfra-0.2.5.dist-info/RECORD

@@ -0,0 +1,18 @@
+xenfra/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xenfra/commands/__init__.py,sha256=bdugTOErbWUhDvnwFl17KkGPPV7gtmDkSOzhF_NEHX0,40
+xenfra/commands/auth.py,sha256=tG49BfzzivnE9ZN3QmVCZywOEhW6Ab1wgVxnTqTRnnQ,10114
+xenfra/commands/deployments.py,sha256=-185BevHVrUT-LAU2k_uZNpKJPCcwpCDEHOFPfD0Wmw,19348
+xenfra/commands/intelligence.py,sha256=w8GxwGu63KQ5fwhPpTNTDeW1Xg5g3aFzzIBuP_CeRQo,13541
+xenfra/commands/projects.py,sha256=O2tG--iDWN5oCcHOv1jp88kl9bAK61oGRCLJ60M0b7E,6492
+xenfra/commands/security_cmd.py,sha256=MJxbjQksKrtRn21FSAhTY3ESn_S_tUCGfdNRWL7kNsc,7094
+xenfra/main.py,sha256=bv6EslYtRMXShmHfcSuzecNjJWbCvPCi2LKI4kwL_oQ,1790
+xenfra/utils/__init__.py,sha256=57o8j7Tibrhyid84zTFLHjFmRP5sCnNbtLEfpRqIpMk,42
+xenfra/utils/auth.py,sha256=UIWx8m7I9Qm4UiKP8g7hCiVAXgkKo1JfSl4twChXkSA,8308
+xenfra/utils/codebase.py,sha256=Gw3e6N-8WfbBeDEMrTD9j3CGPFFJFgorwHXAmZ93vbw,4016
+xenfra/utils/config.py,sha256=EFmk6DVOIaskon6yWlYSWyveDYuG_zC587P1akllKjc,11336
+xenfra/utils/security.py,sha256=5_rE3hYMTfUzZ05XEoJwMQfQFZGElpw7wc_WbcpzW5M,11894
+xenfra/utils/validation.py,sha256=AslcMtdXFjXVdmCwjKWHhnlCW6g1QyTTj3wP7s1_bZU,6605
+xenfra-0.2.5.dist-info/WHEEL,sha256=ZyFSCYkV2BrxH6-HRVRg3R9Fo7MALzer9KiPYqNxSbo,79
+xenfra-0.2.5.dist-info/entry_points.txt,sha256=a_2cGhYK__X6eW05Ba8uB6RIM_61c2sHtXsPY8N0mic,45
+xenfra-0.2.5.dist-info/METADATA,sha256=C9Ns60_5AA99ATsa_-ljs1M9gNT2FcsfGyHgt05mSBU,3751
+xenfra-0.2.5.dist-info/RECORD,,

xenfra-0.2.5.dist-info/entry_points.txt

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

xenfra-0.2.3.dist-info/RECORD

@@ -1,17 +0,0 @@
-xenfra/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xenfra/commands/__init__.py,sha256=bdugTOErbWUhDvnwFl17KkGPPV7gtmDkSOzhF_NEHX0,40
-xenfra/commands/auth.py,sha256=oiEt7RJqAa-_b-FCTgS_I2VyaQqoiGENhXM88tLCFhg,6080
-xenfra/commands/deployments.py,sha256=38JcmHnDfS04feYheMd9IwBIZmDafsjognJ26MCQIU4,17812
-xenfra/commands/intelligence.py,sha256=Pf9fbR1EY8IROoXJZYIASUtnSVvZCUW35zN2YeaCyZM,12933
-xenfra/commands/projects.py,sha256=nkE-T43M1gqiKar597H33tWFg5hwFx-oxfn-t9afxa0,5259
-xenfra/commands/security_cmd.py,sha256=j_VDpis0LEGS-ug9cYZ_MG33ToHrDFzoLG3SOoYS1Uk,7117
-xenfra/main.py,sha256=muanV6chEYzLi0CW9aF2a5Ibok2CosuyVGY9HSq6Uso,1789
-xenfra/utils/__init__.py,sha256=57o8j7Tibrhyid84zTFLHjFmRP5sCnNbtLEfpRqIpMk,42
-xenfra/utils/auth.py,sha256=qM6g8CW1ddSlfEa7Bw5OZEqqUxmgq4zdQFpqS5CVzXw,5440
-xenfra/utils/codebase.py,sha256=lA10QL6uitmO79y8YvoY4t22e_ff8AG7iBizygOUY4c,2773
-xenfra/utils/config.py,sha256=aC4d4t4yDXRW5x-fgjOND6VeiYue8VnKkKNtvxp_j_c,8377
-xenfra/utils/security.py,sha256=jI62NtIiHkgX6D11B-MysbiI9pbO_VpUtjb5nBufHpo,11911
-xenfra-0.2.3.dist-info/WHEEL,sha256=ZyFSCYkV2BrxH6-HRVRg3R9Fo7MALzer9KiPYqNxSbo,79
-xenfra-0.2.3.dist-info/entry_points.txt,sha256=nQh9YxZW6LGpQ-B5yGxmC-g9RlHYcmjeSM2NhI5na3M,49
-xenfra-0.2.3.dist-info/METADATA,sha256=YuRvaIthyaJkqNFlwbrnAYjvF8L8jxZB8gWcz3anopk,3765
-xenfra-0.2.3.dist-info/RECORD,,

xenfra-0.2.3.dist-info/entry_points.txt

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