gitux 0.1.0__py3-none-any.whl

gitux/ui/widgets/repo_stats_bar.py

@@ -0,0 +1,212 @@
+"""Repo stats bar — one-line repository statistics below the top app bar."""
+
+import time
+from typing import Any
+
+from rich.cells import cell_len
+from rich.text import Text
+from textual.widgets import Static
+
+from gitux.domain import FileCounts, HeadSummary
+
+_MAX_USER_CHARS: int = 16
+_MAX_REPO_CHARS: int = 32
+_MAX_REMOTE_CHARS: int = 32
+_MAX_HEAD_SUBJECT_CHARS: int = 40
+_DEFAULT_RENDER_WIDTH: int = 200  # unmounted fallback so bare _render_text() is full
+_PADDING_COLS: int = 2  # matches `padding: 0 1` on #stats-bar
+
+# drop priority, LOWEST first (head is never dropped)
+_SEGMENT_PRIORITY: tuple[str, ...] = ("ahead_behind", "remote", "repo", "user", "files", "date", "head")
+
+_PREFIX_CELLS: int = 13  # " ■ REPO STATS"
+_SEPARATOR_CELLS: int = 3  # " │ "
+
+
+def _format_relative_time(epoch: int, *, now: float | None = None) -> str:
+    """Format an epoch seconds as a relative English string (floor division)."""
+    now = time.time() if now is None else now
+    delta = max(0, int(now - epoch))
+    if delta < 60:
+        return "just now"
+    if delta < 90:
+        return "1 minute ago"
+    if delta < 2700:
+        return f"{delta // 60} minutes ago"
+    if delta < 5400:
+        return "1 hour ago"
+    if delta < 86400:
+        return f"{delta // 3600} hours ago"
+    if delta < 129600:
+        return "1 day ago"
+    if delta < 604800:
+        return f"{delta // 86400} days ago"
+    if delta < 2592000:
+        return f"{delta // 604800} weeks ago"
+    if delta < 31536000:
+        return f"{delta // 2592000} months ago"
+    return f"{delta // 31536000} years ago"
+
+
+class RepoStatsBar(Static):
+    """Single-line stats bar fed by ``GituxApp._refresh_all``.
+
+    Renders: `` ■ REPO STATS │ user │ hash subject │ date │ +s ~m ?u [!c] │ ↑a ↓b │ remote``.
+    Uses hybrid B3 truncation: hard caps + width-adaptive segment drop.
+    """
+
+    def __init__(self, **kwargs) -> None:
+        super().__init__("", **kwargs)
+        self._user: str = ""
+        self._head_summary: HeadSummary | None = None
+        self._file_counts: FileCounts | None = None
+        self._ahead = 0
+        self._behind = 0
+        self._remote = "(local)"
+        self._remote_branch = ""
+        self._repo_name: str = ""
+
+    def update_stats(
+        self,
+        user: str = "",
+        head_summary: HeadSummary | None = None,
+        file_counts: FileCounts | None = None,
+        ahead: int = 0,
+        behind: int = 0,
+        remote: str = "(local)",
+        remote_branch: str = "",
+        repo_name: str = "",
+    ) -> None:
+        """Render the stats bar with the given repo state (safe defaults included)."""
+        self._remote = remote or "(local)"
+        self._remote_branch = remote_branch if remote else ""
+        self._user = user
+        self._head_summary = head_summary
+        self._file_counts = file_counts
+        self._ahead = ahead
+        self._behind = behind
+        self._repo_name = repo_name
+        self.update(self._render_text())
+
+    def _build_segments(self) -> list[dict[str, Any]]:
+        """Build segments in locked visual order with text, style, and drop info."""
+        segments: list[dict[str, Any]] = []
+
+        if self._repo_name:
+            segments.append({
+                "name": "repo",
+                "plain": self._repo_name[:_MAX_REPO_CHARS],
+                "style": "bold #e4e1ed",
+            })
+
+        segments.append({
+            "name": "user",
+            "plain": (self._user or "unknown")[:_MAX_USER_CHARS],
+            "style": "#e4e1ed",
+        })
+
+        summary = self._head_summary
+        if summary is None:
+            segments.append({
+                "name": "head",
+                "plain": "(no commits)",
+                "hash": "",
+                "subject": "(no commits)",
+                "style": "#e4e1ed",
+            })
+        else:
+            subject = summary.subject
+            if len(subject) > _MAX_HEAD_SUBJECT_CHARS:
+                subject = subject[: _MAX_HEAD_SUBJECT_CHARS - 1] + "\u2026"
+            segments.append({
+                "name": "head",
+                "plain": subject,
+                "hash": "",
+                "subject": subject,
+                "style": "#e4e1ed",
+            })
+
+        if summary is not None:
+            segments.append({
+                "name": "date",
+                "plain": _format_relative_time(summary.epoch),
+                "style": "#c7c4d7",
+            })
+
+        counts = self._file_counts or FileCounts(0, 0, 0, 0)
+        files = f"+{counts.staged} ~{counts.modified} ?{counts.untracked}"
+        if counts.conflicts > 0:
+            files += f" !{counts.conflicts}"
+        segments.append({
+            "name": "files",
+            "plain": files,
+            "style": "#c7c4d7",
+        })
+
+        segments.append({
+            "name": "ahead_behind",
+            "plain": f"\u2191{self._ahead} \u2193{self._behind}",
+            "style": "bold #c0c1ff",
+        })
+
+        remote_slug = (
+            f"{self._remote}/{self._remote_branch}" if self._remote_branch else self._remote
+        )
+        segments.append({
+            "name": "remote",
+            "plain": remote_slug[:_MAX_REMOTE_CHARS],
+            "style": "#e4e1ed",
+        })
+
+        return segments
+
+    def _total_cells(self, segments: list[dict[str, Any]]) -> int:
+        """Total rendered cell width of all segments plus prefix and separators."""
+        return (
+            _PREFIX_CELLS
+            + sum(cell_len(seg["plain"]) for seg in segments)
+            + _SEPARATOR_CELLS * (len(segments) - 1)
+        )
+
+    def _fit_segments(self, segments: list[dict[str, Any]], width: int) -> list[dict[str, Any]]:
+        """Drop lowest-priority segments, then elide the head subject to fit width."""
+        total = self._total_cells(segments)
+        while total > width and len(segments) > 1:
+            droppable = [seg for seg in segments if seg["name"] != "head"]
+            if not droppable:
+                break
+            to_drop = min(droppable, key=lambda seg: _SEGMENT_PRIORITY.index(seg["name"]))
+            segments.remove(to_drop)
+            total = self._total_cells(segments)
+
+        if len(segments) == 1 and total > width:
+            head = segments[0]
+            hash_len = cell_len(head["hash"])
+            avail = width - _PREFIX_CELLS - hash_len - 1
+            if avail < 1:
+                if head["hash"]:
+                    head["plain"] = head["hash"]
+                else:
+                    head["plain"] = head["plain"][: max(0, width - _PREFIX_CELLS)]
+            else:
+                elided = head["subject"][: avail - 1] + "\u2026"
+                head["plain"] = (
+                    f"{head['hash']} {elided}" if head["hash"] else elided
+                )
+        return segments
+
+    def _render_text(self, width: int | None = None) -> Text:
+        """Render the stats line, dropping segments to fit the given width."""
+        if width is None:
+            width = self.size.width - _PADDING_COLS if self.is_mounted else 0
+        if width <= 0:
+            width = _DEFAULT_RENDER_WIDTH
+        segments = self._build_segments()
+        segments = self._fit_segments(segments, width)
+
+        text = Text(no_wrap=True)
+        text.append(" \u25a0 REPO STATS", style="bold #c0c1ff")
+        for seg in segments:
+            text.append(" \u2502 ", style="#c7c4d7")
+            text.append(seg["plain"], style=seg["style"])
+        return text

gitux/utils/__init__.py

@@ -0,0 +1 @@
+"""Utility functions, config, and exceptions."""

gitux-0.1.0.dist-info/METADATA

@@ -0,0 +1,174 @@
+Metadata-Version: 2.5
+Name: gitux
+Version: 0.1.0
+Summary: A beautiful, minimalist TUI for Git.
+Project-URL: Homepage, https://github.com/Hector-2710/gitux
+Project-URL: Repository, https://github.com/Hector-2710/gitux
+Project-URL: Issues, https://github.com/Hector-2710/gitux/issues
+Project-URL: Changelog, https://github.com/Hector-2710/gitux/releases
+Author: Hector-2710
+License-Expression: MIT
+License-File: LICENSE
+Keywords: developer-tools,git,terminal,textual,tui,version-control
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Terminals
+Requires-Python: >=3.12
+Requires-Dist: psutil>=7.2.2
+Requires-Dist: textual>=8.2.8
+Requires-Dist: typer>=0.27.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# GITUX
+
+[![PyPI version](https://img.shields.io/pypi/v/gitux.svg)](https://pypi.org/project/gitux/)
+[![Python versions](https://img.shields.io/pypi/pyversions/gitux.svg)](https://pypi.org/project/gitux/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/Hector-2710/gitux/blob/main/LICENSE)
+
+A beautiful, minimalist TUI for Git.
+
+GITUX is a terminal user interface for Git that prioritizes design and user experience. It wraps Git commands in a clean, visually appealing interface — so you can work with Git without leaving the terminal, and enjoy doing it.
+
+## Why GITUX?
+
+Most Git TUIs are functional but not beautiful. GITUX is built with the belief that developer tools should be both powerful and pleasant to look at.
+
+- **Minimalist** — No clutter, no overwhelming menus. Just what you need.
+- **Beautiful** — Clean colors, thoughtful spacing, modern aesthetics.
+- **Fast** — Direct subprocess calls to Git, no heavy abstractions.
+
+## Features
+
+- View repository status with color-coded file states
+- Browse commit history with details
+- Stage and commit files with messages
+- View diffs between files
+- Manage branches (create, switch, delete)
+- Merge branches
+- Push to remote
+- Performance metrics (startup time, memory usage)
+
+## Installation
+
+**Recommended — with [pipx](https://pipx.pypa.io/) or [uv](https://docs.astral.sh/uv/) (isolated install):**
+
+```bash
+# With pipx
+pipx install gitux
+
+# Or with uv
+uv tool install gitux
+```
+
+**Or with pip:**
+
+```bash
+pip install gitux
+```
+
+> **Requirements:** Python 3.12+ and `git` installed on your system.
+
+<details>
+<summary>Install from source (for development)</summary>
+
+```bash
+git clone https://github.com/Hector-2710/gitux.git
+cd gitux
+uv sync --all-extras
+uv run gitux
+```
+</details>
+
+## Usage
+
+Inside any Git repository, just run:
+
+```bash
+gitux
+
+# Show version
+gitux --version
+```
+
+### Keybindings
+
+| Key | Action |
+|-----|--------|
+| `Tab` | Next section (Files / Commits / Diff) |
+| `↑` / `↓` or `j` / `k` | Scroll active section |
+| `s` / `Enter` | Stage / unstage file |
+| `a` / `A` | Stage all / unstage all files |
+| `c` | Focus commit message |
+| `Ctrl+Enter` | Create commit |
+| `Ctrl+p` | Push to remote |
+| `r` | Refresh status |
+| `b` | Branches panel |
+| `?` | Show help |
+| `q` | Quit GITUX |
+
+## Stack
+
+| Component | Technology | Purpose |
+|-----------|------------|---------|
+| Language | Python 3.12+ | Core runtime |
+| TUI | Textual | Terminal interface with CSS styling |
+| CLI | Typer | Command-line entry point |
+| Git | subprocess + git CLI | Git operations |
+| Metrics | psutil | Performance measurement |
+
+## Development
+
+```bash
+# Install dev dependencies
+uv sync --all-extras
+
+# Run tests
+uv run pytest
+
+# Run linter
+uv run ruff check .
+
+# Format code
+uv run ruff format .
+```
+
+## Project Structure
+
+```
+gitux/
+├── src/
+│   └── gitux/
+│       ├── __init__.py
+│       ├── __main__.py
+│       ├── cli.py              # Typer entry point
+│       ├── domain/             # Data models
+│       ├── git/                # Git infrastructure
+│       ├── presenter/          # Business logic
+│       ├── ui/                 # Textual TUI
+│       ├── metrics/            # Performance metrics
+│       └── utils/              # Config, exceptions
+├── tests/
+│   ├── unit/
+│   ├── integration/
+│   └── e2e/
+├── docs/
+│   ├── context.md
+│   ├── container.md
+│   └── diagrams/
+├── pyproject.toml
+└── README.md
+```
+
+## License
+
+MIT

gitux-0.1.0.dist-info/RECORD

@@ -0,0 +1,32 @@
+gitux/__init__.py,sha256=ZtE4fY4VU33_y0OW_7530O4vAqxBRLt45K8zWxX8IbI,74
+gitux/__main__.py,sha256=75MHbiT5XYsOtCTWw1ju6L8Xz2zPxVJiMt27KL9baKI,117
+gitux/cli.py,sha256=1pLTZl5BKZS8Uy4s9V7_krorUwk9kkr_rVwi3rIJhsU,644
+gitux/domain/__init__.py,sha256=bGqvXT1enNUc4x55VP0c_mfOGZyhm52oe5uTAnfz_XU,747
+gitux/domain/models.py,sha256=ZkIhxXE57CEtOhcPFzsrR-rvHC1iof6swvc045-7bTA,4786
+gitux/git/__init__.py,sha256=33wGQqeWR0gvFkEOyBwcDSMCiNTglqrCVs2tUCMgTos,1151
+gitux/git/commands.py,sha256=OllqC0fm7Jd_xyW85C-qeLaW8IBSi29d92YwuWgvM7Y,12114
+gitux/git/exceptions.py,sha256=N7VAPdnLp-SX3QEaTZx0RhCLhzgdZsB-CWU9SkAKZGQ,230
+gitux/git/parser.py,sha256=AAOKhBfhXMkUVDPVFezRwr1ls5tuA_SsiFlGAxfxTtA,2444
+gitux/presenter/__init__.py,sha256=El3zvXJUr-YdwttEJVGUsS2U3aL-q-KVmKrBfhCOba8,223
+gitux/presenter/commit_presenter.py,sha256=_848SmJpI9VbIhmUaSNR9UyZUnma0cYrOK0k5Rk6g4k,3719
+gitux/presenter/repo_presenter.py,sha256=rMMNQfOEiObDhxUHGkXa6jJBAP3iivX6gnuzi4DSEjM,3889
+gitux/ui/__init__.py,sha256=80z8YKUTs8g7W6DueSYCDUFQsyonCJfwTFoxyzpQAKc,30
+gitux/ui/app.py,sha256=7rPaI3Pm1bIiR387W18daMNUyTFpSo85p4S8yl6fxgE,16680
+gitux/ui/gitux.tcss,sha256=v30PtisCxD3-EijS7bon7pw_97w11oz-BKoee0QsGE8,4941
+gitux/ui/widgets/__init__.py,sha256=vfXQoRgr5dDXUXBwh2BzUmHifDOlDV6mKOWKwCKdV0c,827
+gitux/ui/widgets/block_container.py,sha256=ligGTYr3V9vupZQs191muwh6SGWbE8Z9Xm3b5aeinpo,2210
+gitux/ui/widgets/branch_screen.py,sha256=YhwnJt1kbGbHo0UbT6WoSiVvJ5EdvmtvflMc62trjvo,2069
+gitux/ui/widgets/changed_files.py,sha256=ADTC0H9Rmf0ONOYCZvQyS6DOhcBwGGMqJXWzLuw5AU4,6833
+gitux/ui/widgets/commit_log.py,sha256=FvKhFFoje_eC18yYo0EN2GOXd25ybkkTMYUoiMtrn7o,6704
+gitux/ui/widgets/commit_screen.py,sha256=sLbnQlfEwRisK7E1u__6NDVjXS1pwQIrGNnsDQKUVGU,4120
+gitux/ui/widgets/diff_viewer.py,sha256=WxR9PQNgghHcTxXvwLToLhZrlvf9IJ-GEBiJhP7UoTg,4559
+gitux/ui/widgets/gitux_footer.py,sha256=XsoAOj9Lc17AGQ5j9InfiwWi39Lg690YH051LvcwY-Q,1513
+gitux/ui/widgets/header.py,sha256=ftwQCexmlp2aT-MS2vFPthVQc62dVwZehMA4B_A_CDI,2736
+gitux/ui/widgets/help_screen.py,sha256=fnuyMqKOAVED93LRi_BSn15OZg58pfwX99svRzPMdn8,2699
+gitux/ui/widgets/repo_stats_bar.py,sha256=SlPzgHqZho75HZDGNXOi1V6FpsW1oDwBI1Bi2uC3vCg,7464
+gitux/utils/__init__.py,sha256=PLILUN4DpXkq9aaU8KyZoL5z_UAZw8qGYMMcHXf8qUs,49
+gitux-0.1.0.dist-info/METADATA,sha256=fT13Xgn-qvwmCbrqfkv-Nthn36ieXCHubKcnnSXpwQ4,4834
+gitux-0.1.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+gitux-0.1.0.dist-info/entry_points.txt,sha256=pGB4oUGZz7AieLAwGrMUtFAWXm2gag2IcCi_wUho19k,41
+gitux-0.1.0.dist-info/licenses/LICENSE,sha256=pj_7arY6WRVNI7xLBUOxewGZGxorLPu6GpF-kLO0SSM,1068
+gitux-0.1.0.dist-info/RECORD,,

gitux-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any

gitux-0.1.0.dist-info/entry_points.txt

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

gitux-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hector-2710
+
+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.