Initial implementation of commit editor

Signed-off-by: Martin Prpič <martin.prpic@gmail.com>

Author: mprpic

.github/workflows/main.yml

@@ -0,0 +1,16 @@
+name: main.yml
+on: [ push, pull_request ]
+
+jobs:
+  tox:
+    name: Run Tox
+    steps:
+      - uses: actions/checkout@v2
+      - name: Run all envs
+        uses: fedora-python/tox-github-action@main
+        with:
+          tox_env: ${{ matrix.tox_env }}
+    strategy:
+      matrix:
+        tox_env: [ py311, py312, py313, lint, check-format, typecheck ]
+    runs-on: ubuntu-latest

.gitignore

@@ -98,7 +98,7 @@ ipython_config.py
 #   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
 #   This is especially recommended for binary packages to ensure reproducibility, and is more
 #   commonly ignored for libraries.
-#uv.lock
+uv.lock
 
 # poetry
 #   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
@@ -182,9 +182,9 @@ cython_debug/
 .abstra/
 
 # Visual Studio Code
-#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
 #  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
-#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  and can be added to the global gitignore or merged into this file. However, if you prefer,
 #  you could uncomment the following to ignore the entire vscode folder
 # .vscode/
 
@@ -205,3 +205,6 @@ cython_debug/
 marimo/_static/
 marimo/_lsp/
 __marimo__/
+
+# AI assistants
+.claude/settings.local.json

CLAUDE.md

@@ -0,0 +1,113 @@
+# Development Guide
+
+Read README.md to learn about this project.
+
+This document describes how to work with the commit-editor project.
+
+## Project Structure
+
+```
+src/commit_editor/
+├── __init__.py    # Package init with version
+├── cli.py         # CLI entry point (argparse)
+├── app.py         # Textual app, custom TextArea, StatusBar, MessageBar, wrap_line
+└── git.py         # Git integration (user.name, user.email, Signed-off-by)
+
+tests/
+├── conftest.py    # Pytest fixtures (temp_file, temp_file_with_content)
+├── test_app.py    # Integration tests using Textual's Pilot
+├── test_git.py    # Unit tests for git module (mocked subprocess)
+└── test_wrap.py   # Unit tests for text wrapping functions
+```
+
+## Setup
+
+Install dependencies:
+
+```bash
+uv sync
+```
+
+## Running the Tool
+
+```bash
+# Run directly with uv
+uv run commit-editor path/to/file.txt
+
+# Or after installing
+uv tool install -e .
+commit-editor path/to/file.txt
+```
+
+## Running All Checks with Tox
+
+The project uses tox to automate testing, linting, formatting, and type checking across multiple Python versions. Run
+all checks with:
+
+```bash
+tox
+```
+
+This runs:
+
+- Tests on Python 3.11, 3.12, and 3.13
+- Linting with ruff
+- Format checking with ruff
+- Type checking with ty
+
+### Running Specific Tox Environments
+
+```bash
+# Run only tests on Python 3.13
+tox -e py313
+
+# Run only linting
+tox -e lint
+
+# Run only format check
+tox -e check-format
+
+# Run only type checking
+tox -e typecheck
+
+# Auto-fix linting issues
+tox -e lint-fix
+
+# Auto-format code
+tox -e format
+```
+
+## Running Tests Manually
+
+```bash
+uv run pytest tests/
+
+# With verbose output
+uv run pytest tests/ -v
+
+# Run a specific test file
+uv run pytest tests/test_wrap.py -v
+
+# Run a specific test
+uv run pytest tests/test_app.py::TestQuitBehavior::test_ctrl_q_clean_exits_immediately -v
+```
+
+## Linting Manually
+
+```bash
+# Check for linting issues
+uv run ruff check .
+
+# Auto-fix linting issues
+uv run ruff check . --fix
+```
+
+## Formatting Manually
+
+```bash
+# Check formatting
+uv run ruff format --check .
+
+# Apply formatting
+uv run ruff format .
+```

README.md

@@ -1 +1,70 @@
-# commit-editor
+# Commit Editor
+
+[![PyPI](https://img.shields.io/pypi/v/commit-editor.svg)](https://pypi.python.org/pypi/commit-editor)
+[![Python](https://img.shields.io/pypi/pyversions/commit-editor.svg)](https://pypi.python.org/pypi/commit-editor)
+[![License](https://img.shields.io/pypi/l/commit-editor.svg)](https://github.com/mprpic/commit-editor/blob/main/LICENSE)
+[![CI](https://github.com/mprpic/commit-editor/workflows/CI/badge.svg)](https://github.com/mprpic/commit-editor/actions)
+
+An opinionated, terminal-based text editor for git commit messages, built
+with [Textual](https://textual.textualize.io/).
+
+- **Title length warning**: Characters beyond position 50 on the first line are highlighted in red
+- **Auto-wrap body text**: Lines in the commit body (line 3+) are automatically wrapped at 72 characters (except for
+  long strings that can't be wrapped, such as URLs)
+- **White space**: Trailing white space is automatically stripped when a file is saved; an empty newline is inserted
+  at the end of the file if not present.
+- **Signed-off-by toggle**: Quickly add or remove a `Signed-off-by` trailer with a keyboard shortcut
+- **Status bar**: Shows current cursor position (line/column) and title length with warnings
+
+## Installation
+
+```bash
+# Using uv
+uv tool install commit-editor
+
+# Using pip
+pip install commit-editor
+```
+
+### Requirements
+
+- Python 3.11 or later
+- Git (for Signed-off-by functionality)
+
+## Usage
+
+Configure `commit-editor` as your default git commit message editor:
+
+```bash
+git config --global core.editor commit-editor
+```
+
+When you run `git commit`, the editor will open automatically.
+
+`commit-editor` can also be used as a standalone tool with:
+
+```bash
+commit-editor path/to/file.txt
+```
+
+## Keyboard Shortcuts
+
+| Shortcut | Action                       |
+|----------|------------------------------|
+| `Ctrl+S` | Save the file                |
+| `Ctrl+Q` | Quit                         |
+| `Ctrl+O` | Toggle Signed-off-by trailer |
+
+## Commit Message Format
+
+This editor enforces the widely-accepted git commit message conventions:
+
+1. **Title (line 1)**: Should be 50 characters or less; characters beyond 50 are highlighted in red as a warning.
+
+2. **Blank line (line 2)**: Separates the title from the body.
+
+3. **Body (line 3+)**: Should wrap at 72 characters; long lines are wrapped automatically as you type.
+
+## License
+
+MIT

pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["uv_build>=0.9.28,<0.10.0"]
+build-backend = "uv_build"
+
+[project]
+name = "commit-editor"
+version = "0.1.0"
+description = "A terminal-based git commit message editor with opinionated formatting"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+authors = [
+    { name = "Martin Prpič", email = "martin.prpic@gmail.com" }
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Version Control :: Git",
+    "Topic :: Text Editors",
+]
+dependencies = [
+    "textual>=0.50.0",
+]
+
+[project.scripts]
+commit-editor = "commit_editor.cli:main"
+
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "pytest-asyncio",
+    "ruff",
+]
+
+[tool.ruff]
+line-length = 100
+
+[tool.ruff.lint]
+select = ["F", "E", "W", "I", "N"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"

src/commit_editor/__init__.py

@@ -0,0 +1,3 @@
+"""A terminal-based git commit message editor with opinionated formatting."""
+
+__version__ = "0.1.0"