/keep-a-changelog

Tools for manipulating CHANGELOG.md files in Keep A Changelog format, including tagging and releasing.

Primary LanguagePHPBSD 2-Clause "Simplified" LicenseBSD-2-Clause

keep-a-changelog

Build Status Coverage Status

This project provides tooling support for working with Keep A Changelog.

Installation

Run the following to install this library:

$ composer require phly/keep-a-changelog

Alternately, install globally, for use with any repository:

$ composer global require phly/keep-a-changelog

If you install globally, ensure you add $HOME/.composer/bin to your $PATH environment variable. Once setup this way, you can call keep-a-changelog instead of ./vendor/bin/keep-a-changelog.

Usage

You may get a list of commands by running:

$ ./vendor/bin/keep-a-changelog

Currently supported commands include:

  • tag allows tagging a release based on the latest version discovered in the CHANGELOG.md file. The tag will contain the changelog entry for that version within the commit message.

  • release will push a tag to GitHub, and then create a release for it, using the changelog entry for the release.

  • bump and bump:bugfix will prepend a new changelog entry for a new bugfix release, based on the latest release found in the CHANGELOG.md file.

  • bump:minor will prepend a new changelog entry for a new minor release, based on the latest release found in the CHANGELOG.md file.

  • bump:major will prepend a new changelog entry for a new major release, based on the latest release found in the CHANGELOG.md file.

For a list of required parameters and all options for a command, run:

$ ./vendor/bin/keep-a-changelog help <command>