pipu-cli 0.1.dev7__py3-none-any.whl → 0.2.0__py3-none-any.whl

pipu_cli/pretty.py

@@ -0,0 +1,286 @@
+"""Pretty printing functions for pipu CLI."""
+
+from typing import List, Optional
+
+from rich.console import Console
+from rich.table import Table
+from rich.prompt import Confirm, Prompt
+
+from pipu_cli.package_management import UpgradePackageInfo, UpgradedPackage, BlockedPackageInfo
+
+
+class ConsoleStream:
+    """A stream adapter that writes to a Rich Console.
+
+    This class implements the write/flush protocol expected by
+    package_management.OutputStream, allowing pip output to be
+    displayed through Rich's console.
+    """
+
+    def __init__(self, console: Console) -> None:
+        """Initialize with a Rich console instance.
+
+        :param console: Rich Console to write output to
+        """
+        self.console = console
+
+    def write(self, text: str) -> None:
+        """Write text to the console if non-empty.
+
+        :param text: Text to write
+        """
+        if text and text.strip():
+            self.console.print(text, end="")
+
+    def flush(self) -> None:
+        """Flush the stream (no-op for console)."""
+        pass
+
+
+def print_upgradable_packages_table(
+    packages: List[UpgradePackageInfo],
+    console: Optional[Console] = None
+) -> None:
+    """
+    Print a table of upgradable packages with version information.
+
+    :param packages: List of UpgradePackageInfo objects to display
+    :param console: Optional Rich console instance (creates new one if not provided)
+    """
+    if console is None:
+        console = Console()
+
+    if not packages:
+        console.print("[yellow]No packages need upgrading.[/yellow]")
+        return
+
+    # Filter to only upgradable packages
+    upgradable = [pkg for pkg in packages if pkg.upgradable]
+
+    if not upgradable:
+        console.print("[yellow]No packages can be upgraded (all blocked by constraints).[/yellow]")
+        return
+
+    # Create table
+    num_upgradable = len(upgradable)
+    table = Table(title=f"[bold]{num_upgradable} Package(s) Available for Upgrade[/bold]")
+    table.add_column("Package", style="cyan", no_wrap=True)
+    table.add_column("Current", style="magenta")
+    table.add_column("Latest", style="green")
+    table.add_column("Editable", style="yellow")
+
+    for pkg in upgradable:
+        editable_mark = "Yes" if pkg.is_editable else ""
+        table.add_row(
+            pkg.name,
+            str(pkg.version),
+            str(pkg.latest_version),
+            editable_mark
+        )
+
+    console.print(table)
+
+
+def print_blocked_packages_table(
+    packages: List[BlockedPackageInfo],
+    console: Optional[Console] = None
+) -> None:
+    """
+    Print a table of blocked packages with reasons.
+
+    :param packages: List of BlockedPackageInfo objects to display
+    :param console: Optional Rich console instance
+    """
+    if console is None:
+        console = Console()
+
+    if not packages:
+        return
+
+    num_blocked = len(packages)
+    table = Table(title=f"[bold yellow]{num_blocked} Package(s) Blocked by Constraints[/bold yellow]")
+    table.add_column("Package", style="cyan", no_wrap=True)
+    table.add_column("Current", style="magenta")
+    table.add_column("Available", style="green")
+    table.add_column("Blocked By", style="red")
+
+    for pkg in packages:
+        blocked_by = ", ".join(pkg.blocked_by[:2])  # Show first 2 reasons
+        if len(pkg.blocked_by) > 2:
+            blocked_by += f" (+{len(pkg.blocked_by) - 2} more)"
+
+        table.add_row(
+            pkg.name,
+            str(pkg.version),
+            str(pkg.latest_version),
+            blocked_by
+        )
+
+    console.print(table)
+
+
+def print_upgrade_results(
+    results: List[UpgradedPackage],
+    console: Optional[Console] = None
+) -> None:
+    """
+    Print a summary of package upgrade results.
+
+    :param results: List of UpgradedPackage objects with upgrade status
+    :param console: Optional Rich console instance (creates new one if not provided)
+    """
+    if console is None:
+        console = Console()
+
+    if not results:
+        console.print("[yellow]No packages were processed.[/yellow]")
+        return
+
+    # Separate successful and failed upgrades
+    successful = [pkg for pkg in results if pkg.upgraded]
+    failed = [pkg for pkg in results if not pkg.upgraded]
+
+    # Print success summary
+    if successful:
+        num_successful = len(successful)
+        console.print(f"\n[bold green]Successfully upgraded {num_successful} package(s):[/bold green]")
+        for pkg in successful:
+            prev_ver = str(pkg.previous_version)
+            curr_ver = str(pkg.version)
+            console.print(f"  - {pkg.name}: {prev_ver} -> {curr_ver}")
+
+    # Print failure summary
+    if failed:
+        num_failed = len(failed)
+        console.print(f"\n[bold yellow]{num_failed} package(s) could not be upgraded:[/bold yellow]")
+
+        table = Table(show_header=True, header_style="bold yellow")
+        table.add_column("Package", style="cyan")
+        table.add_column("Current Version", style="magenta")
+        table.add_column("Reason", style="dim")
+
+        for pkg in failed:
+            table.add_row(
+                pkg.name,
+                str(pkg.version),
+                "Blocked by runtime constraints"
+            )
+
+        console.print(table)
+
+    # Overall summary
+    console.print()
+    if failed:
+        num_successful = len(successful)
+        num_total = len(results)
+        console.print(f"[bold]Summary:[/bold] {num_successful}/{num_total} packages upgraded successfully")
+    else:
+        console.print("[bold green]All packages upgraded successfully![/bold green]")
+
+
+def _parse_selection(selection: str, max_index: int) -> List[int]:
+    """Parse a selection string supporting ranges and comma-separated values.
+
+    Examples:
+        "1,2,3" -> [0, 1, 2]
+        "1-3" -> [0, 1, 2]
+        "1-3, 5" -> [0, 1, 2, 4]
+        "1, 3-5, 7" -> [0, 2, 3, 4, 6]
+
+    :param selection: User input string
+    :param max_index: Maximum valid index (1-based)
+    :returns: List of 0-based indices
+    :raises ValueError: If selection cannot be parsed
+    """
+    indices = set()
+    parts = selection.split(',')
+
+    for part in parts:
+        part = part.strip()
+        if not part:
+            continue
+
+        if '-' in part:
+            # Handle range like "1-3"
+            range_parts = part.split('-')
+            if len(range_parts) != 2:
+                raise ValueError(f"Invalid range: {part}")
+            start = int(range_parts[0].strip())
+            end = int(range_parts[1].strip())
+            if start > end:
+                start, end = end, start
+            for i in range(start, end + 1):
+                if 1 <= i <= max_index:
+                    indices.add(i - 1)  # Convert to 0-based
+        else:
+            # Handle single number
+            num = int(part)
+            if 1 <= num <= max_index:
+                indices.add(num - 1)  # Convert to 0-based
+
+    return sorted(indices)
+
+
+def select_packages_interactively(
+    packages: List[UpgradePackageInfo],
+    console: Console
+) -> List[UpgradePackageInfo]:
+    """Allow user to interactively select which packages to upgrade.
+
+    :param packages: Available packages to choose from
+    :param console: Rich console for output
+    :returns: Selected packages
+    """
+    console.print("\n[bold]Select packages to upgrade:[/bold]")
+    console.print("[dim](Enter numbers, ranges, or 'all'. Examples: 1,3,5 or 1-3 or 1-3,5)[/dim]\n")
+
+    for idx, pkg in enumerate(packages, 1):
+        console.print(f"  {idx}. {pkg.name}: {pkg.version} -> {pkg.latest_version}")
+
+    console.print()
+    selection = Prompt.ask("Selection", default="all")
+
+    if selection.lower() == "all":
+        selected = packages
+    else:
+        try:
+            indices = _parse_selection(selection, len(packages))
+            selected = [packages[i] for i in indices]
+
+            if not selected:
+                console.print("[yellow]No valid packages selected, using all packages.[/yellow]")
+                selected = packages
+        except (ValueError, IndexError):
+            console.print("[yellow]Invalid selection, using all packages.[/yellow]")
+            selected = packages
+
+    # Show confirmation table with selected packages highlighted
+    selected_names = {pkg.name for pkg in selected}
+    num_selected = len(selected)
+
+    console.print()
+    table = Table(title=f"[bold]{num_selected} Package(s) Selected for Upgrade[/bold]")
+    table.add_column("", style="bold green", no_wrap=True, width=3)
+    table.add_column("Package", style="cyan", no_wrap=True)
+    table.add_column("Current", style="magenta")
+    table.add_column("Latest", style="green")
+
+    for pkg in packages:
+        is_selected = pkg.name in selected_names
+        marker = "[green]\u2713[/green]" if is_selected else ""
+        style = "" if is_selected else "dim"
+        table.add_row(
+            marker,
+            f"[{style}]{pkg.name}[/{style}]" if style else pkg.name,
+            f"[{style}]{pkg.version}[/{style}]" if style else str(pkg.version),
+            f"[{style}]{pkg.latest_version}[/{style}]" if style else str(pkg.latest_version),
+        )
+
+    console.print(table)
+
+    # Ask for confirmation
+    if not Confirm.ask("\nProceed with upgrade?", default=True):
+        console.print("[yellow]Upgrade cancelled.[/yellow]")
+        return []
+
+    return selected

pipu_cli/requirements.py

@@ -0,0 +1,100 @@
+"""Requirements file management for pipu."""
+
+import re
+from pathlib import Path
+from typing import List, Dict
+
+from pipu_cli.package_management import UpgradedPackage
+
+
+def parse_requirements_file(path: Path) -> Dict[str, str]:
+    """Parse a requirements.txt file.
+
+    :param path: Path to requirements file
+    :returns: Dict mapping package names to their lines
+    """
+    packages = {}
+
+    if not path.exists():
+        return packages
+
+    with open(path, 'r') as f:
+        for line in f:
+            line = line.strip()
+
+            # Skip comments and empty lines
+            if not line or line.startswith('#'):
+                continue
+
+            # Skip options like -r, -e, etc.
+            if line.startswith('-'):
+                continue
+
+            # Extract package name (before any specifier)
+            match = re.match(r'^([a-zA-Z0-9_-]+)', line)
+            if match:
+                pkg_name = match.group(1).lower()
+                packages[pkg_name] = line
+
+    return packages
+
+
+def update_requirements_file(
+    path: Path,
+    upgraded_packages: List[UpgradedPackage],
+    pin_versions: bool = True
+) -> int:
+    """Update a requirements file with upgraded package versions.
+
+    :param path: Path to requirements file
+    :param upgraded_packages: List of upgraded packages
+    :param pin_versions: Whether to pin exact versions (default: True)
+    :returns: Number of packages updated
+    """
+    if not path.exists():
+        return 0
+
+    # Read current file
+    with open(path, 'r') as f:
+        lines = f.readlines()
+
+    # Build map of upgraded packages
+    upgraded_map = {
+        pkg.name.lower(): pkg
+        for pkg in upgraded_packages
+        if pkg.upgraded
+    }
+
+    updated_count = 0
+    new_lines = []
+
+    for line in lines:
+        stripped = line.strip()
+
+        # Keep comments and empty lines as-is
+        if not stripped or stripped.startswith('#') or stripped.startswith('-'):
+            new_lines.append(line)
+            continue
+
+        # Extract package name
+        match = re.match(r'^([a-zA-Z0-9_-]+)', stripped)
+        if match:
+            pkg_name = match.group(1).lower()
+
+            if pkg_name in upgraded_map:
+                pkg = upgraded_map[pkg_name]
+                if pin_versions:
+                    new_line = f"{pkg.name}=={pkg.version}\n"
+                else:
+                    new_line = f"{pkg.name}>={pkg.version}\n"
+                new_lines.append(new_line)
+                updated_count += 1
+                continue
+
+        new_lines.append(line)
+
+    # Write updated file
+    with open(path, 'w') as f:
+        f.writelines(new_lines)
+
+    return updated_count

pipu_cli/rollback.py

@@ -0,0 +1,110 @@
+"""Rollback functionality for pipu."""
+
+import json
+import subprocess
+import sys
+from datetime import datetime
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+from pipu_cli.package_management import UpgradedPackage
+
+
+ROLLBACK_DIR = Path.home() / ".pipu" / "rollback"
+
+
+def save_state(packages: List[Dict[str, str]], description: str = "") -> Path:
+    """Save current package state for potential rollback.
+
+    :param packages: List of dicts with 'name' and 'version' keys
+    :param description: Optional description of the state
+    :returns: Path to saved state file
+    """
+    ROLLBACK_DIR.mkdir(parents=True, exist_ok=True)
+
+    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+    state_file = ROLLBACK_DIR / f"state_{timestamp}.json"
+
+    state = {
+        "timestamp": timestamp,
+        "description": description,
+        "packages": packages
+    }
+
+    with open(state_file, 'w') as f:
+        json.dump(state, f, indent=2)
+
+    return state_file
+
+
+def get_latest_state() -> Optional[Dict[str, Any]]:
+    """Get the most recent saved state.
+
+    :returns: State dictionary or None if no states saved
+    """
+    if not ROLLBACK_DIR.exists():
+        return None
+
+    state_files = sorted(ROLLBACK_DIR.glob("state_*.json"), reverse=True)
+
+    if not state_files:
+        return None
+
+    with open(state_files[0], 'r') as f:
+        return json.load(f)
+
+
+def rollback_to_state(state: Dict[str, Any], dry_run: bool = False) -> List[str]:
+    """Rollback packages to a saved state.
+
+    :param state: State dictionary from get_latest_state()
+    :param dry_run: If True, only show what would be done
+    :returns: List of packages that were rolled back
+    """
+    packages = state.get("packages", [])
+    rolled_back = []
+
+    for pkg in packages:
+        name = pkg["name"]
+        version = pkg["version"]
+
+        if dry_run:
+            rolled_back.append(f"{name}=={version}")
+            continue
+
+        try:
+            subprocess.run(
+                [sys.executable, '-m', 'pip', 'install', f'{name}=={version}'],
+                check=True,
+                capture_output=True
+            )
+            rolled_back.append(f"{name}=={version}")
+        except subprocess.CalledProcessError:
+            pass
+
+    return rolled_back
+
+
+def list_states() -> List[Dict[str, Any]]:
+    """List all saved states.
+
+    :returns: List of state summaries
+    """
+    if not ROLLBACK_DIR.exists():
+        return []
+
+    states = []
+    for state_file in sorted(ROLLBACK_DIR.glob("state_*.json"), reverse=True):
+        try:
+            with open(state_file, 'r') as f:
+                state = json.load(f)
+            states.append({
+                "file": state_file.name,
+                "timestamp": state.get("timestamp", "unknown"),
+                "description": state.get("description", ""),
+                "package_count": len(state.get("packages", []))
+            })
+        except Exception:
+            pass
+
+    return states