Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
src
 
 
 
 
 
 
 
 

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-list,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-icons';

config.oauthToken = 'secret';

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

config.milestonesToIgnore = ['^3.*'];

config.sortByLabels = ['RFC', 'c: i18n', 'c: Website matomo.org', 'Bug', 'c: Platform', 'Task', 'c: Accessibility', 'c: Usability', 'c: Design / UI', 'c: Onboarding', 'Regression', 'c: Performance', 'Enhancement',  'c: Security', 'c: Privacy', '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

About

Queries the GitHub issues API to format a changelog

Resources

License

Releases

No releases published

Packages

No packages published