lgit-cli 3.7.0__py3-none-any.whl

lgit_cli-3.7.0.dist-info/METADATA

@@ -0,0 +1,288 @@
+Metadata-Version: 2.4
+Name: lgit-cli
+Version: 3.7.0
+Summary: AI-powered git commit message generator using Claude and other LLMs via OpenAI-compatible APIs
+Project-URL: Homepage, https://github.com/can1357/llm-git
+Project-URL: Repository, https://github.com/can1357/llm-git
+Project-URL: Documentation, https://github.com/can1357/llm-git
+Project-URL: Issues, https://github.com/can1357/llm-git/issues
+Author-email: can1357 <me@can.ac>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,claude,commit,git,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Utilities
+Requires-Python: >=3.14
+Requires-Dist: blake3
+Requires-Dist: httpx
+Requires-Dist: jinja2
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/can1357/llm-git/main/assets/banner.png" alt="lgit">
+</p>
+
+<p align="center">
+  <strong>LLM-powered git commit message generator</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/can1357/llm-git/actions"><img src="https://img.shields.io/github/actions/workflow/status/can1357/llm-git/ci.yml?style=flat&colorA=222222&colorB=3FB950" alt="CI"></a>
+  <a href="https://pypi.org/project/llm-git/"><img src="https://img.shields.io/pypi/v/llm-git?style=flat&colorA=222222&colorB=3FB950" alt="PyPI"></a>
+  <a href="https://github.com/can1357/llm-git/blob/main/LICENSE"><img src="https://img.shields.io/github/license/can1357/llm-git?style=flat&colorA=222222&colorB=58A6FF" alt="License"></a>
+  <a href="https://www.python.org"><img src="https://img.shields.io/badge/Python-3.14%2B-3FB950?style=flat&colorA=222222&logo=python&logoColor=white" alt="Python"></a>
+</p>
+
+<p align="center">
+  Generates <a href="https://www.conventionalcommits.org">conventional commits</a> from git diffs using Claude AI or any OpenAI-compatible API.<br>
+  Automatic changelog maintenance, multi-commit composition, and full history rewriting.
+</p>
+
+---
+
+## Features
+
+- **Conventional commits** — Generates properly formatted commit messages with type, scope, and past-tense summary (≤72 chars)
+- **Automatic changelogs** — Maintains `CHANGELOG.md` following [Keep a Changelog](https://keepachangelog.com) format with monorepo support
+- **Compose mode** — Splits large staged changes into multiple logical atomic commits
+- **Rewrite mode** — Converts entire git history to conventional commits (with automatic backup)
+- **Map-reduce analysis** — Parallel per-file analysis for large commits without truncation
+- **Any LLM provider** — Works with Anthropic, OpenAI, OpenRouter, or any OpenAI-compatible API
+
+## Quick Start
+
+```bash
+# Install
+uv tool install llm-git
+
+# Configure (pick one)
+export LLM_GIT_API_KEY=your_anthropic_key                    # Direct Anthropic
+export LLM_GIT_API_URL=https://openrouter.ai/api/v1          # OpenRouter
+litellm --port 4000                                           # Local proxy (default)
+
+# Use
+git add .
+lgit                    # Analyze, update changelog, commit
+lgit --dry-run          # Preview without committing
+lgit --compose          # Split into multiple commits
+```
+
+## Usage
+
+### Basic Commands
+
+```bash
+lgit                                # Analyze staged changes and commit
+lgit --dry-run                      # Preview message without committing
+lgit --copy                         # Copy message to clipboard
+lgit -p                             # Commit and push
+lgit -S                             # GPG sign the commit
+lgit -s                             # Add Signed-off-by trailer
+lgit --amend                        # Amend the previous commit
+lgit > msg.txt                      # Save raw message to file (auto-detected pipe mode)
+lgit --dry-run | git commit -F -    # Generate message and commit with custom git flags
+
+# Modes
+lgit --mode=unstaged                # Preview unstaged changes (no commit)
+lgit --mode=commit --target=HEAD~1  # Analyze a specific commit
+
+# Models
+lgit -m opus                        # Use Opus for analysis (more capable)
+lgit -m sonnet                      # Use Sonnet (default)
+
+# Context
+lgit Fixed regression from PR #123  # Add context via trailing text
+lgit --fixes 123 456                # Add "Fixes #123, #456" to body
+lgit --breaking                     # Mark as breaking change
+```
+
+### Compose Mode
+
+Split staged changes into multiple logical commits:
+
+```bash
+lgit --compose                      # Propose and create atomic commits
+lgit --compose --compose-preview    # Preview splits without committing
+lgit --compose --compose-max-commits 5
+lgit --compose --compose-test-after-each
+```
+
+### Rewrite Mode
+
+Convert repository history to conventional commits:
+
+```bash
+lgit --rewrite                      # Rewrite full history (creates backup)
+lgit --rewrite --rewrite-preview 10 # Preview first 10 commits
+lgit --rewrite --rewrite-dry-run    # Show all changes without applying
+lgit --rewrite --rewrite-start main~50  # Rewrite last 50 commits only
+lgit --rewrite --rewrite-parallel 20    # 20 concurrent API calls
+```
+
+### Profiling Trace
+
+Write detailed tracing spans and HTTP timing events to a JSONL file:
+
+```bash
+lgit --trace-output /tmp/lgit-profile.jsonl --dry-run
+LLM_GIT_TRACE_FILE=/tmp/lgit-profile.jsonl lgit --compose
+```
+
+Each span close event includes busy/idle timing from `tracing-subscriber`; API events also record TTFT, total response time, status, and response size.
+
+## Automatic Changelog
+
+lgit automatically maintains `CHANGELOG.md` files when committing:
+
+- **Auto-detection** — Finds all `CHANGELOG.md` files in your repository
+- **Monorepo support** — Routes changes to the correct changelog based on file paths
+- **Deduplication** — Skips entries semantically similar to existing ones
+- **Category mapping** — Maps commit types to sections (Added, Fixed, Changed, etc.)
+
+```
+project/
+├── CHANGELOG.md              ← covers: src/, docs/
+├── packages/
+│   ├── core/
+│   │   └── CHANGELOG.md      ← covers: packages/core/**
+│   └── cli/
+│       └── CHANGELOG.md      ← covers: packages/cli/**
+```
+
+Disable with `--no-changelog` or `changelog_enabled = false` in config.
+
+## Configuration
+
+Create `~/.config/llm-git/config.toml`:
+
+```toml
+# API
+api_base_url = "http://localhost:4000"    # Default: LiteLLM proxy
+api_key = "sk-..."                        # Or use LLM_GIT_API_KEY env var
+
+# Model
+analysis_model = "claude-sonnet-4.5"      # Diff analysis / classification
+summary_model = "claude-haiku-4-5"        # Summary line generation
+
+# Commit message limits
+summary_guideline = 72                    # Target length
+summary_soft_limit = 96                   # Triggers retry
+summary_hard_limit = 128                  # Absolute max
+
+# Features
+changelog_enabled = true
+auto_fast_threshold_lines = 200           # Auto-use fast mode for small diffs; 0 disables
+map_reduce_enabled = true                 # Parallel analysis for large commits
+disable_git_background_features = true    # Disables fsmonitor/untrackedCache for lgit subprocesses
+
+# Commit signing
+gpg_sign = false                          # GPG sign commits by default (-S)
+signoff = false                           # Add Signed-off-by trailer by default (-s)
+```
+
+### Provider Examples
+
+**Anthropic Direct:**
+```toml
+api_base_url = "https://api.anthropic.com/v1"
+api_key = "sk-ant-..."
+```
+
+**OpenRouter:**
+```toml
+api_base_url = "https://openrouter.ai/api/v1"
+api_key = "sk-or-..."
+analysis_model = "anthropic/claude-sonnet-4.5"
+summary_model = "anthropic/claude-haiku-4-5"
+```
+
+**OpenAI:**
+```toml
+api_base_url = "https://api.openai.com/v1"
+api_key = "sk-..."
+analysis_model = "gpt-4o"
+summary_model = "gpt-4o-mini"
+```
+
+The client uses tool calling for all models, falling back to parsing JSON content from the model response when a provider ignores `tool_choice`. This works across OpenRouter, LiteLLM, Anthropic, and OpenAI endpoints.
+
+### Commit Types
+
+Customize commit type classification:
+
+```toml
+[types.feat]
+description = "New public API or user-observable behavior change"
+diff_indicators = ["pub fn", "pub struct", "export function"]
+
+[types.fix]
+description = "Fixes incorrect behavior"
+diff_indicators = ["unwrap() → ?", "bounds check", "error handling"]
+
+[types.refactor]
+description = "Internal restructuring with unchanged behavior"
+hint = "If behavior changes, use feat instead."
+```
+
+### Changelog Categories
+
+```toml
+[[categories]]
+name = "Breaking"
+header = "Breaking Changes"
+match.body_contains = ["breaking", "incompatible"]
+
+[[categories]]
+name = "Added"
+match.types = ["feat"]
+
+[[categories]]
+name = "Fixed"
+match.types = ["fix"]
+
+[[categories]]
+name = "Changed"
+default = true
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `LLM_GIT_API_URL` | API endpoint | `http://localhost:4000` |
+| `LLM_GIT_API_KEY` | API key | none |
+| `LLM_GIT_CONFIG` | Config file path | `~/.config/llm-git/config.toml` |
+| `LLM_GIT_VERBOSE` | Debug output | `false` |
+| `LLM_GIT_TRACE_FILE` | JSONL profiling trace output path | none |
+
+## Installation
+
+### From PyPI
+
+```bash
+uv tool install llm-git    # recommended
+pipx install llm-git       # or
+pip install llm-git
+```
+
+### From source
+
+```bash
+git clone https://github.com/can1357/llm-git.git
+cd llm-git
+uv tool install .
+```
+
+### Prerequisites
+
+- Python 3.14+
+- Git
+- API access (Anthropic, OpenAI, OpenRouter, or local LiteLLM proxy)
+
+## License
+
+MIT

lgit_cli-3.7.0.dist-info/RECORD

@@ -0,0 +1,54 @@
+lgit/__init__.py,sha256=_7jJNTyZZre2Ce8oWaihORAX-2uysmkN6jxTIpaD7UQ,1766
+lgit/__main__.py,sha256=VbaRO8-0ehWv7zA27BpyHYWTQVvt5M-aG5HnWr7ws0U,165
+lgit/analysis.py,sha256=O-y9F9KTd2mjdYMEGShKS3Gjcm-KHC465FBnYyQsSlo,11115
+lgit/api.py,sha256=LneFOGGFm4_8vECfnwlldb6YTzRuoq_BuR3h0WQqI1I,42899
+lgit/cache.py,sha256=nSmQPVCYx1IJjSHeK6N7RrSvOHrTLHHOBrqvr3cLcxg,11064
+lgit/changelog.py,sha256=prnmXTzmk1UF92OYPdRXxswKVU0Ppc8DyhZDXlAWeZg,18573
+lgit/cli.py,sha256=zuKuKKRz3zSm9jg-FGBbspb9R_p8e7VUmgcDcDyPG5A,45309
+lgit/compose.py,sha256=AI5Q5hRR95kiszUUK5rvfHg-J4rZS7mygpWJbNChQWE,82560
+lgit/config.py,sha256=Rwca_jxllmthdubi8evM21yyJrfybrtsfrINkwDjQF8,14259
+lgit/diffing.py,sha256=rak6qhGPZvs5tTitav4O6FmTEDdT2Coxp2hWC_OIK94,12882
+lgit/errors.py,sha256=KJXkXDfy0Qy3RfqoeMrvnolIokhGnv6fVVGXByz7fFg,3266
+lgit/git.py,sha256=u3mHYCRtokJnPQqgiJ6lA_p5VHSlyZCJj5ZCfGIWG90,29462
+lgit/map_reduce.py,sha256=xz4wDrHrtXYhYuH6e7Ys0OdhDczem41cu-lzj5bH6cs,19862
+lgit/markdown_output.py,sha256=4VW_omDZDtOLuKOqcV2XWqzt_xRYSQmBymxnx63cULI,26340
+lgit/models.py,sha256=H_inXOZEDIagDyXXd6TgmWh7D10RSHZATZX8h45E8dA,29873
+lgit/normalization.py,sha256=ki17fHAlQI24gB4LwcxeBxxWx7mMAOrz4--0TPhQN3o,11869
+lgit/patch.py,sha256=N9zXWgb9CXa9irssZKCf1bJkGO38nskRvdHFKNoX-Bs,29506
+lgit/profile.py,sha256=QAR5jEuS6za6iNjDapRcSjlSuREZDlYAB1gpPQOq1G0,12977
+lgit/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lgit/repo.py,sha256=EFV-_8O5g19v5Q3W9BkaGebddri3qSxwbl2MwqWO9Sk,8924
+lgit/rewrite.py,sha256=9MMJlDzLMrRtLXbLSd_JhM3lHwYsWxhHfzcWcsWg0Ks,13518
+lgit/style.py,sha256=IY7B6nfxuX85mIfnOVs4vGYzItRuoKH2lXC_4AdEvT8,7502
+lgit/templates.py,sha256=Qd4rMEtTnAFuoU_um-HltmFiUTATySQ8Dj4zcLzkTyQ,12930
+lgit/tokens.py,sha256=OXy6H-ooK6niZ1cNnHBN7Hhe5j1OJZzQrelNhKG2b7c,3123
+lgit/validation.py,sha256=v0eV5YltBDM0aBDiqaCvdfbw3d1GALdMuDbHQ2GCNDE,18719
+lgit/resources/__init__.py,sha256=w6eXZjQeAp_h24IJu_GhNIZelcSMuM3qk8GOmWLQPaQ,53
+lgit/resources/commit_types.json,sha256=IPtUig1U8UAIFnfMVaszQFI_LOZIiaZ2yyE20J1FG1E,11900
+lgit/resources/validation_data.json,sha256=PJ1Iocq2qPKvh-zC1V_WyPrlDFFsXyTdnIxa2bokK5I,14634
+lgit/resources/prompts/analysis/default.md,sha256=Bna4Q4ego2EWiPmZ-ptUxVbjefMai41J0Zw95Ee3ONs,7154
+lgit/resources/prompts/analysis/markdown.md,sha256=71iQx--s9BDlgeAAjtqdOrg5Qo4HAyfAUsxzP0SHveI,3689
+lgit/resources/prompts/changelog/default.md,sha256=oWbGQvrMWID-t4mVIL8pyCrleIC5S4lOmihFHZ-Zk8g,2958
+lgit/resources/prompts/changelog/markdown.md,sha256=3L4FfGt7n--J1P2QpwrNi8YeF10lvHhnpsxhTAQiMqo,2040
+lgit/resources/prompts/compose-bind/default.md,sha256=mLnSXoawvqOxxKYRLTRTTLDEsdnNktlKsuSQenzb_5I,1425
+lgit/resources/prompts/compose-bind/markdown.md,sha256=DEiDJjq7DdWFSov94djHPnWAwq0rjj9kNZjEq4BbFZo,836
+lgit/resources/prompts/compose-intent/default.md,sha256=aeYNjgOhzYGsCGjqARGbkj4ZBT67kXPdULbo6xz_NmU,1976
+lgit/resources/prompts/compose-intent/markdown.md,sha256=0FA7lq6OkmyUrsHg5H26Yme0FiZJFgRHCN7plmgvH0E,1489
+lgit/resources/prompts/fast/default.md,sha256=1TgCxO5CmzG8w7IDlp52Md3i4vj6eXSgOpkp5_glPGA,2173
+lgit/resources/prompts/fast/markdown.md,sha256=8SBaCmaWHebTcNSgeyzQZI-vb4FU3BEuea1DejuoHrg,2213
+lgit/resources/prompts/map/default.md,sha256=fpRVRVbqJegPHB-rig7xh_gouknlC8_1FzwPslRBAjc,2043
+lgit/resources/prompts/map/markdown.md,sha256=d_gBZiVtIq1uUQBqOC5ELXTqmxJAdPOLJgEkVTxJw18,2005
+lgit/resources/prompts/reduce/default.md,sha256=Wwx8U4pxglo5XCR-YhPry1rf_vp55g7Hu9Uwxozdhus,3377
+lgit/resources/prompts/reduce/markdown.md,sha256=ooOA4U3IAsEPUBDNfs9dAnomn2vDzEj44JGhuXXzA3g,2568
+lgit/resources/prompts/summary/default.md,sha256=yzqzEMH83vVKEZqjH_Lkmj59n4VuP7puFxP95OBnEKw,3077
+lgit/resources/prompts/summary/markdown.md,sha256=1piWMzRc4lrqEr6zxBtALynMb3KqXzVVhS_rg1pnA5I,3142
+lgit/testing/__init__.py,sha256=_NQxrUIOQIQLKUP6Zerh2oNoJ7GVLAiWKFj9K2Vkhls,1373
+lgit/testing/compare.py,sha256=jRY98uLclVPyQ7e1TMqFVz2cjUi6kwwn2dkQyR_xsgY,1834
+lgit/testing/fixture.py,sha256=Hl8kTPuNg_I5PMTef0SvLBa4TnAAlB7v8JUYQIb9ggo,13544
+lgit/testing/report.py,sha256=wb7YnP_lsYwsg5OIFtsIC1bMHtK42Mttul_zQcwRNpk,9036
+lgit/testing/runner.py,sha256=yczDXUHYsN2KyTJtIQeiDuYGgQZZfHn6QT70gpsxvEg,9321
+lgit_cli-3.7.0.dist-info/METADATA,sha256=-uPYM2Y5VagdKZ3KIKkhT_WRgWQ_8ls3kaR4TzLDX6s,9615
+lgit_cli-3.7.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+lgit_cli-3.7.0.dist-info/entry_points.txt,sha256=CUSsokc0V3oVHQ2Z1ocL09wV7Krhm0SSfLZpnRMBdA0,39
+lgit_cli-3.7.0.dist-info/licenses/LICENSE,sha256=6dqVzjngLuIcUMd4wWLXPLpv-Pi8gySZAEE3hSN5iKw,1076
+lgit_cli-3.7.0.dist-info/RECORD,,

lgit_cli-3.7.0.dist-info/WHEEL

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

lgit_cli-3.7.0.dist-info/entry_points.txt

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

lgit_cli-3.7.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 can1357 <me@can.ac>
+
+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.