check-changelog 0.2.1

check that changelog conforms to 'Keep A Changelog' style

check-changelog

---

check that changelog conforms to Keep A Changelog and Common Changelog styles.

Main features:

• check that changelog conforms to Keep A Changelog style

• allow release notes. Add them between the release header and change list (Common Changelog addition)

  ## [1.0.0] - 2023-05-05
  Release notes
  
  ### Added
   - add feature ...
  

• allow custom footer to keep things from being verified. Useful for legal notes, text used by other scripts, HTML comments, etc

  -----
  Linter will ignore this section.
  <!--- message for some script -->
  [my site]: http://mysite.com
  

• gcc style error reports

  CHANGELOG.md:10: bad release title: [0.2.1]; expected '[Unreleased]' or '[ver] - YYYY-MM-DD'
  CHANGELOG.md:12: bad change type: Changed2; expected one of ['Added', 'Changed', ...]
  

Installation

pip install check-changelog

Usage

From command line

# check CHANGELOG.md in a current dir
check-changelog
# check specific CHANGELOG.md
check-changelog -f path/to/changelog.md

As a pre-commit hook. Add this section to your .pre-commit-config.yaml

- repo: https://github.com/aanatoly/check-changelog
  rev: '0.2.1'
  hooks:
    - id: check-changelog

Alternatives

check-changelog is a minimalistic tool by design. It checks the Changelog structure and does nothing else.

If you are looking for more, check python-kacl. It is a feature-rich tool capable of linting, fixing errors, and automating Changelog maintenance.

Development

See development doc