hud-python 0.4.1__py3-none-any.whl → 0.4.3__py3-none-any.whl

hud/cli/clone.py

@@ -1,185 +1,185 @@
-"""Git clone wrapper with quiet mode and rich output.
-
-This module provides a CLI command that wraps 'git clone' to provide a better user experience:
-- Runs git clone quietly (no verbose output)
-- Displays a rich formatted success message
-- Shows optional tutorial/getting started messages from the cloned repository
-
-Usage:
-    hud clone https://github.com/user/repo.git
-
-The clone command will look for a [tool.hud.clone] section in the cloned repository's
-pyproject.toml file. If found, it will display the configured message after cloning.
-
-Configuration in pyproject.toml:
-    [tool.hud.clone]
-    title = "🚀 My Project"  # Optional title for the message panel
-    style = "blue"           # Optional border style (any Rich color)
-
-    # Option 1: Plain text message with Rich markup support
-    message = "[bold]Welcome![/bold] Run [cyan]pip install -e .[/cyan] to start."
-
-    # Option 2: Markdown formatted message
-    markdown = "## Welcome\\n\\nThis supports **markdown** formatting."
-
-    # Option 3: Step-by-step instructions
-    steps = [
-        "Install dependencies: [green]pip install -e .[/green]",
-        "Run tests: [green]pytest[/green]",
-        "Start coding!"
-    ]
-
-Rich Markup Examples:
-    - Colors: [red]text[/red], [green]text[/green], [blue]text[/blue], [cyan]text[/cyan]
-    - Styles: [bold]text[/bold], [italic]text[/italic], [underline]text[/underline]
-    - Combined: [bold cyan]text[/bold cyan]
-    - Background: [on red]text[/on red]
-    - Links: [link=https://example.com]clickable[/link]
-
-See Rich documentation for more markup options: https://rich.readthedocs.io/en/stable/markup.html
-"""
-
-from __future__ import annotations
-
-import logging
-import subprocess
-import tomllib
-from pathlib import Path
-from typing import Any
-
-from rich.console import Console
-from rich.markdown import Markdown
-from rich.panel import Panel
-from rich.text import Text
-
-logger = logging.getLogger(__name__)
-
-console = Console()
-
-
-def clone_repository(url: str) -> tuple[bool, str]:
-    """
-    Clone a git repository quietly and return status.
-
-    Args:
-        url: Git repository URL
-
-    Returns:
-        Tuple of (success, directory_path or error_message)
-    """
-    # Extract repo name from URL
-    repo_name = Path(url).stem
-    if repo_name.endswith(".git"):
-        repo_name = repo_name[:-4]
-
-    # Build git clone command (simple, no options)
-    cmd = ["git", "clone", "--quiet", url]
-
-    try:
-        # Run git clone with quiet flag
-        subprocess.run(  # noqa: S603
-            cmd,
-            capture_output=True,
-            text=True,
-            check=True,
-        )
-
-        # Get the absolute path of the cloned directory
-        clone_path = Path(repo_name).resolve()
-
-        return True, str(clone_path)
-
-    except subprocess.CalledProcessError as e:
-        error_msg = (
-            e.stderr.strip() if e.stderr else f"Git clone failed with exit code {e.returncode}"
-        )
-        return False, error_msg
-    except Exception as e:
-        return False, f"Unexpected error: {e!s}"
-
-
-def get_clone_message(clone_path: str) -> dict[str, Any] | None:
-    """
-    Look for a clone message configuration in the repository's pyproject.toml or .hud.toml.
-
-    Checks for:
-    1. [tool.hud.clone] section in pyproject.toml
-    2. [clone] section in .hud.toml
-
-    Args:
-        clone_path: Path to the cloned repository
-
-    Returns:
-        Dictionary with message configuration or None
-    """
-    repo_path = Path(clone_path)
-
-    # Check pyproject.toml first
-    pyproject_path = repo_path / "pyproject.toml"
-    if pyproject_path.exists():
-        try:
-            with open(pyproject_path, "rb") as f:
-                data = tomllib.load(f)
-                if "tool" in data and "hud" in data["tool"] and "clone" in data["tool"]["hud"]:
-                    return data["tool"]["hud"]["clone"]
-        except Exception:
-            logger.warning("Failed to load clone config from %s", pyproject_path)
-
-    # Check .hud.toml as fallback
-    hud_toml_path = repo_path / ".hud.toml"
-    if hud_toml_path.exists():
-        try:
-            with open(hud_toml_path, "rb") as f:
-                data = tomllib.load(f)
-                if "clone" in data:
-                    return data["clone"]
-        except Exception:
-            logger.warning("Failed to load clone config from %s", hud_toml_path)
-
-    return None
-
-
-def print_tutorial(clone_config: dict[str, Any] | None = None) -> None:
-    """Print a rich formatted success message with optional tutorial."""
-    # Display custom message if configured
-    if clone_config:
-        # Handle different message formats
-        if "message" in clone_config:
-            # Message with Rich markup support
-            console.print(
-                Panel(
-                    clone_config["message"],  # Rich will parse markup automatically
-                    title=clone_config.get("title", "📋 Getting Started"),
-                    border_style=clone_config.get("style", "blue"),
-                    padding=(1, 2),
-                )
-            )
-        elif "markdown" in clone_config:
-            # Markdown message
-            console.print(
-                Panel(
-                    Markdown(clone_config["markdown"]),
-                    title=clone_config.get("title", "📋 Getting Started"),
-                    border_style=clone_config.get("style", "blue"),
-                    padding=(1, 2),
-                )
-            )
-        elif "steps" in clone_config:
-            # Step-by-step instructions
-            title = clone_config.get("title", "📋 Getting Started")
-            console.print(f"\n[bold]{title}[/bold]\n")
-            for i, step in enumerate(clone_config["steps"], 1):
-                console.print(f"  {i}. {step}")
-            console.print()
-
-
-def print_error(error_msg: str) -> None:
-    """Print a rich formatted error message."""
-    console.print(
-        Panel(
-            Text(f"❌ {error_msg}", style="red"),
-            title="[bold red]Clone Failed[/bold red]",
-            border_style="red",
-            padding=(1, 2),
-        )
-    )
+"""Git clone wrapper with quiet mode and rich output.
+
+This module provides a CLI command that wraps 'git clone' to provide a better user experience:
+- Runs git clone quietly (no verbose output)
+- Displays a rich formatted success message
+- Shows optional tutorial/getting started messages from the cloned repository
+
+Usage:
+    hud clone https://github.com/user/repo.git
+
+The clone command will look for a [tool.hud.clone] section in the cloned repository's
+pyproject.toml file. If found, it will display the configured message after cloning.
+
+Configuration in pyproject.toml:
+    [tool.hud.clone]
+    title = "🚀 My Project"  # Optional title for the message panel
+    style = "blue"           # Optional border style (any Rich color)
+
+    # Option 1: Plain text message with Rich markup support
+    message = "[bold]Welcome![/bold] Run [cyan]pip install -e .[/cyan] to start."
+
+    # Option 2: Markdown formatted message
+    markdown = "## Welcome\\n\\nThis supports **markdown** formatting."
+
+    # Option 3: Step-by-step instructions
+    steps = [
+        "Install dependencies: [green]pip install -e .[/green]",
+        "Run tests: [green]pytest[/green]",
+        "Start coding!"
+    ]
+
+Rich Markup Examples:
+    - Colors: [red]text[/red], [green]text[/green], [blue]text[/blue], [cyan]text[/cyan]
+    - Styles: [bold]text[/bold], [italic]text[/italic], [underline]text[/underline]
+    - Combined: [bold cyan]text[/bold cyan]
+    - Background: [on red]text[/on red]
+    - Links: [link=https://example.com]clickable[/link]
+
+See Rich documentation for more markup options: https://rich.readthedocs.io/en/stable/markup.html
+"""
+
+from __future__ import annotations
+
+import logging
+import subprocess
+import tomllib
+from pathlib import Path
+from typing import Any
+
+from rich.console import Console
+from rich.markdown import Markdown
+from rich.panel import Panel
+from rich.text import Text
+
+logger = logging.getLogger(__name__)
+
+console = Console()
+
+
+def clone_repository(url: str) -> tuple[bool, str]:
+    """
+    Clone a git repository quietly and return status.
+
+    Args:
+        url: Git repository URL
+
+    Returns:
+        Tuple of (success, directory_path or error_message)
+    """
+    # Extract repo name from URL
+    repo_name = Path(url).stem
+    if repo_name.endswith(".git"):
+        repo_name = repo_name[:-4]
+
+    # Build git clone command (simple, no options)
+    cmd = ["git", "clone", "--quiet", url]
+
+    try:
+        # Run git clone with quiet flag
+        subprocess.run(  # noqa: S603
+            cmd,
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+
+        # Get the absolute path of the cloned directory
+        clone_path = Path(repo_name).resolve()
+
+        return True, str(clone_path)
+
+    except subprocess.CalledProcessError as e:
+        error_msg = (
+            e.stderr.strip() if e.stderr else f"Git clone failed with exit code {e.returncode}"
+        )
+        return False, error_msg
+    except Exception as e:
+        return False, f"Unexpected error: {e!s}"
+
+
+def get_clone_message(clone_path: str) -> dict[str, Any] | None:
+    """
+    Look for a clone message configuration in the repository's pyproject.toml or .hud.toml.
+
+    Checks for:
+    1. [tool.hud.clone] section in pyproject.toml
+    2. [clone] section in .hud.toml
+
+    Args:
+        clone_path: Path to the cloned repository
+
+    Returns:
+        Dictionary with message configuration or None
+    """
+    repo_path = Path(clone_path)
+
+    # Check pyproject.toml first
+    pyproject_path = repo_path / "pyproject.toml"
+    if pyproject_path.exists():
+        try:
+            with open(pyproject_path, "rb") as f:
+                data = tomllib.load(f)
+                if "tool" in data and "hud" in data["tool"] and "clone" in data["tool"]["hud"]:
+                    return data["tool"]["hud"]["clone"]
+        except Exception:
+            logger.warning("Failed to load clone config from %s", pyproject_path)
+
+    # Check .hud.toml as fallback
+    hud_toml_path = repo_path / ".hud.toml"
+    if hud_toml_path.exists():
+        try:
+            with open(hud_toml_path, "rb") as f:
+                data = tomllib.load(f)
+                if "clone" in data:
+                    return data["clone"]
+        except Exception:
+            logger.warning("Failed to load clone config from %s", hud_toml_path)
+
+    return None
+
+
+def print_tutorial(clone_config: dict[str, Any] | None = None) -> None:
+    """Print a rich formatted success message with optional tutorial."""
+    # Display custom message if configured
+    if clone_config:
+        # Handle different message formats
+        if "message" in clone_config:
+            # Message with Rich markup support
+            console.print(
+                Panel(
+                    clone_config["message"],  # Rich will parse markup automatically
+                    title=clone_config.get("title", "📋 Getting Started"),
+                    border_style=clone_config.get("style", "blue"),
+                    padding=(1, 2),
+                )
+            )
+        elif "markdown" in clone_config:
+            # Markdown message
+            console.print(
+                Panel(
+                    Markdown(clone_config["markdown"]),
+                    title=clone_config.get("title", "📋 Getting Started"),
+                    border_style=clone_config.get("style", "blue"),
+                    padding=(1, 2),
+                )
+            )
+        elif "steps" in clone_config:
+            # Step-by-step instructions
+            title = clone_config.get("title", "📋 Getting Started")
+            console.print(f"\n[bold]{title}[/bold]\n")
+            for i, step in enumerate(clone_config["steps"], 1):
+                console.print(f"  {i}. {step}")
+            console.print()
+
+
+def print_error(error_msg: str) -> None:
+    """Print a rich formatted error message."""
+    console.print(
+        Panel(
+            Text(f"❌ {error_msg}", style="red"),
+            title="[bold red]Clone Failed[/bold red]",
+            border_style="red",
+            padding=(1, 2),
+        )
+    )

hud/cli/cursor.py

@@ -1,92 +1,92 @@
-"""Cursor config parsing utilities."""
-
-from __future__ import annotations
-
-import json
-import os
-from pathlib import Path
-
-
-def parse_cursor_config(server_name: str) -> tuple[list[str] | None, str | None]:
-    """
-    Parse cursor config to get command for a server.
-
-    Args:
-        server_name: Name of the server in Cursor config
-
-    Returns:
-        Tuple of (command_list, error_message). If successful, error_message is None.
-        If failed, command_list is None and error_message contains the error.
-    """
-    # Find cursor config
-    cursor_config_path = Path.home() / ".cursor" / "mcp.json"
-    if not cursor_config_path.exists():
-        # Try Windows path
-        cursor_config_path = Path(os.environ.get("USERPROFILE", "")) / ".cursor" / "mcp.json"
-
-    if not cursor_config_path.exists():
-        return None, f"Cursor config not found at {cursor_config_path}"
-
-    try:
-        with open(cursor_config_path) as f:
-            config = json.load(f)
-
-        servers = config.get("mcpServers", {})
-        if server_name not in servers:
-            available = ", ".join(servers.keys())
-            return None, f"Server '{server_name}' not found. Available: {available}"
-
-        server_config = servers[server_name]
-        command = server_config.get("command", "")
-        args = server_config.get("args", [])
-        _ = server_config.get("env", {})
-
-        # Combine command and args
-        full_command = [command, *args]
-
-        # Handle reloaderoo wrapper
-        if command == "npx" and "reloaderoo" in args and "--" in args:
-            # Extract the actual command after --
-            dash_index = args.index("--")
-            full_command = args[dash_index + 1 :]
-
-        return full_command, None
-
-    except Exception as e:
-        return None, f"Error reading config: {e}"
-
-
-def list_cursor_servers() -> tuple[list[str] | None, str | None]:
-    """
-    List all available servers in Cursor config.
-
-    Returns:
-        Tuple of (server_list, error_message). If successful, error_message is None.
-    """
-    # Find cursor config
-    cursor_config_path = Path.home() / ".cursor" / "mcp.json"
-    if not cursor_config_path.exists():
-        # Try Windows path
-        cursor_config_path = Path(os.environ.get("USERPROFILE", "")) / ".cursor" / "mcp.json"
-
-    if not cursor_config_path.exists():
-        return None, f"Cursor config not found at {cursor_config_path}"
-
-    try:
-        with open(cursor_config_path) as f:
-            config = json.load(f)
-
-        servers = config.get("mcpServers", {})
-        return list(servers.keys()), None
-
-    except Exception as e:
-        return None, f"Error reading config: {e}"
-
-
-def get_cursor_config_path() -> Path:
-    """Get the path to Cursor's MCP config file."""
-    cursor_config_path = Path.home() / ".cursor" / "mcp.json"
-    if not cursor_config_path.exists():
-        # Try Windows path
-        cursor_config_path = Path(os.environ.get("USERPROFILE", "")) / ".cursor" / "mcp.json"
-    return cursor_config_path
+"""Cursor config parsing utilities."""
+
+from __future__ import annotations
+
+import json
+import os
+from pathlib import Path
+
+
+def parse_cursor_config(server_name: str) -> tuple[list[str] | None, str | None]:
+    """
+    Parse cursor config to get command for a server.
+
+    Args:
+        server_name: Name of the server in Cursor config
+
+    Returns:
+        Tuple of (command_list, error_message). If successful, error_message is None.
+        If failed, command_list is None and error_message contains the error.
+    """
+    # Find cursor config
+    cursor_config_path = Path.home() / ".cursor" / "mcp.json"
+    if not cursor_config_path.exists():
+        # Try Windows path
+        cursor_config_path = Path(os.environ.get("USERPROFILE", "")) / ".cursor" / "mcp.json"
+
+    if not cursor_config_path.exists():
+        return None, f"Cursor config not found at {cursor_config_path}"
+
+    try:
+        with open(cursor_config_path) as f:
+            config = json.load(f)
+
+        servers = config.get("mcpServers", {})
+        if server_name not in servers:
+            available = ", ".join(servers.keys())
+            return None, f"Server '{server_name}' not found. Available: {available}"
+
+        server_config = servers[server_name]
+        command = server_config.get("command", "")
+        args = server_config.get("args", [])
+        _ = server_config.get("env", {})
+
+        # Combine command and args
+        full_command = [command, *args]
+
+        # Handle reloaderoo wrapper
+        if command == "npx" and "reloaderoo" in args and "--" in args:
+            # Extract the actual command after --
+            dash_index = args.index("--")
+            full_command = args[dash_index + 1 :]
+
+        return full_command, None
+
+    except Exception as e:
+        return None, f"Error reading config: {e}"
+
+
+def list_cursor_servers() -> tuple[list[str] | None, str | None]:
+    """
+    List all available servers in Cursor config.
+
+    Returns:
+        Tuple of (server_list, error_message). If successful, error_message is None.
+    """
+    # Find cursor config
+    cursor_config_path = Path.home() / ".cursor" / "mcp.json"
+    if not cursor_config_path.exists():
+        # Try Windows path
+        cursor_config_path = Path(os.environ.get("USERPROFILE", "")) / ".cursor" / "mcp.json"
+
+    if not cursor_config_path.exists():
+        return None, f"Cursor config not found at {cursor_config_path}"
+
+    try:
+        with open(cursor_config_path) as f:
+            config = json.load(f)
+
+        servers = config.get("mcpServers", {})
+        return list(servers.keys()), None
+
+    except Exception as e:
+        return None, f"Error reading config: {e}"
+
+
+def get_cursor_config_path() -> Path:
+    """Get the path to Cursor's MCP config file."""
+    cursor_config_path = Path.home() / ".cursor" / "mcp.json"
+    if not cursor_config_path.exists():
+        # Try Windows path
+        cursor_config_path = Path(os.environ.get("USERPROFILE", "")) / ".cursor" / "mcp.json"
+    return cursor_config_path