gx-git 0.1.0__tar.gz

gx_git-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,45 @@
+name: CI
+
+on:
+  push:
+    branches: [main, dev]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+      - run: pip install ruff mypy
+      - run: ruff check src/
+      - run: mypy src/gx/ --ignore-missing-imports
+
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os:
+          - ubuntu-latest
+          - ubuntu-24.04-arm
+          - macos-latest
+          - windows-latest
+          - windows-11-arm
+        python-version: ["3.9", "3.12", "3.13"]
+        exclude:
+          - os: windows-11-arm
+            python-version: "3.9"
+          - os: ubuntu-24.04-arm
+            python-version: "3.9"
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: gx --version
+      - run: gx --help
+      - run: python -m pytest tests/ -v

gx_git-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,57 @@
+name: Release & Publish
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+
+      - name: Get version from pyproject.toml
+        id: version
+        run: |
+          VERSION=$(grep '^version' pyproject.toml | head -1 | sed 's/.*"\(.*\)".*/\1/')
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "tag=v$VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Check if tag exists
+        id: check
+        run: |
+          if git rev-parse "v${{ steps.version.outputs.version }}" >/dev/null 2>&1; then
+            echo "exists=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "exists=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Create release
+        if: steps.check.outputs.exists == 'false'
+        run: |
+          gh release create "${{ steps.version.outputs.tag }}" \
+            --title "${{ steps.version.outputs.tag }}" \
+            --generate-notes
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      # Build and publish always run — skip-existing makes re-runs safe
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Build package
+        run: pip install build && python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true

gx_git-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+*.so
+.venv/
+venv/
+env/

gx_git-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gx contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gx_git-0.1.0/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: gx-git
+Version: 0.1.0
+Summary: Git Productivity Toolkit — 10 focused commands for daily git friction
+Project-URL: Homepage, https://github.com/mubbie/gx-cli
+Project-URL: Repository, https://github.com/mubbie/gx-cli
+Project-URL: Issues, https://github.com/mubbie/gx-cli/issues
+Author: Mubbie Idoko
+License: MIT
+License-File: LICENSE
+Keywords: cli,developer-tools,git,productivity
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Requires-Dist: rich>=13.0
+Requires-Dist: textual>=0.40
+Requires-Dist: typer>=0.9
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# gx — Git Productivity Toolkit
+
+A terminal-based Git utility that bundles 10 focused productivity commands into a single CLI.
+
+## Install
+
+```
+pipx install gx-git
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `gx undo` | Smart undo — figures out what to undo |
+| `gx redo` | Redo the last undo |
+| `gx who` | Who knows this code best |
+| `gx nuke` | Delete branches with confidence |
+| `gx recap` | What did I (or my team) do recently |
+| `gx sweep` | Clean up merged branches and stale refs |
+| `gx oops` | Quick-fix the last commit |
+| `gx context` | Repo status at a glance (alias: `gx ctx`) |
+| `gx drift` | How far you've diverged from the HEAD branch |
+| `gx switch` | Fuzzy branch switcher |
+| `gx conflicts` | Preview merge conflicts before merging |

gx_git-0.1.0/README.md

@@ -0,0 +1,25 @@
+# gx — Git Productivity Toolkit
+
+A terminal-based Git utility that bundles 10 focused productivity commands into a single CLI.
+
+## Install
+
+```
+pipx install gx-git
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `gx undo` | Smart undo — figures out what to undo |
+| `gx redo` | Redo the last undo |
+| `gx who` | Who knows this code best |
+| `gx nuke` | Delete branches with confidence |
+| `gx recap` | What did I (or my team) do recently |
+| `gx sweep` | Clean up merged branches and stale refs |
+| `gx oops` | Quick-fix the last commit |
+| `gx context` | Repo status at a glance (alias: `gx ctx`) |
+| `gx drift` | How far you've diverged from the HEAD branch |
+| `gx switch` | Fuzzy branch switcher |
+| `gx conflicts` | Preview merge conflicts before merging |

gx_git-0.1.0/pyproject.toml

@@ -0,0 +1,67 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "gx-git"
+version = "0.1.0"
+description = "Git Productivity Toolkit — 10 focused commands for daily git friction"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.9"
+authors = [
+    {name = "Mubbie Idoko"},
+]
+keywords = ["git", "cli", "productivity", "developer-tools"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Version Control :: Git",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "typer>=0.9",
+    "rich>=13.0",
+    "textual>=0.40",
+]
+
+[project.scripts]
+gx = "gx.main:app"
+
+[project.urls]
+Homepage = "https://github.com/mubbie/gx-cli"
+Repository = "https://github.com/mubbie/gx-cli"
+Issues = "https://github.com/mubbie/gx-cli/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/gx"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+]
+
+[tool.ruff]
+target-version = "py39"
+line-length = 120
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W"]
+
+[tool.mypy]
+python_version = "3.9"
+warn_return_any = true
+warn_unused_configs = true

gx_git-0.1.0/src/gx/__init__.py

@@ -0,0 +1,3 @@
+"""gx — Git Productivity Toolkit."""
+
+__version__ = "0.1.0"

gx_git-0.1.0/src/gx/commands/_switch_tui.py

@@ -0,0 +1,161 @@
+"""Textual TUI for gx switch — fuzzy branch picker."""
+
+from __future__ import annotations
+
+from textual import work
+from textual.app import App, ComposeResult
+from textual.containers import Vertical
+from textual.widgets import Footer, Header, Input, Static
+from textual.reactive import reactive
+
+from gx.utils.git import run_git, GitError, time_ago
+
+
+class BranchItem(Static):
+    """A single branch row."""
+
+    def __init__(self, branch: dict, **kwargs) -> None:
+        self.branch = branch
+        age = time_ago(branch["date"])
+        ahead_behind = branch.get("ahead_behind", "")
+        text = f"  {branch['name']:<35} {ahead_behind:<20} {age:<15} {branch['author']}"
+        super().__init__(text, **kwargs)
+        self.add_class("branch-item")
+
+    def on_click(self) -> None:
+        self.app.selected = self.branch["name"]
+        self.app.exit(self.branch["name"])
+
+
+class SwitchApp(App):
+    """Fuzzy branch picker TUI."""
+
+    CSS = """
+    Screen {
+        background: $surface;
+    }
+    #branch-list {
+        height: 1fr;
+        overflow-y: auto;
+    }
+    .branch-item {
+        height: 1;
+        padding: 0 1;
+    }
+    .branch-item:hover {
+        background: $accent;
+    }
+    .branch-item.highlighted {
+        background: $accent;
+        color: $text;
+    }
+    #search {
+        dock: bottom;
+        margin: 0 1;
+    }
+    #hint {
+        dock: bottom;
+        height: 1;
+        color: $text-muted;
+        text-align: center;
+    }
+    """
+
+    BINDINGS = [
+        ("escape", "quit", "Cancel"),
+        ("up", "move_up", "Up"),
+        ("down", "move_down", "Down"),
+        ("enter", "select", "Select"),
+    ]
+
+    selected: str | None = None
+    highlight_index: reactive[int] = reactive(0)
+
+    def __init__(self, branches: list[dict], head_branch: str) -> None:
+        super().__init__()
+        self.all_branches = branches
+        self.filtered_branches = list(branches)
+        self.head_branch = head_branch
+
+    def compose(self) -> ComposeResult:
+        yield Header(show_clock=False)
+        yield Vertical(id="branch-list")
+        yield Input(placeholder="Type to filter branches...", id="search")
+        yield Static("\u2191\u2193 Navigate  Enter Select  Esc Cancel", id="hint")
+
+    def on_mount(self) -> None:
+        self._render_branches()
+        self._load_ahead_behind()
+        self.query_one("#search", Input).focus()
+
+    def _render_branches(self) -> None:
+        container = self.query_one("#branch-list", Vertical)
+        container.remove_children()
+        for i, branch in enumerate(self.filtered_branches):
+            item = BranchItem(branch, id=f"branch-{i}")
+            if i == self.highlight_index:
+                item.add_class("highlighted")
+            container.mount(item)
+
+    def on_input_changed(self, event: Input.Changed) -> None:
+        query = event.value.lower()
+        if query:
+            self.filtered_branches = [
+                b for b in self.all_branches
+                if query in b["name"].lower()
+            ]
+        else:
+            self.filtered_branches = list(self.all_branches)
+        self.highlight_index = 0
+        self._render_branches()
+
+    def watch_highlight_index(self, old: int, new: int) -> None:
+        # Update highlighting
+        container = self.query_one("#branch-list", Vertical)
+        children = list(container.children)
+        if 0 <= old < len(children):
+            children[old].remove_class("highlighted")
+        if 0 <= new < len(children):
+            children[new].add_class("highlighted")
+            children[new].scroll_visible()
+
+    def action_move_up(self) -> None:
+        if self.highlight_index > 0:
+            self.highlight_index -= 1
+
+    def action_move_down(self) -> None:
+        if self.highlight_index < len(self.filtered_branches) - 1:
+            self.highlight_index += 1
+
+    def action_select(self) -> None:
+        if self.filtered_branches:
+            idx = min(self.highlight_index, len(self.filtered_branches) - 1)
+            self.selected = self.filtered_branches[idx]["name"]
+            self.exit(self.selected)
+
+    def action_quit(self) -> None:
+        self.selected = None
+        self.exit(None)
+
+    @work(thread=True)
+    def _load_ahead_behind(self) -> None:
+        """Load ahead/behind counts in background."""
+        for branch in self.all_branches:
+            try:
+                ab = run_git([
+                    "rev-list", "--left-right", "--count",
+                    f"{branch['name']}...{self.head_branch}"
+                ])
+                ahead, behind = ab.split()
+                branch["ahead_behind"] = f"{ahead} ahead, {behind} behind"
+            except (GitError, ValueError):
+                branch["ahead_behind"] = ""
+
+        self.call_from_thread(self._render_branches)
+
+
+def run_switch_tui(branches: list[dict], head_branch: str) -> str | None:
+    """Run the Textual TUI and return the selected branch name."""
+    app = SwitchApp(branches, head_branch)
+    result = app.run()
+    return result