gitux 0.1.0__tar.gz

gitux-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,60 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run tests
+        run: uv run pytest -q
+
+  build:
+    needs: [test]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build package
+        run: uv build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: [build]
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      # Required for Trusted Publishing (OIDC) — no API token needed.
+      id-token: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

gitux-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Docs
+docs/
+DESIGN.md
+
+# Opencode
+.opencode/
+AGENTS.md

gitux-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

gitux-0.1.0/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.

gitux-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,143 @@
+# 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/main.py

@@ -0,0 +1,5 @@
+"""Legacy entry point - use 'uv run gitux' instead."""
+
+from gitux.cli import app
+
+app()

gitux-0.1.0/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "gitux"
+dynamic = ["version"]
+description = "A beautiful, minimalist TUI for Git."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Hector-2710" },
+]
+keywords = ["git", "tui", "terminal", "textual", "developer-tools", "version-control"]
+requires-python = ">=3.12"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Version Control :: Git",
+    "Topic :: Terminals",
+]
+dependencies = [
+    "psutil>=7.2.2",
+    "textual>=8.2.8",
+    "typer>=0.27.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.24.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Hector-2710/gitux"
+Repository = "https://github.com/Hector-2710/gitux"
+Issues = "https://github.com/Hector-2710/gitux/issues"
+Changelog = "https://github.com/Hector-2710/gitux/releases"
+
+[project.scripts]
+gitux = "gitux.cli:main"
+
+[tool.hatch.version]
+path = "src/gitux/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/gitux"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]