Public | Automated Build

Last pushed: 7 months ago
Short Description
Small utility that generates a changelog between two git tags based on GitHub pull request titles.
Full Description

github-changelog

This is a small utility that generates a changelog between two git tags based on GitHub pull request titles as either plaintext or markdown.

An example might look like:

  • Improve test coverage for mygreatpackage.subpackage #1234
  • Add support for Python 3 #1233

Installing

pip install git+https://github.com/cfpb/github-changelog

Using

changelog [-h] [-m] OWNER REPO [PREVIOUS] [CURRENT]

The changelog command takes a GitHub repository owner (user or organization), repository name and zero, one, or two tags to limit the set of changes to consider. If no tags are provided, the changelog will be computed between the latest tag and HEAD. One tag may be provided to set the base tag to compare against HEAD. Two tags may be provided to specify both base tag and ending tag. The generated changelog will list all GitHub pull requests that have been merged between the specified or inferred tags. If -m is specified the output will be formatted in markdown and include links to the pull requests.

Examples

changelog cfpb github-changelog

Will generate a text changelog between the latest tag and HEAD.

changelog cfpb github-changelog 1.0.0

Will generate a text changelog between 1.0.0 and HEAD.

changelog -m cfpb github-changelog 1.0.0 1.0.1

Will generate a markdown changelog between 1.0.0 and 1.0.1.

Getting help

Please add issues to the issue tracker.

Getting involved

General instructions on how to contribute can be found in CONTRIBUTING.

Open source licensing info

  1. TERMS
  2. LICENSE
  3. CFPB Source Code Policy
Docker Pull Command
Owner
cmc333333
Source Repository

Comments (0)