octotui 0.1.1__tar.gz

octotui-0.1.1/.gitignore

@@ -0,0 +1,22 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+.coverage
+
+# Session memory
+.puppy_session_memory.json
+
+# Pytest cache
+.pytest_cache/
+
+dummy_path
+
+.idea/

octotui-0.1.1/PKG-INFO

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: octotui
+Version: 0.1.1
+Summary: A blazing-fast TUI replacement for GitKraken - manage your Git repos with style!
+Project-URL: Repository, https://github.com/never-use-gui/octotui
+Project-URL: Homepage, https://github.com/never-use-gui/octotui
+Project-URL: Bug Tracker, https://github.com/never-use-gui/octotui/issues
+Author-email: Michael Pfaffenberger <michael@pfaffenberger.dev>
+License: MIT
+Keywords: git,gitkraken,terminal,textual,tui,version-control
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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 :: Terminals
+Requires-Python: >=3.11
+Requires-Dist: gac>0.18.0
+Requires-Dist: gitpython>=3.1.42
+Requires-Dist: pyfiglet>=1.0.2
+Requires-Dist: textual>=6.1.0
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+<img src="cute-octo.png" alt="OctoTUI Logo" width="300">
+
+# 🐙 OctoTUI
+
+
+[![PyPI version](https://img.shields.io/pypi/v/octotui.svg)](https://pypi.org/project/octotui/)
+[![Python](https://img.shields.io/pypi/pyversions/octotui.svg)](https://pypi.org/project/octotui/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)
+
+**A Textual TUI For GitKraken Lovers** 
+ 
+[Installation](#-installation) • [AI Commits](#-ai-powered-commits) • [Keybindings](#️-keybindings)
+
+</div>
+
+---
+
+## 🚀 OctoTUI
+
+> **We love GitKraken so much, we wanted to bring that beautiful experience to the terminal!**
+
+GitKraken is amazing - it's gorgeous, intuitive, and makes Git feel approachable. But as terminal enthusiasts, we found ourselves constantly context-switching between our editor and GitKraken. We wanted that same delightful experience without ever leaving the command line.
+
+**OctoTUI is our love letter to both GitKraken and the terminal.**
+
+### 💙 What We Kept from GitKraken
+- ✅ Beautiful, intuitive visual diffs
+- ✅ Hunk-level staging control
+- ✅ Branch visualization and management
+- ✅ Commit history browsing
+
+### 🎯 What We Added for Terminal Lovers
+- 🤖 AI-powered commit messages (via GAC)
+- 🆓 100% free and open source
+- 🏠 Never leave your terminal flow
+
+## 📦 Installation
+
+### Quick Start (Recommended)
+
+```bash
+# Using uvx (isolated, recommended)
+uvx octotui
+```
+
+### From Source (For Contributors)
+
+```bash
+git clone https://github.com/never-use-gui/octotui.git
+cd octotui
+uv run octotui
+```
+
+### System Requirements
+
+- 🐍 Python 3.11+
+- 🔧 Git
+- 💻 Any terminal with 256+ colors
+
+
+### First-Time Workflow
+
+1. **Review Changes**: See your diffs in beautiful color
+2. **Stage Hunks**: Click or use `s` to stage individual changes
+3. **Generate Commit**: Press `g` for AI-powered message (optional)
+4. **Commit**: Press `c` to commit with your message
+5. **Push**: Press `p` to push to remote
+
+**Pro tip**: Press `h` anytime to see all available keybindings! 🚀
+
+## 🤖 AI-Powered Commits
+
+### Setup (Optional but Awesome)
+
+```bash
+# Install GAC (Git Auto Commit)
+uv pip install 'gac>=0.18.0'
+```
+
+### Configuration
+
+1. Press `Ctrl+G` in OctoTUI
+2. Choose your provider (we recommend **Cerebras** for free tier)
+3. Select your model
+4. Paste your API key
+5. Save & enjoy AI commit messages!
+
+## ⌨️ Keybindings
+
+### 📁 Navigation
+| Key | Action |
+|-----|--------|
+| `↑/↓` | Navigate files/hunks |
+| `Enter` | Select file |
+| `Tab` / `Shift+Tab` | Cycle through UI elements |
+| `1` / `Ctrl+1` | Switch to Unstaged tab |
+| `2` / `Ctrl+2` | Switch to Staged tab |
+
+### 🔄 Git Operations
+| Key | Action |
+|-----|--------|
+| `s` | Stage selected file |
+| `u` | Unstage selected file |
+| `a` | Stage ALL unstaged changes |
+| `x` | Unstage ALL staged changes |
+| `c` | Commit staged changes |
+
+### 🌿 Branch & Remote
+| Key | Action |
+|-----|--------|
+| `b` | Switch branch |
+| `r` | Refresh status |
+| `p` | Push to remote |
+| `o` | Pull from remote |
+
+### 🤖 AI Features
+| Key | Action |
+|-----|--------|
+| `g` | Generate AI commit message |
+| `Ctrl+G` | Configure GAC settings |
+
+### ⚙️ Application
+| Key | Action |
+|-----|--------|
+| `h` | Show help modal |
+| `q` | Quit application |
+| `Ctrl+D` | Toggle dark mode |
+
+## 🎨 Git Status Colors
+
+| Color | Meaning |
+|-------|----------|
+| 🟢 **Green** | Staged files (ready to commit) |
+| 🟡 **Yellow** | Modified files (unstaged) |
+| 🔵 **Blue** | Directories |
+| 🟣 **Purple** | Untracked files |
+| 🔴 **Red** | Deleted files |
+
+### Code Quality Standards
+
+- ✅ Follow the Zen of Python
+- ✅ DRY (Don't Repeat Yourself)
+- ✅ YAGNI (You Aren't Gonna Need It)
+- ✅ SOLID principles
+- ✅ Keep files under 600 lines
+- ✅ Write tests for new features
+- ✅ Pass `ruff check` with zero errors
+
+## 📚 Tech Stack
+
+- **[Textual](https://textual.textualize.io/)**: Modern TUI framework
+- **[GitPython](https://gitpython.readthedocs.io/)**: Git operations
+- **[GAC](https://github.com/Dicklesworthstone/gac)**: AI commit generation
+- **[Ruff](https://github.com/astral-sh/ruff)**: Lightning-fast Python linter
+
+## 📜 License
+
+MIT License - see [LICENSE](LICENSE) for details
+
+## 🙏 Acknowledgments
+
+- Built with ❤️ using [Textual](https://textual.textualize.io/)
+- AI commits powered by [GAC](https://github.com/cellweb/gac)
+
+## 💬 Community
+
+- 🐛 **Issues**: [GitHub Issues](https://github.com/never-use-gui/octotui/issues)
+---
+
+<div align="center">
+
+### 🌟 If you like OctoTUI, give us a star! 🌟
+
+[⬆ Back to Top](#-octotui)
+
+</div>

octotui-0.1.1/README.md

@@ -0,0 +1,180 @@
+<div align="center">
+
+<img src="cute-octo.png" alt="OctoTUI Logo" width="300">
+
+# 🐙 OctoTUI
+
+
+[![PyPI version](https://img.shields.io/pypi/v/octotui.svg)](https://pypi.org/project/octotui/)
+[![Python](https://img.shields.io/pypi/pyversions/octotui.svg)](https://pypi.org/project/octotui/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)
+
+**A Textual TUI For GitKraken Lovers** 
+ 
+[Installation](#-installation) • [AI Commits](#-ai-powered-commits) • [Keybindings](#️-keybindings)
+
+</div>
+
+---
+
+## 🚀 OctoTUI
+
+> **We love GitKraken so much, we wanted to bring that beautiful experience to the terminal!**
+
+GitKraken is amazing - it's gorgeous, intuitive, and makes Git feel approachable. But as terminal enthusiasts, we found ourselves constantly context-switching between our editor and GitKraken. We wanted that same delightful experience without ever leaving the command line.
+
+**OctoTUI is our love letter to both GitKraken and the terminal.**
+
+### 💙 What We Kept from GitKraken
+- ✅ Beautiful, intuitive visual diffs
+- ✅ Hunk-level staging control
+- ✅ Branch visualization and management
+- ✅ Commit history browsing
+
+### 🎯 What We Added for Terminal Lovers
+- 🤖 AI-powered commit messages (via GAC)
+- 🆓 100% free and open source
+- 🏠 Never leave your terminal flow
+
+## 📦 Installation
+
+### Quick Start (Recommended)
+
+```bash
+# Using uvx (isolated, recommended)
+uvx octotui
+```
+
+### From Source (For Contributors)
+
+```bash
+git clone https://github.com/never-use-gui/octotui.git
+cd octotui
+uv run octotui
+```
+
+### System Requirements
+
+- 🐍 Python 3.11+
+- 🔧 Git
+- 💻 Any terminal with 256+ colors
+
+
+### First-Time Workflow
+
+1. **Review Changes**: See your diffs in beautiful color
+2. **Stage Hunks**: Click or use `s` to stage individual changes
+3. **Generate Commit**: Press `g` for AI-powered message (optional)
+4. **Commit**: Press `c` to commit with your message
+5. **Push**: Press `p` to push to remote
+
+**Pro tip**: Press `h` anytime to see all available keybindings! 🚀
+
+## 🤖 AI-Powered Commits
+
+### Setup (Optional but Awesome)
+
+```bash
+# Install GAC (Git Auto Commit)
+uv pip install 'gac>=0.18.0'
+```
+
+### Configuration
+
+1. Press `Ctrl+G` in OctoTUI
+2. Choose your provider (we recommend **Cerebras** for free tier)
+3. Select your model
+4. Paste your API key
+5. Save & enjoy AI commit messages!
+
+## ⌨️ Keybindings
+
+### 📁 Navigation
+| Key | Action |
+|-----|--------|
+| `↑/↓` | Navigate files/hunks |
+| `Enter` | Select file |
+| `Tab` / `Shift+Tab` | Cycle through UI elements |
+| `1` / `Ctrl+1` | Switch to Unstaged tab |
+| `2` / `Ctrl+2` | Switch to Staged tab |
+
+### 🔄 Git Operations
+| Key | Action |
+|-----|--------|
+| `s` | Stage selected file |
+| `u` | Unstage selected file |
+| `a` | Stage ALL unstaged changes |
+| `x` | Unstage ALL staged changes |
+| `c` | Commit staged changes |
+
+### 🌿 Branch & Remote
+| Key | Action |
+|-----|--------|
+| `b` | Switch branch |
+| `r` | Refresh status |
+| `p` | Push to remote |
+| `o` | Pull from remote |
+
+### 🤖 AI Features
+| Key | Action |
+|-----|--------|
+| `g` | Generate AI commit message |
+| `Ctrl+G` | Configure GAC settings |
+
+### ⚙️ Application
+| Key | Action |
+|-----|--------|
+| `h` | Show help modal |
+| `q` | Quit application |
+| `Ctrl+D` | Toggle dark mode |
+
+## 🎨 Git Status Colors
+
+| Color | Meaning |
+|-------|----------|
+| 🟢 **Green** | Staged files (ready to commit) |
+| 🟡 **Yellow** | Modified files (unstaged) |
+| 🔵 **Blue** | Directories |
+| 🟣 **Purple** | Untracked files |
+| 🔴 **Red** | Deleted files |
+
+### Code Quality Standards
+
+- ✅ Follow the Zen of Python
+- ✅ DRY (Don't Repeat Yourself)
+- ✅ YAGNI (You Aren't Gonna Need It)
+- ✅ SOLID principles
+- ✅ Keep files under 600 lines
+- ✅ Write tests for new features
+- ✅ Pass `ruff check` with zero errors
+
+## 📚 Tech Stack
+
+- **[Textual](https://textual.textualize.io/)**: Modern TUI framework
+- **[GitPython](https://gitpython.readthedocs.io/)**: Git operations
+- **[GAC](https://github.com/Dicklesworthstone/gac)**: AI commit generation
+- **[Ruff](https://github.com/astral-sh/ruff)**: Lightning-fast Python linter
+
+## 📜 License
+
+MIT License - see [LICENSE](LICENSE) for details
+
+## 🙏 Acknowledgments
+
+- Built with ❤️ using [Textual](https://textual.textualize.io/)
+- AI commits powered by [GAC](https://github.com/cellweb/gac)
+
+## 💬 Community
+
+- 🐛 **Issues**: [GitHub Issues](https://github.com/never-use-gui/octotui/issues)
+---
+
+<div align="center">
+
+### 🌟 If you like OctoTUI, give us a star! 🌟
+
+[⬆ Back to Top](#-octotui)
+
+</div>

octotui-0.1.1/octotui/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

octotui-0.1.1/octotui/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for running octotui as a module."""
+
+from octotui.main import main
+
+if __name__ == "__main__":
+    main()

octotui-0.1.1/octotui/diff_markdown.py

@@ -0,0 +1,187 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from functools import lru_cache
+from pathlib import Path
+from typing import Iterable, List, Optional
+
+from pygments.lexers import get_lexer_for_filename, guess_lexer
+from pygments.util import ClassNotFound
+from textual.content import Content
+from textual.widgets import Markdown
+from textual.widgets._markdown import MarkdownFence
+
+from .git_status_sidebar import Hunk
+
+
+@dataclass(slots=True)
+class DiffMarkdownConfig:
+    """Configuration for how a diff hunk should be rendered."""
+
+    repo_root: Path
+    wrap: bool = False
+    prefer_diff_language: bool = False
+    code_block_theme: str = "tokyo-night"
+    show_headers: bool = False
+
+
+class DiffMarkdownFence(MarkdownFence):
+    """Fenced code block that decorates diff lines with background highlights."""
+
+    ADDITION_CLASS = ".diff-line--addition"
+    REMOVAL_CLASS = ".diff-line--removal"
+    ADDITION_STYLE = "on rgba(158, 206, 106, 0.45)"
+    REMOVAL_STYLE = "on rgba(140, 74, 126, 0.45)"
+
+    @classmethod
+    def highlight(cls, code: str, language: str) -> Content:
+        """Apply syntax highlighting and add diff-aware line highlights."""
+        content = super().highlight(code, language)
+        if not content:
+            return content
+
+        plain = content.plain
+        if not plain:
+            return content
+
+        cursor = 0
+        for line in plain.splitlines(keepends=True):
+            # Retain the newline so the highlight matches the selection effect.
+            marker = line[:1]
+            if marker == "+" and not line.startswith("+++"):
+                start, end = cursor, cursor + len(line)
+                content = content.stylize(cls.ADDITION_CLASS, start, end)
+                content = content.stylize(cls.ADDITION_STYLE, start, end)
+            elif marker == "-" and not line.startswith("---"):
+                start, end = cursor, cursor + len(line)
+                content = content.stylize(cls.REMOVAL_CLASS, start, end)
+                content = content.stylize(cls.REMOVAL_STYLE, start, end)
+            cursor += len(line)
+        return content
+
+
+class DiffMarkdown(Markdown):
+    """Markdown widget specialised for unified diff hunks with syntax highlighting.
+
+    The widget converts hunk headers and line payloads into a fenced Markdown block.
+    It attempts to strike a balance between diff semantics (+/- context) and
+    per-language syntax highlighting by dynamically picking an appropriate lexer.
+    """
+
+    BLOCKS = {
+        **Markdown.BLOCKS,
+        "fence": DiffMarkdownFence,
+        "code_block": DiffMarkdownFence,
+    }
+
+    DEFAULT_CSS = """
+    DiffMarkdown {
+        background: transparent;
+        border: none;
+        &:dark .diff-line--addition {
+            background: rgb(158, 206, 106);
+        }
+        &:light .diff-line--addition {
+            background: rgb(200, 230, 180);
+        }
+        &:dark .diff-line--removal {
+            background: rgb(140, 74, 126);
+        }
+        &:light .diff-line--removal {
+            background: rgb(200, 140, 180);
+        }
+    }
+    """
+
+    def __init__(
+        self,
+        file_path: str,
+        hunks: Iterable[Hunk],
+        *,
+        config: Optional[DiffMarkdownConfig] = None,
+    ) -> None:
+        self._file_path = file_path
+        self._config = config or DiffMarkdownConfig(repo_root=Path.cwd())
+        self._hunks_cache = list(hunks)
+        markdown_text = self._build_markdown(self._hunks_cache)
+        super().__init__(markdown_text)
+        if hasattr(self, "inline_code_theme"):
+            self.inline_code_theme = self._config.code_block_theme
+
+    def _build_markdown(self, hunks: List[Hunk]) -> str:
+        """Construct the Markdown payload that encodes diff and syntax info."""
+        header_lines: List[str] = ["<!-- Octotui DiffMarkdown -->"]
+
+        if not hunks:
+            return "\n".join(header_lines + ["_No changes to display._"])
+
+        language = self._detect_language()
+        fence_language = (
+            "diff" if self._config.prefer_diff_language else language or "diff"
+        )
+
+        for hunk in hunks:
+            if self._config.show_headers:
+                header_lines.append(f"### `{hunk.header or 'File contents'}`")
+            header_lines.append(self._render_hunk_block(hunk, fence_language))
+
+        return "\n\n".join(header_lines)
+
+    def _render_hunk_block(self, hunk: Hunk, fence_language: str) -> str:
+        """Render a single hunk of diff lines inside a fenced Markdown block."""
+        fence_lines: List[str] = [f"```{fence_language}"]
+        for line in hunk.lines:
+            fence_lines.append(self._normalise_line(line))
+        fence_lines.append("```")
+        return "\n".join(fence_lines)
+
+    def _normalise_line(self, line: str) -> str:
+        """Ensure markdown is well-formed while preserving diff semantics."""
+        if not line:
+            return ""
+
+        escaped = line.replace("```", "`\u200b``")
+        return escaped
+
+    def _detect_language(self) -> Optional[str]:
+        """Best-effort inference of the target language for syntax highlighting."""
+        file_path = self._file_path
+        full_path = self._config.repo_root / file_path
+
+        try:
+            lexer = _get_cached_lexer(str(full_path))
+            return lexer.aliases[0] if lexer.aliases else lexer.name.lower()
+        except ClassNotFound:
+            pass
+        except FileNotFoundError:
+            pass
+
+        sample = self._collect_sample()
+        if not sample:
+            return None
+
+        try:
+            lexer = guess_lexer(sample)
+            return lexer.aliases[0] if lexer.aliases else lexer.name.lower()
+        except ClassNotFound:
+            return None
+
+    def _collect_sample(self) -> str:
+        """Gather a short sample of code from the hunks to feed into pygments."""
+        snippets: List[str] = []
+        for hunk in self._hunks_cache:
+            for line in hunk.lines:
+                if line and line[:1] in {"+", "-", " "}:
+                    snippets.append(line[1:])
+                else:
+                    snippets.append(line)
+                if len("\n".join(snippets)) > 2048:
+                    break
+            if len("\n".join(snippets)) > 2048:
+                break
+        return "\n".join(snippets)
+
+
+@lru_cache(maxsize=128)
+def _get_cached_lexer(file_path: str):
+    return get_lexer_for_filename(file_path)