logforge-gitlog 0.1.0__tar.gz

logforge_gitlog-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,60 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint-and-type-check:
+    name: Lint & Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run ruff
+        run: uv run ruff check src/ tests/
+
+      - name: Run mypy
+        run: uv run mypy src/gitlog
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run tests with coverage
+        run: uv run pytest --cov=src/gitlog --cov-report=xml --cov-report=term-missing
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        if: matrix.python-version == '3.11'
+        with:
+          file: ./coverage.xml

logforge_gitlog-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,76 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  build-and-publish:
+    name: Build & Publish to PyPI
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  generate-changelog:
+    name: Generate & Push Changelog
+    runs-on: ubuntu-latest
+    needs: build-and-publish
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install uv & gitlog
+        run: |
+          pip install uv
+          pip install .
+
+      - name: Generate Changelog
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          GITLOG_PROJECT_DESCRIPTION: "AI-Powered Changelog & Release Notes Generator"
+        run: |
+          gitlog generate --since $(git describe --abbrev=0 HEAD~1 2>/dev/null || echo "") \
+            --format markdown --output CHANGELOG.md
+
+      - name: Commit updated CHANGELOG
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add CHANGELOG.md
+          git diff --staged --quiet || git commit -m "chore: update CHANGELOG for ${{ github.ref_name }}"
+          git push
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          body_path: CHANGELOG.md
+          generate_release_notes: false

logforge_gitlog-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+.env
+*.log
+.coverage
+coverage.xml
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+*.toml.local

logforge_gitlog-0.1.0/.gitlog.toml.example

@@ -0,0 +1,20 @@
+# Example .gitlog.toml configuration
+# Copy to .gitlog.toml and customise, or run: gitlog init
+
+[gitlog]
+llm_provider = "openai"
+model = "gpt-4o-mini"
+language = "en"
+format = "markdown"
+output_file = "CHANGELOG.md"
+project_description = "A developer tool for..."
+exclude_patterns = ["^chore\\(deps\\)", "^Merge branch"]
+group_by_scope = true
+max_commits_per_group = 20
+
+[gitlog.prompts]
+classify_system = ""
+summarize_system = ""
+
+[gitlog.github]
+repo = "owner/repo"

logforge_gitlog-0.1.0/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+> This changelog is maintained by **gitlog** — the tool itself.
+
+## [Unreleased]
+
+### ✨ Features
+- Initial project scaffold with full CLI, LLM classifier, and multi-format renderers
+- Two-layer commit classification: rule engine + LLM batch fallback
+- Keep-a-Changelog Markdown renderer with multilingual support (en, zh-TW, zh-CN, ja)
+- JSON renderer for programmatic consumption
+- Self-contained HTML report with dark/light mode and version timeline
+- Twitter/X release announcement generator
+- `gitlog stats` ASCII bar chart for commit type distribution
+- `gitlog init` interactive `.gitlog.toml` setup wizard
+- GitHub Actions CI/CD with auto-changelog on release

logforge_gitlog-0.1.0/GITHUB_RELEASE_DRAFT.md

@@ -0,0 +1,90 @@
+# Release draft: v0.1.0 — LogForge (gitlog)
+
+Tag: `v0.1.0`
+
+Short description
+-----------------
+LogForge (CLI name: `gitlog`) — AI-powered changelog & release-notes generator.
+
+Highlights
+----------
+- Robust `GitLogParser`: GitPython preferred with `git` subprocess fallback; test-friendly.
+- Backwards-compatible pydantic models: accepts legacy fixture shapes (`author`/`date`).
+- Renderers fixed: JSON/Markdown/Twitter outputs normalized and stable.
+- UX/docs: Added a quick 5s demo (`docs/demo.svg`) and social post templates (`docs/social_templates.md`).
+- Packaging: artifacts built (sdist + wheel). CLI remains `gitlog`, package name for PyPI: `logforge`.
+
+Full release notes
+------------------
+See `RELEASE_NOTES_v0.1.0.md` for full details, changelog, and publish instructions.
+
+Binary artifacts (local)
+------------------------
+Attach these artifacts to the GitHub Release as assets:
+
+- `dist/logforge-0.1.0.tar.gz`
+- `dist/logforge-0.1.0-py3-none-any.whl`
+
+Installation notes
+------------------
+- Recommended (PyPI once published):
+
+```bash
+pip install logforge
+```
+
+- Install from GitHub (current recommendation until PyPI release):
+
+```bash
+pip install git+https://github.com/JToSound/LogForge.git
+```
+
+Usage (quick)
+-------------
+```bash
+gitlog generate
+# or preview without writing
+gitlog generate --dry-run
+# tweet draft
+gitlog tweet
+```
+
+Publishing to PyPI (maintainer instructions)
+--------------------------------------------
+Option A — Upload manually (recommended):
+1. Ensure artifacts are present in `dist/`.
+2. Install twine: `python -m pip install --upgrade twine`.
+3. Upload (example with env vars):
+
+```powershell
+$env:TWINE_USERNAME = "__token__"
+$env:TWINE_PASSWORD = "<PASTE_YOUR_PYPI_TOKEN_HERE>"
+python -m twine upload dist/*
+```
+
+Option B — Let me upload now: reply with `upload now` and I will run `twine upload dist/*` using the token you provided.
+
+Verification
+------------
+- After upload, check https://pypi.org/project/logforge/ and ensure the new version `0.1.0` appears.
+- Optionally, install from PyPI in a fresh environment and run `gitlog --version` and `gitlog generate` on a small repo.
+
+Draft release body (copy/paste ready)
+------------------------------------
+Title: v0.1.0 — LogForge
+
+Body:
+```
+LogForge (gitlog) v0.1.0
+
+This release introduces:
+- Robust git parsing with GitPython/subprocess fallback
+- Backwards-compatible models and multiple renderer fixes
+- Quick animated demo and social templates for easy outreach
+
+Artifacts: attached wheel and sdist (dist/*)
+
+Installation: `pip install logforge` (or `pip install git+https://github.com/JToSound/LogForge.git`)
+
+See full notes in the repository: RELEASE_NOTES_v0.1.0.md
+```

logforge_gitlog-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 gitlog contributors
+
+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.

logforge_gitlog-0.1.0/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.4
+Name: logforge-gitlog
+Version: 0.1.0
+Summary: AI-Powered Changelog & Release Notes Generator
+Project-URL: Homepage, https://github.com/JToSound/LogForge
+Project-URL: Repository, https://github.com/JToSound/LogForge
+Project-URL: Changelog, https://github.com/JToSound/LogForge/blob/main/CHANGELOG.md
+License: MIT License
+        
+        Copyright (c) 2024 gitlog contributors
+        
+        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.
+License-File: LICENSE
+Keywords: ai,changelog,cli,git,release-notes
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.11
+Requires-Dist: gitpython>=3.1
+Requires-Dist: jinja2>=3.1
+Requires-Dist: litellm>=1.40
+Requires-Dist: pydantic-settings>=2
+Requires-Dist: pydantic>=2
+Requires-Dist: rich>=13
+Requires-Dist: tenacity>=8
+Requires-Dist: tomli>=2; python_version < '3.11'
+Requires-Dist: typer[all]>=0.12
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Requires-Dist: types-jinja2; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# LogForge — gitlog
+
+**LogForge — AI-Powered Changelog & Release Notes Generator**
+
+[![CI](https://github.com/JToSound/LogForge/actions/workflows/ci.yml/badge.svg)](https://github.com/JToSound/LogForge/actions/workflows/ci.yml)
+[![Coverage](https://codecov.io/gh/JToSound/LogForge/branch/main/graph/badge.svg)](https://codecov.io/gh/JToSound/LogForge)
+[![GitHub Releases](https://img.shields.io/github/v/release/JToSound/LogForge)](https://github.com/JToSound/LogForge/releases)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+One command. From git history to a human-readable, structured CHANGELOG.  
+Supports **multiple languages**, **multiple output formats**, and **any LLM**.
+
+</div>
+
+---
+
+## Quick Start
+
+```bash
+# Install directly from GitHub (recommended until published to PyPI)
+pip install git+https://github.com/JToSound/LogForge.git
+cd your-repo
+export OPENAI_API_KEY=sk-...
+gitlog generate
+```
+
+That's it. Your `CHANGELOG.md` is ready. 🎉
+
+---
+
+## 5s Demo
+
+Below is a very short demo that shows `gitlog generate` producing a changelog in under 5 seconds on small repos.
+
+![Quick demo](docs/demo.svg)
+
+---
+
+## Features
+
+- 🤖 **Two-layer classification** — rule engine (zero API cost) + LLM batch fallback
+- 🌍 **Multilingual output** — English, Traditional Chinese, Simplified Chinese, Japanese
+- 📄 **Multiple formats** — Markdown (Keep-a-Changelog), JSON, HTML, Twitter drafts
+- 🔗 **GitHub integration** — auto-generates PR/issue/commit links
+- ⚡ **Batch LLM calls** — never call the LLM in a loop; respects token budgets
+- 🔄 **Fallback chain** — LLM failure → rule engine, never interrupts the flow
+- 🧩 **CI/CD ready** — GitHub Actions workflow included out of the box
+- 🏠 **Local inference** — Ollama support for fully private generation
+
+---
+
+## Installation
+
+```bash
+# Recommended: with uv
+uv tool install gitlog
+
+# Or pip
+pip install gitlog
+```
+
+**Requirements:** Python 3.11+, Git
+
+---
+
+## Usage
+
+```bash
+# Generate full CHANGELOG
+gitlog generate
+
+# From a specific version
+gitlog generate --since v1.2.0
+
+# HTML report
+gitlog generate --format html
+
+# Traditional Chinese output
+gitlog generate --lang zh-TW
+
+# Use a local Ollama model (no API key needed)
+gitlog generate --model ollama/llama3
+
+# Preview in terminal without writing a file
+gitlog generate --dry-run
+
+# Compare two versions
+gitlog diff v1.0.0 v1.1.0
+
+# Generate Twitter/X announcement
+gitlog tweet
+
+# ASCII commit statistics
+gitlog stats
+
+# Interactive setup
+gitlog init
+```
+
+---
+
+## Configuration
+
+Create a `.gitlog.toml` in your repo root (or run `gitlog init`):
+
+```toml
+[gitlog]
+llm_provider = "openai"
+model = "gpt-4o-mini"
+language = "en"
+format = "markdown"
+output_file = "CHANGELOG.md"
+project_description = "A developer tool for..."
+exclude_patterns = ["^chore\\(deps\\)", "^Merge branch"]
+group_by_scope = true
+max_commits_per_group = 20
+
+[gitlog.github]
+repo = "owner/repo"
+```
+
+### Full Configuration Reference
+
+| Parameter | Default | Description |
+|---|---|---|
+| `llm_provider` | `openai` | LLM provider: `openai`, `anthropic`, `ollama` |
+| `model` | `gpt-4o-mini` | Model identifier |
+| `language` | `en` | Output language: `en`, `zh-TW`, `zh-CN`, `ja` |
+| `format` | `markdown` | Output format: `markdown`, `json`, `html`, `twitter` |
+| `output_file` | `CHANGELOG.md` | Output file path |
+| `project_description` | `""` | Project context injected into LLM prompts |
+| `exclude_patterns` | see default | Regex list of commit messages to skip |
+| `group_by_scope` | `true` | Group commits by conventional commit scope |
+| `max_commits_per_group` | `20` | Max commits shown per category per version |
+| `github.repo` | `""` | `owner/repo` for generating clickable links |
+
+---
+
+## GitHub Actions Integration
+
+Add to your release workflow:
+
+```yaml
+- name: Generate Changelog
+  uses: JToSound/LogForge/.github/workflows/release.yml@main
+  env:
+    OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+```
+
+Or use the included `release.yml` which automatically:
+1. Builds and publishes to PyPI on tag push
+2. Generates the changelog using gitlog itself
+3. Creates a GitHub Release with the generated notes
+
+---
+
+## Supported LLM Providers
+
+| Provider | Model Example | Env Var |
+|---|---|---|
+| OpenAI | `gpt-4o-mini` | `OPENAI_API_KEY` |
+| Anthropic | `claude-3-5-haiku-20241022` | `ANTHROPIC_API_KEY` |
+| Ollama (local) | `ollama/llama3` | *(none required)* |
+| Gemini | `gemini/gemini-1.5-flash` | `GEMINI_API_KEY` |
+
+---
+
+## License
+
+MIT © gitlog contributors