Queries the GitHub issues API to format a changelog
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
.gitignore
LICENSE
README.md
screenshot.png

README.md

GitHub Changelog Generator

The changelog generator that will create automatic changelog for your projects using Github issue trackers.

Description

This tool queries the GitHub Issues API using CORS to fetch all issues that were closed since a specific date. While doing this, it keeps track of the number of requests remaining in the current rate limit window. You can provide an OAuth2 Token to increase the number of allowed requests per hour. A token can be created for instance through the web UI via the Application settings page.

What does a Changelog line look like?

For each closed issue it generates a line like this:

#341 Update from 2.3 to 2.4 breaks db password [by @tsteur]

For each issue the changelog generator lists:

  • the issue number with a link to the Github issue page,
  • the issue title,
  • all people who have contributed code to this issue and/or were assigned to the issue.

Configuration

config.js file

You can change the configuration in the src/config.js file. The OAuth2 Token and the name of the repository can be changed directly in the UI as well.

sample config.js file

This generator was created for the Matomo analytics project to generate our Release changelogs.

Here is the configuration we're using to generate our changelog across our many projects and repositories:

var config = {};
 
config.repository = 'matomo-org/matomo,matomo-org/tag-manager,matomo-org/matomo-log-analytics,matomo-org/matomo-php-tracker,matomo-org/referrer-spam-blacklist,matomo-org/tracker-proxy,matomo-org/device-detector,matomo-org/searchengine-and-social-list,matomo-org/component-network,matomo-org/component-ini,matomo-org/component-decompress,matomo-org/component-cache,matomo-org/matomo-package,matomo-org/matomo-icons';

config.oauthToken = 'secret';

config.labelsToIgnore = ['invalid', 'wontfix', 'duplicate', 'worksforme', 'answered', 'not-in-changelog'];

config.milestonesToIgnore = ['3.0.0'];

config.sortByLabels = ['RFC', 'c: i18n', 'c: Website matomo.org', 'Bug', 'c: Platform', 'Task', 'c: Accessibility', 'c: Usability', 'c: Design / UI', 'Regression', 'c: Performance', 'Enhancement',  'c: Security', 'c: New plugin', 'Major', 'Critical'];

Usage

Just open the file src/index.html in your browser, no server needed!

License

GPL v3 (or later) see LICENSE

Screenshot

Screenshot