changelet 0.2.0

ChangeLog and Release Management Tooling

ChangeLog and Release Management Tooling

A simple standalone Python module for CHANGELOG and release management. Spun out of octoDNS.

Installation

Command line

pip install changelet

Usage

For help with using the command

changelet --help

In most cases the only command you're likely to encounter is create. It will be used to add a changelog entry to your branch/PR.

changelet create --type (TYPE) Short description of your change to be included in the changelog

The options for type are

• major - rare for non-maintainers, a change that will break backwards compatibility and require users to take care when updating
• minor - adds new functionality that is either self contained or done in a completely backwards compatible manner
• patch - fixes an issue or bug with existing functionality
• none - change that should not be included in the CHANGELOG and will not directly impact users, e.g. documentation, README, tooling, ...

Using changlet

Currently the tooling has only been tested with repositories in the octoDNS org, but it should be usable elsewhere. You'll want to have a look at the following for how to incorporate it into your repo and workflows.

• (octodns) script/changelog
• .git_hooks_pre-commit (and script/bootstrap which installs it)
• .github/workflows/changelog.yml

Development

See the /script/ directory for some tools to help with the development process. They generally follow the Script to rule them all pattern. Most useful is ./script/bootstrap which will create a venv and install both the runtime and development related requirements. It will also hook up a pre-commit hook that covers most of what's run by CI.