git-uncommitted-scanner 0.1.0__py3-none-any.whl

git_scanner/main.py

@@ -0,0 +1,211 @@
+import sys
+import subprocess
+from pathlib import Path
+import typer
+from rich.console import Console
+from rich.table import Table
+from rich import print as rprint
+from textual.app import App, ComposeResult
+from textual.widgets import Header, Footer, DataTable, Label, LoadingIndicator
+from textual.binding import Binding
+from textual.worker import get_current_worker
+
+# ---------------------------------------------------------
+# CORE LOGIC
+# ---------------------------------------------------------
+def is_repo_dirty(repo_path: Path) -> bool:
+    """Checks if a git repo has uncommitted changes."""
+    try:
+        result = subprocess.run(
+            ['git', 'status', '--porcelain'],
+            cwd=repo_path, capture_output=True, text=True, check=True
+        )
+        return bool(result.stdout.strip())
+    except Exception:
+        return False
+
+def open_external_terminal(path: str) -> None:
+    """Cross-platform function to open terminal and execute 'git status'."""
+    path_obj = Path(path).resolve()
+    
+    # ➔ FIX: Using 'cwd=path_obj' forces the terminal to spawn inside the repo natively.
+    if sys.platform == "win32":
+        subprocess.Popen('start cmd /K "git status"', cwd=path_obj, shell=True)
+    elif sys.platform == "darwin":
+        # macOS: Use AppleScript to strictly open a new Terminal window with commands
+        script = f'''
+        osascript -e 'tell application "Terminal" to do script "cd \\"{path_obj}\\" && git status"' -e 'tell application "Terminal" to activate'
+        '''
+        subprocess.Popen(script, shell=True)
+    else:
+        terminals = ['gnome-terminal', 'konsole', 'xfce4-terminal', 'alacritty', 'xterm']
+        for term in terminals:
+            if subprocess.run(['which', term], capture_output=True).returncode == 0:
+                if term == 'gnome-terminal':
+                    subprocess.Popen([term, '--', 'bash', '-c', 'git status && exec bash'], cwd=path_obj)
+                else:
+                    subprocess.Popen([term, '-e', 'bash -c "git status && exec bash"'], cwd=path_obj)
+                break
+
+# ---------------------------------------------------------
+# TUI IMPLEMENTATION
+# ---------------------------------------------------------
+class GitScannerTUI(App):
+    """High-Tech TUI for navigating repositories."""
+    
+    # Premium Neon-Cyan Aesthetic
+    CSS = """
+    Screen { background: #0a0a0a; }
+    Header { background: #002222; color: #00ffff; text-style: bold; }
+    Footer { background: #002222; color: #00ffff; }
+    
+    DataTable {
+        height: 1fr;
+        margin: 1 2;
+        border: round #00ffff;
+        background: #051515;
+        color: #e0ffff;
+    }
+    DataTable > .datatable--header { background: #004444; color: #00ffff; text-style: bold; }
+    DataTable > .datatable--cursor { background: #00ffff; color: #000000; text-style: bold; }
+    
+    #status-bar {
+        dock: bottom;
+        height: 3;
+        content-align: center middle;
+        background: #001111;
+        color: #00ffff;
+        border-top: solid #00ffff;
+    }
+    
+    LoadingIndicator { color: #00ffff; height: 1fr; }
+    """
+    
+    BINDINGS = [
+        Binding("q", "quit", "Quit"),
+        Binding("o", "open_terminal", "Open Workspace"),
+        Binding("r", "refresh_scan", "Refresh Scan")
+    ]
+
+    def __init__(self, target_dir: Path):
+        super().__init__()
+        self.target_dir = target_dir
+
+    def compose(self) -> ComposeResult:
+        yield Header(show_clock=True)
+        yield LoadingIndicator(id="loader")
+        yield DataTable(id="repo_table")
+        yield Label("INITIALIZING SYSTEM...", id="status-bar")
+        yield Footer()
+
+    def on_mount(self) -> None:
+        table = self.query_one(DataTable)
+        table.cursor_type = "row"
+        table.zebra_stripes = True
+        table.add_columns("ID", "Uncommitted Repository Target")
+        self.action_refresh_scan()
+
+    def action_refresh_scan(self) -> None:
+        """Triggers the UI loading state and starts the background worker."""
+        table = self.query_one(DataTable)
+        loader = self.query_one("#loader", LoadingIndicator)
+        
+        table.display = False
+        loader.display = True
+        self.query_one("#status-bar", Label).update(f"⏳ SCANNING DIRECTORY: {self.target_dir}")
+        
+        self.run_worker(self.scan_directories, thread=True, exclusive=True)
+
+    def scan_directories(self) -> None:
+        worker = get_current_worker()
+        dirty_repos = []
+        
+        for git_dir in self.target_dir.rglob('.git'):
+            if worker.is_cancelled: 
+                return
+            repo_path = git_dir.parent
+            if is_repo_dirty(repo_path):
+                dirty_repos.append(repo_path)
+                
+        self.call_from_thread(self.update_table, dirty_repos)
+
+    def update_table(self, repos: list[Path]) -> None:
+        table = self.query_one(DataTable)
+        loader = self.query_one("#loader", LoadingIndicator)
+        status = self.query_one("#status-bar", Label)
+        
+        table.clear()
+        loader.display = False
+        table.display = True
+        
+        if not repos:
+            status.update("✅ ALL REPOSITORIES SECURED AND COMMITTED")
+            return
+            
+        status.update(f"⚠️ DETECTED {len(repos)} REPOSITORIES REQUIRING ATTENTION")
+        for idx, repo in enumerate(repos, 1):
+            table.add_row(str(idx), str(repo))
+
+    def action_open_terminal(self) -> None:
+        table = self.query_one(DataTable)
+        try:
+            # Safely grab the exact string from column index 1 of the highlighted row
+            row_index = table.cursor_row
+            # ➔ FIX: Ensure the extracted cell is cast to a standard string
+            repo_path = str(table.get_row_at(row_index)[1])
+            open_external_terminal(repo_path)
+        except Exception:
+            self.notify("ERROR: TARGET A REPOSITORY FIRST", severity="error")
+
+# ---------------------------------------------------------
+# CLI & ROUTING
+# ---------------------------------------------------------
+app = typer.Typer(help="Scan directories for uncommitted Git repositories.")
+console = Console()
+
+@app.command()
+def scan(
+    # ➔ FIX: Default to "." (current directory) if no argument is provided
+    directory: str = typer.Argument(".", help="Target directory to scan (defaults to current directory)"),
+    interactive: bool = typer.Option(False, "--interactive", "-i", help="Launch the interactive TUI")
+):
+    """Deep scan a directory for uncommitted Git repositories."""
+    base_path = Path(directory).expanduser().resolve()
+    
+    if not base_path.exists() or not base_path.is_dir():
+        rprint(f"[bold red]❌ Error:[/bold red] Directory '{base_path}' does not exist.")
+        raise typer.Exit(code=1)
+
+    # Route 1: TUI Mode
+    if interactive:
+        try:
+            tui_app = GitScannerTUI(base_path)
+            tui_app.run()
+            rprint("\n[bold cyan]✅ Workspace Scanner Terminated Successfully.[/bold cyan]\n")
+        except Exception as e:
+            rprint(f"\n[bold red]❌ CRITICAL TUI ERROR:[/bold red] {e}")
+            console.print_exception()
+        return
+
+    # Route 2: CLI Mode
+    with console.status(f"[bold cyan]Scanning {base_path}...[/bold cyan]", spinner="dots"):
+        dirty_repos = [
+            git_dir.parent for git_dir in base_path.rglob('.git') 
+            if is_repo_dirty(git_dir.parent)
+        ]
+
+    if not dirty_repos:
+        rprint("[bold green]✅ All repositories are clean and committed![/bold green]")
+        return
+
+    table = Table(title="⚠️ Uncommitted Repositories", show_header=True, header_style="bold magenta")
+    table.add_column("No.", style="dim", width=4)
+    table.add_column("Repository Path", style="cyan")
+
+    for idx, repo in enumerate(dirty_repos, 1):
+        table.add_row(str(idx), str(repo))
+
+    console.print(table)
+
+if __name__ == "__main__":
+    app()

git_uncommitted_scanner-0.1.0.dist-info/METADATA

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: git-uncommitted-scanner
+Version: 0.1.0
+Summary: A lightweight CLI to scan for uncommitted Git repositories.
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: textual>=0.50.0
+
+# 🔍 Git Uncommitted Scanner
+
+![Python](https://img.shields.io/badge/python-3.8+-blue.svg)
+![Typer](https://img.shields.io/badge/typer-CLI-black.svg)
+![Textual](https://img.shields.io/badge/textual-TUI-cyan.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+
+**A lightning-fast, cross-platform utility that recursively deep-scans directories to instantly find Git repositories with uncommitted changes.**
+
+---
+
+## ⚡ Why `git-uncommitted-scanner`?
+
+Tired of discovering forgotten, uncommitted work in scattered repositories months later? `git-uncommitted-scanner` hunts down pending changes across your entire filesystem with asynchronous speed, presenting them in either a clean CLI table or a high-tech interactive TUI. 
+
+---
+
+## 📦 Installation
+
+Install globally via `pip` (or `pipx` for isolated environments):
+
+```bash
+pip install git-uncommitted-scanner
+```
+
+---
+
+## 🚀 Usage
+
+The tool provides a single command `scanrepos` that works in two modes: standard CLI and interactive TUI.
+
+### Standard CLI Mode
+Run a blazing-fast background scan that outputs a clean, readable table of repositories needing your attention.
+
+```bash
+# Scan the current directory
+scanrepos
+
+# Scan a specific path
+scanrepos /path/to/your/projects
+```
+
+### Interactive TUI Mode
+Launch the high-tech Neon-Cyan Terminal User Interface for an interactive experience. Navigate repositories with your keyboard and spawn a native terminal to instantly handle changes.
+
+```bash
+# Launch TUI in the current directory
+scanrepos -i
+
+# Launch TUI for a specific path
+scanrepos -i /path/to/your/projects
+```
+
+---
+
+## ✨ Key Features
+
+*   **Asynchronous Deep-Scanning**: Rapidly traverses deep folder structures in the background without blocking the UI.
+*   **Lightning-Fast CLI Output**: Instantly summarizes findings in a clean, easily readable terminal table.
+*   **High-Tech Neon-Cyan TUI**: A beautiful, interactive textual interface accessible via a simple `-i` flag.
+*   **Keyboard Navigation**: Full keyboard support in the TUI for seamless, mouse-free workflow.
+*   **OS-Aware Terminal Spawning**: Select a repository in the TUI and instantly spawn a native terminal (Windows, macOS, or Linux) running `git status` right in that directory.
+*   **Cross-Platform**: Built to work flawlessly across Windows, macOS, and Linux environments.
+
+---
+
+*Built with [Python](https://www.python.org/), [Typer](https://typer.tiangolo.com/), and [Textual](https://textual.textualize.io/).*

git_uncommitted_scanner-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+git_scanner/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+git_scanner/main.py,sha256=hzDOw2woi4KZ_UtZ2lPwd29sYaIt_NB2Nm6CRchX5q8,8149
+git_uncommitted_scanner-0.1.0.dist-info/METADATA,sha256=oaPgElQ9Ym9y2Ugtl40Ppye9PItAQuP6Zu-4kLvjeHk,2842
+git_uncommitted_scanner-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+git_uncommitted_scanner-0.1.0.dist-info/entry_points.txt,sha256=v4GrKLtYnFGpMcKek3qyTrVCC3GUzV848W7-oGeieqs,51
+git_uncommitted_scanner-0.1.0.dist-info/top_level.txt,sha256=TuzP1RnqSuR-Vvjeg6R1cI5fuI9b1krEI5SE9UzLjz4,12
+git_uncommitted_scanner-0.1.0.dist-info/RECORD,,

git_uncommitted_scanner-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

git_uncommitted_scanner-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+scanrepos = git_scanner.main:app

git_uncommitted_scanner-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+git_scanner