changelogfromtags

Changelog generation has never been so easy
Fully automated changelog generation - This package generates a changelog file based on git tags.
Since you don't have to fill your CHANGELOG.md manually now: just run the script, relax and take a cup of ☕ before your next release! 🎉
What’s the point of a changelog?
To make it easier for users and contributors to see precisely what notable changes have been made between each release (or version) of the project.
Why should I care?
Because software tools are for people. "Changelogs make it easier for users and contributors to see precisely what notable changes have been made between each release (or version) of the project."
Installation
Install the python package like:
$ pip install changelogfromtags
⚠️ changelogfromtags have been successuflly tested with git version >= 2.20.0
It doesn't works with git version 2.11.0 and under...
Usage
Assuming you have a message for git tags:
$ git tag -l -n200
0.1.0 First release
You retrieve the content of `git tag 0.1.0 -n200`
0.1.1 Deploy package changelogfromtags on pypi
Running with CLI:
usage: changelogfromtags [-h] [-p [PREFIX]] [-t [TITLE]] [--tag TAG]
[--verbose]
Generate a change log from git tags.
optional arguments:
-h, --help show this help message and exit
-p [PREFIX], --prefix [PREFIX]
Append a charachter before each line of the message
tag if it is not present.
-t [TITLE], --title [TITLE]
Title in the header
--tag TAG Display entry for the given tag
--verbose, -v
Example
$ changelogfromtags
Changelog
=========
0.1.1 (06/01/2020)
------------------
Deploy package changelogfromtags on pypi
0.1.0 (06/01/2020)
------------------
First release
You retrieve the content of `git tag 0.1.0 -n200`
To add a prefix on entries if not present:
$ changelogfromtags --prefix "- "
Changelog
=========
0.1.1 (06/01/2020)
------------------
- Deploy package changelogfromtags on pypi
0.1.0 (06/01/2020)
------------------
- First release
- You retrieve the content of `git tag 0.1.0 -n200`
To the entry of a specific tag:
$ changelogfromtags --tag 0.1.1
0.1.1 (06/01/2020)
------------------
- Deploy package changelogfromtags on pypi
Running with Docker
docker run -it --rm -v $(pwd):/app r4mb0/changelogfromtags
See changelogfromtags docker image.
Output example
- Look at CHANGELOG.md for this project
Features and advantages of this project
- Changelog entries are directly taken from git tags messages
- No requirements except python and git
- Generate canonical, neat changelog file, with default sections that follow basic changelog guidelines
Save more time with git flow & auto-git-flow !
Check https://pypi.org/project/auto-git-flow/ !
Alternatives
Here is a wikipage list of alternatives that I found. But none satisfied my requirements.
If you know other projects, feel free to edit this Wiki page!
License
changelogfromtags is released under the MIT License.
Metadata
Release files for changelogfromtags 0.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| changelogfromtags-0.5.0.tar.gz | 13.4 kB | Without provenance | Details for changelogfromtags-0.5.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| changelogfromtags-0.5.0-py3-none-any.whl | Python 3 | none | any | Details for changelogfromtags-0.5.0-py3-none-any.whl |
Total release size: 24.0 kB
Security for changelogfromtags 0.5.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.