Generate changelog from git log with convencional commits'
Project description
mkchangelog
Use this CLI tool to create a changelog for a project from the git log using the conventional commits
scheme.
Features:
- show the last changes as Markdown, ReStructuredText or Json
- generate full CHANGELOG.[md,rst,json] file
- compute and bump next versions (using
semver
) - group changes by
type
and byscope
also - aggregate
Closes: XXX-XX[,YYY-YY]
andRelates: XXX-XX[,YYY-YY]
footer references
Table of Contents
Installation
pip install mkchangelog
pip install mkchangelog[colors] # for console colorized output
Usage
The list of versions is taken from list of signed git tags detected by prefix (default v
, f.e. v1.3.4
).
To generate changelog for current and all previous versions (signed tags) on the screen:
mkchangelog generate
Experimental (but works somehow) commands:
Interactive tool to generate changelog, bump version, commit changelog and tag version:
mkchangelog bump - interactive tool; compute next versions from `feat`, `fix` and `breaking_changes`, optionaly write `CHANGELOG.md`, commit and tag next version
Configuration
You can change default configuration using .mkchangelog
(ini format) file in current directory.
Default configuration is:
[GENERAL]
changelog_title = Changelog ; title of generated text changelog
commit_type_default_priority = 10 ; default priority for rendered commit types
default_renderer = markdown ; default renderer (use `-r <renderer` to overwrite)
git_tag_prefix = v ; default git tag prefix for versions
short_commit_types_list = fix,feat ; default list of commit types included in changelog (use `-t <type,type,.. | all>` to overwrite)
[commit_types] ; available commit prefixes along with their names used to render headers
build = Build
chore = Chore
ci = CI
dev = Dev
docs = Docs
feat = Features
fix = Fixes
perf = Performance
refactor = Refactors
style = Style
test = Test
translations = Translations
[commit_types_priorities] ; prioritize commit types to render them earlier, check `commit_type_default_priority`
feat = 40
fix = 30
refactor = 20
; vim: ft=ini
Contributing
Install pre-commit
pip install pre-commit
pre-commit install
Run tests
hatch run all:test
Linting
hatch run lint:all
License
mkchangelog
is distributed under the terms of the MIT license.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for mkchangelog-1.3.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8dcd710133d2ddbca64bfe2a3c4fac3a4ec6e636d3f66a669f2a5ce44bdceff4 |
|
MD5 | 9a0bfa9fec875b33d2ab2f808b6b9faf |
|
BLAKE2b-256 | 4bee41851deef091c09c6df82f6bccd77b644e50e632b7dda6e2a67d18dae8c1 |