git-hunk 0.1.0__tar.gz

git_hunk-0.1.0/.github/workflows/lint.yml

@@ -0,0 +1,14 @@
+name: Lint
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+      - run: make lint

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

@@ -0,0 +1,18 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@release/v1

git_hunk-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,19 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: make test

git_hunk-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+# Build artifacts
+/build/
+/dist/
+/*.egg-info/
+
+# Test / lint caches
+/.coverage
+/.mypy_cache/
+/.pytest_cache/
+/.ruff_cache/
+
+# Environment
+/.env
+/.env.*
+/.venv/
+
+# Tools
+/.claude/

git_hunk-0.1.0/.python-version

@@ -0,0 +1 @@
+3.10

git_hunk-0.1.0/LICENSE

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

git_hunk-0.1.0/Makefile

@@ -0,0 +1,41 @@
+ifneq ($(OS),Windows_NT)
+	# On Unix-based systems, use ANSI codes
+	BLUE = \033[36m
+	BOLD_BLUE = \033[1;36m
+	BOLD_GREEN = \033[1;32m
+	RED = \033[31m
+	YELLOW = \033[33m
+	BOLD = \033[1m
+	NC = \033[0m
+endif
+
+escape = $(subst $$,\$$,$(subst ",\",$(subst ',\',$(1))))
+
+define exec
+	@echo "$(BOLD_BLUE)$(call escape,$(1))$(NC)"
+	@$(1)
+endef
+
+help:
+	@echo "$(BOLD_GREEN)Available targets:$(NC)"
+	@grep -E '^[a-zA-Z_-].+:.*?# .*$$' $(MAKEFILE_LIST) | \
+		awk 'BEGIN {FS = ":.*?# "}; \
+		{printf "  $(BOLD_BLUE)%-20s$(NC) %s\n", $$1, $$2}'
+
+setup:  # Setup the development environment
+	$(call exec,uv sync)
+
+format:  # Format code
+	$(call exec,uv run ruff format)
+	$(call exec,uv run ruff check --fix)
+
+lint:
+	$(call exec,uv run ruff format --check)
+	$(call exec,uv run ruff check)
+	$(call exec,uv run ty check --no-progress)
+
+test:  # Run tests
+	$(call exec,uv run pytest -v tests/ --numprocesses=auto)
+
+coverage:  # Run tests with coverage
+	$(call exec,uv run pytest -v tests/ --cov=git_hunk --cov-report=term-missing)

git_hunk-0.1.0/PKG-INFO

@@ -0,0 +1,185 @@
+Metadata-Version: 2.4
+Name: git-hunk
+Version: 0.1.0
+Summary: Non-interactive, programmatic git hunk staging with stable IDs.
+Project-URL: Homepage, https://github.com/wkentaro/git-hunk
+Project-URL: Repository, https://github.com/wkentaro/git-hunk
+Project-URL: Issues, https://github.com/wkentaro/git-hunk/issues
+Author: Kentaro Wada
+License-Expression: MIT
+License-File: LICENSE
+Keywords: automation,diff,git,hunk,staging,version-control
+Classifier: Development Status :: 4 - Beta
+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.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
+Requires-Python: >=3.10
+Requires-Dist: click>=8
+Requires-Dist: rich>=13
+Description-Content-Type: text/markdown
+
+# git-hunk
+
+[![PyPI](https://img.shields.io/pypi/v/git-hunk.svg)](https://pypi.python.org/pypi/git-hunk)
+[![Python](https://img.shields.io/pypi/pyversions/git-hunk.svg)](https://pypi.python.org/pypi/git-hunk)
+[![Build](https://github.com/wkentaro/git-hunk/actions/workflows/test.yml/badge.svg)](https://github.com/wkentaro/git-hunk/actions/workflows/test.yml)
+[![License](https://img.shields.io/pypi/l/git-hunk.svg)](https://pypi.python.org/pypi/git-hunk)
+
+Non-interactive, programmatic alternative to `git add -p`.
+
+Every hunk gets a stable, content-based ID so you can inspect, filter, and
+stage changes without interactive prompts.
+
+<img src="assets/teaser.png" alt="git-hunk teaser" width="800">
+
+## Why?
+
+`git add -p` requires interactive input. That makes it unusable for:
+
+- **AI agents** (Claude Code, Codex, etc.) that need to split changes into logical commits
+- **Scripts & CI/CD** that automate commit organization
+- **Editor integrations** that want hunk-level staging without shelling out to a TUI
+
+`git-hunk` solves this by assigning each hunk a stable ID and exposing simple
+stage/unstage/discard commands.
+
+## Install
+
+```bash
+pip install git-hunk
+```
+
+Or with [uv](https://docs.astral.sh/uv/):
+
+```bash
+uv tool install git-hunk
+```
+
+Verify it works:
+
+```bash
+git-hunk --version
+```
+
+### Agent skill (optional)
+
+For Claude Code, Codex, and other AI agents, add the skill via
+[skills](https://github.com/vercel-labs/skills):
+
+```bash
+npx skills add wkentaro/git-hunk
+```
+
+## Quick start
+
+```bash
+# See all hunks across staged, unstaged, and untracked files
+git-hunk list
+
+# Show the diff for a specific hunk
+git-hunk show d161935
+
+# Stage specific hunks, then commit
+git-hunk stage d161935 a3f82c1
+git commit -m "feat: add validation for user input"
+
+# Stage the remaining hunks
+git-hunk stage e7b4012
+git commit -m "fix: handle empty response in API client"
+```
+
+## Usage
+
+### List hunks
+
+```bash
+git-hunk list                          # all hunks (unstaged + staged + untracked)
+git-hunk list --unstaged               # unstaged hunks only
+git-hunk list --staged                 # staged hunks only
+git-hunk list src/foo.py src/bar.py    # specific files
+git-hunk list --json                   # JSON output for scripting
+```
+
+### Show hunks
+
+```bash
+git-hunk show d161935                  # show a single hunk
+git-hunk show d161935 a3f82c1          # show multiple hunks
+git-hunk show --all                    # show all hunks (staged + unstaged)
+git-hunk show --all --staged           # show all staged hunks
+git-hunk show --all --unstaged         # show all unstaged hunks
+```
+
+### Stage, unstage, discard
+
+```bash
+git-hunk stage d161935                 # stage a hunk
+git-hunk stage d161935 a3f82c1         # stage multiple hunks
+git-hunk stage d161935 -l 3,5-7        # stage specific lines only
+git-hunk unstage d161935               # move back to working tree
+git-hunk unstage d161935 -l 3,5-7      # unstage specific lines only
+git-hunk discard d161935               # restore from HEAD
+git-hunk discard d161935 -l ^3,^5-7    # discard excluding specific lines
+```
+
+### JSON output
+
+```bash
+git-hunk list --json
+```
+
+```json
+[
+  {
+    "id": "d161935",
+    "file": "src/main.py",
+    "status": "unstaged",
+    "header": "@@ -10,3 +10,5 @@",
+    "additions": 2,
+    "deletions": 0,
+    "diff": "..."
+  }
+]
+```
+
+## Comparison
+
+| | Interactive | Programmatic | Hunk IDs | Line-level control | JSON output |
+|---|---|---|---|---|---|
+| `git add -p` | Yes | No | No | Yes | No |
+| `git add <file>` | No | Yes | No | No | No |
+| **`git-hunk`** | **No** | **Yes** | **Yes** | **Yes** | **Yes** |
+
+## How it works
+
+1. Parses `git diff` output into individual hunks
+2. Assigns each hunk a stable, content-based ID (SHA-256 prefix)
+3. For staging: reconstructs a minimal patch and pipes it through `git apply --cached`
+4. For discarding: reconstructs a reverse patch and applies it to the working tree
+
+IDs are stable across partial staging -- they are derived from the changed lines,
+not the `@@` line numbers that shift as you stage hunks.
+
+## Contributing
+
+Bug reports, feature requests, and pull requests are welcome on
+[GitHub](https://github.com/wkentaro/git-hunk).
+
+```bash
+git clone https://github.com/wkentaro/git-hunk.git
+cd git-hunk
+make setup   # install dependencies
+make test    # run tests
+make lint    # run linters
+```
+
+## License
+
+MIT ([LICENSE](LICENSE))

git_hunk-0.1.0/README.md

@@ -0,0 +1,158 @@
+# git-hunk
+
+[![PyPI](https://img.shields.io/pypi/v/git-hunk.svg)](https://pypi.python.org/pypi/git-hunk)
+[![Python](https://img.shields.io/pypi/pyversions/git-hunk.svg)](https://pypi.python.org/pypi/git-hunk)
+[![Build](https://github.com/wkentaro/git-hunk/actions/workflows/test.yml/badge.svg)](https://github.com/wkentaro/git-hunk/actions/workflows/test.yml)
+[![License](https://img.shields.io/pypi/l/git-hunk.svg)](https://pypi.python.org/pypi/git-hunk)
+
+Non-interactive, programmatic alternative to `git add -p`.
+
+Every hunk gets a stable, content-based ID so you can inspect, filter, and
+stage changes without interactive prompts.
+
+<img src="assets/teaser.png" alt="git-hunk teaser" width="800">
+
+## Why?
+
+`git add -p` requires interactive input. That makes it unusable for:
+
+- **AI agents** (Claude Code, Codex, etc.) that need to split changes into logical commits
+- **Scripts & CI/CD** that automate commit organization
+- **Editor integrations** that want hunk-level staging without shelling out to a TUI
+
+`git-hunk` solves this by assigning each hunk a stable ID and exposing simple
+stage/unstage/discard commands.
+
+## Install
+
+```bash
+pip install git-hunk
+```
+
+Or with [uv](https://docs.astral.sh/uv/):
+
+```bash
+uv tool install git-hunk
+```
+
+Verify it works:
+
+```bash
+git-hunk --version
+```
+
+### Agent skill (optional)
+
+For Claude Code, Codex, and other AI agents, add the skill via
+[skills](https://github.com/vercel-labs/skills):
+
+```bash
+npx skills add wkentaro/git-hunk
+```
+
+## Quick start
+
+```bash
+# See all hunks across staged, unstaged, and untracked files
+git-hunk list
+
+# Show the diff for a specific hunk
+git-hunk show d161935
+
+# Stage specific hunks, then commit
+git-hunk stage d161935 a3f82c1
+git commit -m "feat: add validation for user input"
+
+# Stage the remaining hunks
+git-hunk stage e7b4012
+git commit -m "fix: handle empty response in API client"
+```
+
+## Usage
+
+### List hunks
+
+```bash
+git-hunk list                          # all hunks (unstaged + staged + untracked)
+git-hunk list --unstaged               # unstaged hunks only
+git-hunk list --staged                 # staged hunks only
+git-hunk list src/foo.py src/bar.py    # specific files
+git-hunk list --json                   # JSON output for scripting
+```
+
+### Show hunks
+
+```bash
+git-hunk show d161935                  # show a single hunk
+git-hunk show d161935 a3f82c1          # show multiple hunks
+git-hunk show --all                    # show all hunks (staged + unstaged)
+git-hunk show --all --staged           # show all staged hunks
+git-hunk show --all --unstaged         # show all unstaged hunks
+```
+
+### Stage, unstage, discard
+
+```bash
+git-hunk stage d161935                 # stage a hunk
+git-hunk stage d161935 a3f82c1         # stage multiple hunks
+git-hunk stage d161935 -l 3,5-7        # stage specific lines only
+git-hunk unstage d161935               # move back to working tree
+git-hunk unstage d161935 -l 3,5-7      # unstage specific lines only
+git-hunk discard d161935               # restore from HEAD
+git-hunk discard d161935 -l ^3,^5-7    # discard excluding specific lines
+```
+
+### JSON output
+
+```bash
+git-hunk list --json
+```
+
+```json
+[
+  {
+    "id": "d161935",
+    "file": "src/main.py",
+    "status": "unstaged",
+    "header": "@@ -10,3 +10,5 @@",
+    "additions": 2,
+    "deletions": 0,
+    "diff": "..."
+  }
+]
+```
+
+## Comparison
+
+| | Interactive | Programmatic | Hunk IDs | Line-level control | JSON output |
+|---|---|---|---|---|---|
+| `git add -p` | Yes | No | No | Yes | No |
+| `git add <file>` | No | Yes | No | No | No |
+| **`git-hunk`** | **No** | **Yes** | **Yes** | **Yes** | **Yes** |
+
+## How it works
+
+1. Parses `git diff` output into individual hunks
+2. Assigns each hunk a stable, content-based ID (SHA-256 prefix)
+3. For staging: reconstructs a minimal patch and pipes it through `git apply --cached`
+4. For discarding: reconstructs a reverse patch and applies it to the working tree
+
+IDs are stable across partial staging -- they are derived from the changed lines,
+not the `@@` line numbers that shift as you stage hunks.
+
+## Contributing
+
+Bug reports, feature requests, and pull requests are welcome on
+[GitHub](https://github.com/wkentaro/git-hunk).
+
+```bash
+git clone https://github.com/wkentaro/git-hunk.git
+cd git-hunk
+make setup   # install dependencies
+make test    # run tests
+make lint    # run linters
+```
+
+## License
+
+MIT ([LICENSE](LICENSE))

git_hunk-0.1.0/git_hunk/__init__.py

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

git_hunk-0.1.0/git_hunk/__main__.py

@@ -0,0 +1,3 @@
+from git_hunk.cli import cli
+
+cli()