#!/usr/bin/env -S uv run --script # /// script # requires-python = ">=3.10" # dependencies = [ # "rich>=13.0.0", # "questionary>=1.10.0", # ] # /// import os import shutil import subprocess import sys from dataclasses import dataclass from pathlib import Path from typing import List, Dict from rich.console import Console from rich.filesize import decimal from rich.progress import BarColumn, Progress, SpinnerColumn, TextColumn import questionary console = Console() @dataclass class DirectorySize: path: Path size_bytes: int parent: Path dtype: str @property def size_mb(self) -> float: return self.size_bytes / (1024 * 1024) @property def size_display(self) -> str: return decimal(self.size_bytes) def get_dir_size(path: Path) -> int: """Get total size of a directory in bytes.""" try: # macOS uses BSD du which doesn't support -b, use -A -s instead result = subprocess.run(["du", "-A", "-s", str(path)], capture_output=True, text=True, timeout=10) if result.returncode == 0: return int(result.stdout.split()[0]) * 512 # BSD du uses 512-byte blocks by default except (subprocess.TimeoutExpired, ValueError, IndexError): pass return 0 def find_target_dirs(root: Path, target_names: List[str]) -> List[DirectorySize]: """Find all target directories under root.""" results = [] with Progress( SpinnerColumn(), TextColumn("[progress.description]{task.description}"), console=console, transient=True, ) as progress: task = progress.add_task("Scanning directory tree...", total=None) for current_dir, dirs, files in os.walk(root): progress.update(task, description=f"Scanning {current_dir}...") # Check for target directories in current location for target_name in target_names: target_path = Path(current_dir) / target_name if target_path.exists() and target_path.is_dir(): size = get_dir_size(target_path) if size > 0: results.append( DirectorySize(path=target_path, size_bytes=size, parent=Path(current_dir), dtype=target_name) ) # Don't recurse into target directories themselves to avoid nested scanning dirs[:] = [d for d in dirs if d not in target_names] return results def format_path(dir_info: DirectorySize, root: Path) -> str: """Format path relative to root, showing the full path to target dir.""" try: rel_parent = dir_info.parent.relative_to(root) return f"{rel_parent}/{dir_info.path.name}" except ValueError: return str(dir_info.path) def create_bar(size_bytes: int, max_size_bytes: int, width: int = 20) -> str: """Create a simple ASCII bar chart.""" if max_size_bytes == 0: return "█" * 0 percentage = size_bytes / max_size_bytes filled = int(percentage * width) return "█" * filled + "░" * (width - filled) def interactive_selection(filtered_dirs: List[DirectorySize], root: Path, total_size: int, by_type: Dict[str, List[DirectorySize]]) -> List[DirectorySize]: """Interactive selection UI for choosing directories to delete.""" # Create checkbox list grouped by type choices = [] for dtype in sorted(by_type.keys()): dirs_of_type = sorted(by_type[dtype], key=lambda x: x.size_bytes, reverse=True) type_total = sum(d.size_bytes for d in dirs_of_type) # Add category header choices.append(questionary.Separator(f"\n{dtype.upper()} ({len(dirs_of_type)} dirs, {decimal(type_total)})")) # Add directories under this category for dir_info in dirs_of_type: location = format_path(dir_info, root) percentage = (dir_info.size_bytes / total_size) * 100 display = f"{location:50} {dir_info.size_display:>12} ({percentage:5.1f}%)" # Use Choice with dir_info as the value choices.append(questionary.Choice(display, value=dir_info)) # Show checkbox selection selected = questionary.checkbox( "Select directories to delete (use [SPACE] to select, [ENTER] to confirm):", choices=choices, ).ask() if selected is None: return [] return selected def confirm_deletion(dirs_to_delete: List[DirectorySize]) -> bool: """Ask for confirmation before deletion/cleaning.""" total_size = sum(d.size_bytes for d in dirs_to_delete) # Separate git directories from others git_dirs = [d for d in dirs_to_delete if d.dtype == ".git"] other_dirs = [d for d in dirs_to_delete if d.dtype != ".git"] console.print(f"\n[bold red]Confirm Action[/bold red]") if git_dirs: console.print(f"[cyan]Git repositories to clean:[/cyan]") for dir_info in git_dirs: console.print(f" • {dir_info.path} ({dir_info.size_display})") if other_dirs: console.print(f"[red]Directories to delete:[/red]") for dir_info in other_dirs: console.print(f" • {dir_info.path} ({dir_info.size_display})") console.print(f"\n[bold yellow]Total size affected: {decimal(total_size)}[/bold yellow]\n") response = questionary.confirm("Proceed?").ask() return response is True def delete_directories(dirs_to_delete: List[DirectorySize]) -> None: """Delete or clean the selected directories.""" # Separate .git directories from others git_dirs = [d for d in dirs_to_delete if d.dtype == ".git"] other_dirs = [d for d in dirs_to_delete if d.dtype != ".git"] with Progress( SpinnerColumn(), TextColumn("[progress.description]{task.description}"), BarColumn(), TextColumn("[progress.percentage]{task.percentage:>3.0f}%"), console=console, ) as progress: task = progress.add_task("Processing...", total=len(dirs_to_delete)) # Handle .git directories with git gc for dir_info in git_dirs: try: progress.update(task, description=f"Cleaning {dir_info.path.name}...") if dir_info.path.exists(): # Run git gc to clean up dead/irrelevant files result = subprocess.run( ["git", "gc", "--aggressive", "--prune"], cwd=dir_info.path.parent, capture_output=True, text=True, timeout=120 ) if result.returncode == 0: console.print(f"[green]✓ Cleaned {dir_info.path}[/green]") else: console.print(f"[yellow]⚠ Warning cleaning {dir_info.path}: {result.stderr}[/yellow]") progress.advance(task) except subprocess.TimeoutExpired: console.print(f"[yellow]⚠ Timeout cleaning {dir_info.path}[/yellow]") progress.advance(task) except Exception as e: console.print(f"[red]Error cleaning {dir_info.path}: {e}[/red]") progress.advance(task) # Delete other directories for dir_info in other_dirs: try: progress.update(task, description=f"Deleting {dir_info.path.name}...") if dir_info.path.exists(): shutil.rmtree(dir_info.path) console.print(f"[green]✓ Deleted {dir_info.path}[/green]") progress.advance(task) except Exception as e: console.print(f"[red]Error deleting {dir_info.path}: {e}[/red]") progress.advance(task) console.print("[bold green]✓ Processing complete![/bold green]") def clean_dirs(): root = Path.cwd() if not root.exists(): console.print(f"[red]Error: {root} does not exist[/red]") sys.exit(1) target_dirs = ["node_modules", ".venv", ".git", "docker"] min_size_mb = 50 console.print(f"[cyan]Analyzing disk usage in {root}[/cyan]") console.print(f"[cyan]Target directories: {', '.join(target_dirs)}[/cyan]") console.print(f"[cyan]Minimum size filter: {min_size_mb}MB[/cyan]\n") # Find all target directories all_dirs = find_target_dirs(root, target_dirs) # Filter by minimum size filtered_dirs = [d for d in all_dirs if d.size_mb >= min_size_mb] filtered_dirs.sort(key=lambda x: x.size_bytes, reverse=True) if not filtered_dirs: console.print(f"[yellow]No directories found larger than {min_size_mb}MB[/yellow]") return total_size = sum(d.size_bytes for d in filtered_dirs) max_size = filtered_dirs[0].size_bytes # Group by type by_type = {} for dir_info in filtered_dirs: dtype = dir_info.dtype if dtype not in by_type: by_type[dtype] = [] by_type[dtype].append(dir_info) # Display summary console.print(f"[bold cyan]📊 Disk Space Usage Summary[/bold cyan]\n") for dtype in sorted(by_type.keys()): dirs_of_type = sorted(by_type[dtype], key=lambda x: x.size_bytes, reverse=True) type_total = sum(d.size_bytes for d in dirs_of_type) type_percentage = (type_total / total_size) * 100 console.print(f"[bold magenta]{dtype}[/bold magenta] ({len(dirs_of_type)} dirs) [yellow]{decimal(type_total)}[/yellow] ({type_percentage:.1f}%)") for dir_info in dirs_of_type: bar = create_bar(dir_info.size_bytes, max_size) location = format_path(dir_info, root) dir_percentage = (dir_info.size_bytes / total_size) * 100 console.print(f" {location} [cyan]{bar}[/cyan] {dir_info.size_display} ({dir_percentage:.1f}%)") console.print() console.print(f"[bold cyan]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━[/bold cyan]") console.print(f"[bold]Total size (filtered): {decimal(total_size)}[/bold]") console.print(f"[bold]Number of directories: {len(filtered_dirs)}[/bold]") console.print(f"[bold cyan]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━[/bold cyan]\n") # Interactive selection selected = interactive_selection(filtered_dirs, root, total_size, by_type) if not selected: console.print("[yellow]No directories selected for deletion[/yellow]") return # Confirm deletion if not confirm_deletion(selected): console.print("[yellow]Deletion cancelled[/yellow]") return # Delete delete_directories(selected) def simulator_runtimes_summary() -> str | None: if shutil.which("xcrun") is None: return None result = subprocess.run(["xcrun", "simctl", "runtime", "list"], capture_output=True, text=True) for line in result.stdout.splitlines(): if line.startswith("Total Disk Images:") and not line.startswith("Total Disk Images: 0"): return line.removeprefix("Total Disk Images: ") return None def offer_xcode_sims() -> None: summary = simulator_runtimes_summary() if summary is None: return console.print() if questionary.confirm(f"Delete Xcode simulator runtimes? {summary}", default=False).ask(): subprocess.run(["xcode-sims", "off"], check=True) def main(): clean_dirs() offer_xcode_sims() if __name__ == "__main__": main()