lgit-cli 3.7.0__tar.gz

lgit_cli-3.7.0/.gitignore

@@ -0,0 +1,220 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#   Usually these files are written by a python script from a template
+#   before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+*.lcov
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+# Pipfile.lock
+
+# UV
+#   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
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+# poetry.lock
+# poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+# pdm.lock
+# pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+# pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi/*
+!.pixi/config.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule*
+celerybeat.pid
+
+# Redis
+*.rdb
+*.aof
+*.pid
+
+# RabbitMQ
+mnesia/
+rabbitmq/
+rabbitmq-data/
+
+# ActiveMQ
+activemq-data/
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#   JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#   and can be added to the global gitignore or merged into this file.  For a more nuclear
+#   option (not recommended) you can uncomment the following to ignore the entire idea folder.
+# .idea/
+
+# Abstra
+#   Abstra is an AI-powered process automation framework.
+#   Ignore directories containing user credentials, local state, and settings.
+#   Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#   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, 
+#   you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+# Temporary file for partial code execution
+tempCodeRunnerFile.py
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Streamlit
+.streamlit/secrets.toml

lgit_cli-3.7.0/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.

lgit_cli-3.7.0/PKG-INFO

@@ -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