Skip to main content

Keep-a-changelog manager

Project description

logchange - Changelog manager

View, update and format your changelog anywhere!

Features

  • Keeps your changelog in Keep a Changelog style
  • Supports version bumping from semver
  • Comes with a CLI tool logchange
  • Respects MarkDown
  • Created for CI and scripts

Installation

python -m pip install logchange

Usage

CLI

See examples/cli.sh folder.

# create CHANGELOG.md if it does not exist
# or reformat existing (please check changes manually)
logchange init -f

# add new release
cat NOTES_0.1.0.md | logchange add 0.1.0
# or
logchange add 0.2.0 -i `cat NOTES_0.2.0.md`

# update existing or create a new section in latest release
logchange add latest added -i 'New feature'
# or
logchange add latest -i 'Added: New feature'

# set unreleased section
logchange set unreleased fixed -i 'Unreleased fix'

# list released versions
logchange list
< 0.1.0
< 0.2.0

# check release notes sections
logchange get 0.1.0 added
< - New awesome feature
< - Another feature

GitHub Actions

See workflows folder.

Versioning

logchange version follows PEP 440.

Latest changes

Full changelog can be found in Releases.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to PEP 440 -- Version Identification and Dependency Specification.

[Unreleased]

[0.2.0rc9] - 2021-03-14

[0.2.0rc8] - 2021-03-14

[0.2.0rc7] - 2021-03-14

[0.1.2] - 2021-02-26

[0.1.2rc2] - 2021-02-26

[0.1.2rc1] - 2021-02-26

Added

  • added <text> CLI command to update Unreleased section
  • changed <text> CLI command to update Unreleased section
  • deprecated <text> CLI command to update Unreleased section
  • removed <text> CLI command to update Unreleased section
  • fixed <text> CLI command to update Unreleased section
  • security <text> CLI command to update Unreleased section
  • release <version> CLI command to move Unreleased section to release notes

Changed

  • Release notes can now have text other than keep-a-changelog entries
  • get command no longer raises an error on non-existing CHANGELOG.md
  • Added support for Python 3.6.10+

Fixed

  • Empty releases were not added to changelog
  • Codeblocks are no longer removed from release notes
  • Indented sections were not parsed properly

[0.1.1] - 2021-02-26

Initial release

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

logchange-0.2.0rc9.tar.gz (14.3 kB view details)

Uploaded Source

Built Distribution

logchange-0.2.0rc9-py3-none-any.whl (16.3 kB view details)

Uploaded Python 3

File details

Details for the file logchange-0.2.0rc9.tar.gz.

File metadata

  • Download URL: logchange-0.2.0rc9.tar.gz
  • Upload date:
  • Size: 14.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

File hashes

Hashes for logchange-0.2.0rc9.tar.gz
Algorithm Hash digest
SHA256 0df0e8ec01a2b5d38623b820a6cc9ec2c7347caf8368656cff7d2eb8f080b004
MD5 6bd2bd6721d78c52717b780ed221f2c3
BLAKE2b-256 cae3c16194541f3136da56a3e8340f3d1bd3073febaefb53be1369cc822541aa

See more details on using hashes here.

File details

Details for the file logchange-0.2.0rc9-py3-none-any.whl.

File metadata

  • Download URL: logchange-0.2.0rc9-py3-none-any.whl
  • Upload date:
  • Size: 16.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

File hashes

Hashes for logchange-0.2.0rc9-py3-none-any.whl
Algorithm Hash digest
SHA256 acee1e585f84eca8a37001c64631ea3f501c7d5d8800b388454707cf14714e13
MD5 b955863065950fe40775a8f536164d51
BLAKE2b-256 3f7680edb911ea4cf048b70d06cf8306bd8fa794b50373dda3ac3c7ceb86ef04

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