before-push 0.1.0__py3-none-any.whl

before_push-0.1.0.dist-info/METADATA

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: before-push
+Version: 0.1.0
+Summary: A small CLI that checks your current Git branch before you push or open a pull request.
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: rich>=15.0.0
+
+## BeforePush

before_push-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+checks.py,sha256=FMzIPq4aorqzmpfY6K12GY6u9H7VJhVe8JS1E5NE1EA,4147
+cli.py,sha256=UtJAxu-wmn-FmCPe_BBAEKslPQPQZ0rx9GZkYG_bbeU,550
+git.py,sha256=zC3CdYiP87zuir1iTZe6m5jNMQ1BKeSIC9CmH6IsPGA,1566
+output.py,sha256=tIv7OgyAbZ6zsNLqoYOu4tWE0ntaPazTmG_744rrD28,3734
+before_push-0.1.0.dist-info/METADATA,sha256=ScmxitPQf8jDdExZY57dvtyUP0-cbLABWXgCrCx4kfk,268
+before_push-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+before_push-0.1.0.dist-info/entry_points.txt,sha256=-_w-mJny_mlijddoGNJuqAr6aYQ0qYN1qFzDx9Kh_DU,40
+before_push-0.1.0.dist-info/top_level.txt,sha256=frDQg37l8ZhH1hLVKWkyjppgqFphRtxPFsleaYhxKi0,22
+before_push-0.1.0.dist-info/RECORD,,

before_push-0.1.0.dist-info/WHEEL

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

before_push-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+beforepush = cli:main

before_push-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,4 @@
+checks
+cli
+git
+output

checks.py

@@ -0,0 +1,147 @@
+from dataclasses import dataclass
+from enum import Enum
+
+import git
+
+
+class CheckStatus(Enum):
+    PASS = "pass"
+    WARNING = "warning"
+    FAIL = "fail"
+
+# Check result data class
+@dataclass
+class CheckResult:
+    name: str
+    status: CheckStatus
+    message: str
+
+
+def check_git_repository() -> CheckResult:
+    """Check whether the current directory is a Git repository."""
+    if git.is_git_repository():
+        return CheckResult(
+            name="Git repository",
+            status=CheckStatus.PASS,
+            message="Current directory is a Git repository.",
+        )
+
+    return CheckResult(
+        name="Git repository",
+        status=CheckStatus.FAIL,
+        message="Current directory is not a Git repository.",
+    )
+
+
+def check_current_branch() -> CheckResult:
+    """Check whether a branch is currently checked out."""
+    try:
+        branch = git.get_current_branch()
+    except RuntimeError:
+        return CheckResult(
+            name="Current branch",
+            status=CheckStatus.FAIL,
+            message="Could not determine the current branch.",
+        )
+
+    if branch:
+        return CheckResult(
+            name="Current branch",
+            status=CheckStatus.PASS,
+            message=f"Currently on '{branch}'.",
+        )
+
+    return CheckResult(
+        name="Current branch",
+        status=CheckStatus.FAIL,
+        message="No branch is currently checked out.",
+    )
+
+
+def check_working_tree() -> CheckResult:
+    """Check whether the working tree is clean."""
+    try:
+        has_changes = git.has_changes()
+    except RuntimeError:
+        return CheckResult(
+            name="Working tree",
+            status=CheckStatus.FAIL,
+            message="Could not read the Git working tree.",
+        )
+
+    if not has_changes:
+        return CheckResult(
+            name="Working tree",
+            status=CheckStatus.PASS,
+            message="Working tree is clean.",
+        )
+
+    return CheckResult(
+        name="Working tree",
+        status=CheckStatus.FAIL,
+        message="Uncommitted or untracked changes detected.",
+    )
+
+def check_upstream_branch() -> CheckResult:
+    """Check whether the current branch has an upstream branch."""
+    try:
+        upstream = git.get_upstream_branch()
+    except RuntimeError:
+        return CheckResult(
+            name="Upstream branch",
+            status=CheckStatus.WARNING,
+            message="No upstream branch configured.",
+        )
+
+    return CheckResult(
+        name="Upstream branch",
+        status=CheckStatus.PASS,
+        message=f"Tracking '{upstream}'.",
+    )
+
+def check_target_branch(target: str) -> CheckResult:
+    """Check whether the current branch is behind the target branch."""
+    try:
+        current_branch = git.get_current_branch()
+       
+
+        if current_branch == target:
+            return CheckResult(
+                name="Target branch",
+                status=CheckStatus.PASS,
+                message=f"Currently on target branch '{target}'.",
+            )
+
+        behind = git.get_behind_count(target)
+
+    except RuntimeError:
+        return CheckResult(
+            name="Target branch",
+            status=CheckStatus.FAIL,
+            message=f"Could not compare with '{target}'.",
+        )
+
+    if behind == 0:
+        return CheckResult(
+            name="Target branch",
+            status=CheckStatus.PASS,
+            message=f"Branch is up to date with {target}.",
+        )
+    commit_word = "commit" if behind == 1 else "commits"
+    return CheckResult(
+        name="Target branch",
+        status=CheckStatus.FAIL,
+        message=f"Branch is {behind} {commit_word} behind {target}. "
+                f"Update your branch before opening a PR.",
+    )
+
+
+def run_checks(target: str) -> list[CheckResult]:
+    """Run all repository readiness checks."""
+    return [
+        check_git_repository(),
+        check_current_branch(),
+        check_working_tree(),
+        check_upstream_branch(),
+        check_target_branch(target),
+    ]

cli.py

@@ -0,0 +1,25 @@
+import argparse
+
+from checks import run_checks
+from output import display_results
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Check whether your Git branch is ready before pushing or opening a PR."
+    )
+
+    parser.add_argument(
+        "--target",
+        default="main",
+        help="Target branch to compare against (default: main)",
+    )
+
+    args = parser.parse_args()
+
+    results = run_checks(args.target)
+    display_results(results, args.target)
+
+
+if __name__ == "__main__":
+    main()

git.py

@@ -0,0 +1,60 @@
+import subprocess
+
+
+def run_git_command(*args: str) -> str:
+    """Run a Git command and return its output."""
+    result = subprocess.run(
+        ["git", *args],
+        capture_output=True,
+        text=True,
+    )
+
+    if result.returncode != 0:
+        raise RuntimeError(result.stderr.strip())
+
+    return result.stdout.strip()
+
+
+def is_git_repository() -> bool:
+    """Check whether the current directory is a Git repository."""
+    result = subprocess.run(
+        ["git", "rev-parse", "--is-inside-work-tree"],
+        capture_output=True,
+        text=True,
+    )
+
+    return result.returncode == 0 and result.stdout.strip() == "true"
+
+
+def get_current_branch() -> str:
+    """Get the current branch name."""
+    return run_git_command("branch", "--show-current")
+
+
+def get_status() -> str:
+    """Get the repository status in porcelain format."""
+    return run_git_command("status", "--porcelain")
+
+
+def has_changes() -> bool:
+    """Check whether the working tree contains changes."""
+    return bool(get_status())
+
+def get_upstream_branch() -> str:
+    """Get the upstream branch configured for the current branch."""
+    return run_git_command(
+        "rev-parse",
+        "--abbrev-ref",
+        "--symbolic-full-name",
+        "@{u}",
+    )
+
+def get_behind_count(target: str) -> int:
+    """Return the number of commits the current branch is behind the target."""
+    output = run_git_command(
+        "rev-list",
+        "--count",
+        f"HEAD..{target}",
+    )
+
+    return int(output)

output.py

@@ -0,0 +1,153 @@
+import time
+
+from checks import CheckResult, CheckStatus
+from rich.console import Console
+from rich.panel import Panel
+from rich.text import Text
+
+console = Console()
+
+
+def print_header(target: str) -> None:
+    """Print the application header."""
+    title = Text()
+    title.append("BeforePush", style="bold cyan")
+    title.append("\nGit branch readiness check", style="dim")
+
+    console.print()
+    console.print(
+        Panel(
+            title,
+            border_style="bright_blue",
+            padding=(0, 2),
+        )
+    )
+
+    console.print(f"  [dim]Target[/dim]     [bold]{target}[/bold]")
+    console.print()
+
+
+def get_check_display(result: CheckResult) -> tuple[str, str]:
+    """Return the symbol and style for a check result."""
+    if result.status == CheckStatus.PASS:
+        return "✓", "green"
+
+    if result.status == CheckStatus.WARNING:
+        return "⚠", "yellow"
+
+    return "✗", "red"
+
+
+def print_check(result: CheckResult, animate: bool = True) -> None:
+    """Print a single check result."""
+    symbol, style = get_check_display(result)
+
+    if animate and console.is_terminal:
+        with console.status(
+            f"  [dim]Checking {result.name.lower()}...[/dim]",
+            spinner="dots",
+        ):
+            time.sleep(0.25)
+
+    console.print(
+        f"  [{style}]{symbol}[/{style}]  "
+        f"[bold]{result.name}[/bold]"
+    )
+    console.print(
+        f"     [dim]{result.message}[/dim]"
+    )
+    console.print()
+
+
+def print_summary(
+    results: list[CheckResult],
+) -> None:
+    """Print the final readiness summary."""
+    failed = sum(
+        result.status == CheckStatus.FAIL
+        for result in results
+    )
+
+    warnings = sum(
+        result.status == CheckStatus.WARNING
+        for result in results
+    )
+
+    console.print("  [dim]" + "─" * 44 + "[/dim]")
+    console.print()
+
+    if failed == 0 and warnings == 0:
+        summary = Text()
+        summary.append("✓ READY\n", style="bold green")
+        summary.append(
+            "All checks passed. Safe to push.",
+            style="green",
+        )
+
+        console.print(
+            Panel(
+                summary,
+                border_style="green",
+                padding=(0, 2),
+            )
+        )
+
+    else:
+        parts = []
+
+        if failed:
+            word = "check" if failed == 1 else "checks"
+            parts.append(f"{failed} {word} failed")
+
+        if warnings:
+            word = "warning" if warnings == 1 else "warnings"
+            parts.append(f"{warnings} {word}")
+
+        summary = Text()
+        summary.append("✗ NOT READY\n", style="bold red")
+        summary.append(
+            f"{' · '.join(parts)}.",
+            style="red",
+        )
+
+        console.print(
+            Panel(
+                summary,
+                border_style="red",
+                padding=(0, 2),
+            )
+        )
+
+    console.print()
+
+
+def print_results(
+    results: list[CheckResult],
+) -> None:
+    """Print all check results and the final status."""
+    console.print("  [bold]Checks[/bold]")
+    console.print()
+
+    animate = console.is_terminal
+
+    for result in results:
+        print_check(result, animate=animate)
+
+    print_summary(results)
+
+
+def display_results(
+    results: list[CheckResult],
+    target: str,
+) -> None:
+    """Display the complete check report."""
+    print_header(target)
+
+    if console.is_terminal:
+        with console.status(
+            "[bold cyan]Running checks...[/bold cyan]",
+            spinner="dots",
+        ):
+            time.sleep(0.5)
+
+    print_results(results)