Skip to main content

A module that generates changelogs based on git tags.

Project description

Changelog Generator

A module that generates changelogs based on git tags. It uses conventional commits (conventionalcommits.org) to read and scope commits. Markdown is used for formating.

Commands

$ pychangelog generate [<path>] [--branch=<string>] [--types=<list>] [--bodytags=<list>]

  • generates new CHANGELOG.md file at the repo root
  • overrides old CHANGELOG.md

$ pychangelog add [<path>] [--branch=<string>] [--types=<list>] [--bodytags=<list>]

  • keeps the content of old CHANGELOG.md while appending new versions

$ pychangelog printout [<path>] [--branch=<string>] [--types=<list>] [--bodytags=<list>]

  • prints the generated changelog in the terminal instead of writing it in the CHANGELOG.md
  • does not touch CHANGELOG.md

Options

Option Format Description Default
path TEXT path to root of the git repository .
--branch TEXT git branch main
--types TEXT comma seperated list commit types to show in changelog feat,fix,chore,docs,refactor,test
--bodytags TEXT comma seperated list body tags that schould be shown in changelog BREAKING CHANGE,MAJOR

Instalation

You can install the changelog generator via PyPI:

pip install python-changelog

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-changelog-0.3.3.tar.gz (5.7 kB view details)

Uploaded Source

Built Distribution

python_changelog-0.3.3-py3-none-any.whl (7.2 kB view details)

Uploaded Python 3

File details

Details for the file python-changelog-0.3.3.tar.gz.

File metadata

  • Download URL: python-changelog-0.3.3.tar.gz
  • Upload date:
  • Size: 5.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.26.0 requests-toolbelt/0.9.1 urllib3/1.26.7 tqdm/4.62.3 importlib-metadata/4.11.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.10.0b3

File hashes

Hashes for python-changelog-0.3.3.tar.gz
Algorithm Hash digest
SHA256 13a03878cb007e1f799090bb49a233e7958708f1807481173e671dad22410f6f
MD5 6770ad2c26d84fe02eec0b59c8cc3265
BLAKE2b-256 b80160395ca0c7f4829d9920b624ae3922a7c61d0e868d24ee10291287dd7038

See more details on using hashes here.

File details

Details for the file python_changelog-0.3.3-py3-none-any.whl.

File metadata

  • Download URL: python_changelog-0.3.3-py3-none-any.whl
  • Upload date:
  • Size: 7.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.26.0 requests-toolbelt/0.9.1 urllib3/1.26.7 tqdm/4.62.3 importlib-metadata/4.11.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.10.0b3

File hashes

Hashes for python_changelog-0.3.3-py3-none-any.whl
Algorithm Hash digest
SHA256 0a11b9f4d9726eb47a36b63b78e60efeebe7f24785fffede61bd97eb29865790
MD5 d8123bca292f8c3a9157ad69b493fcd5
BLAKE2b-256 91fabd6f2547644fa7d7ea13d55c9308af047c3d99ddf6a822a628d276d43164

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page