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.0] - 2021-03-14

[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.0.tar.gz (14.3 kB view details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: logchange-0.2.0.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.0.tar.gz
Algorithm Hash digest
SHA256 770a128265a50aba0ccd7c4065b5322bfc0fa0267807e66f8c8523c715f7bba0
MD5 0068d65dbec6da7acd924574f3cd4ec3
BLAKE2b-256 78b4446b73e7b310e060b4ef9347a0713350387a605e5a3f29d4d2f6635d2a73

See more details on using hashes here.

File details

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

File metadata

  • Download URL: logchange-0.2.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1d3c6cc74b3558c8ca311e0790cd61976d154151adbdbafeb31b6de25d8c1de0
MD5 d11c6cd831c995182d373452871e7abd
BLAKE2b-256 e76fe79094f1159dc9f59ec54a7d5e143f110d16ed3f61e5811cfe237c15bed5

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