elgg-conventional-changelog

Generate a markdown changelog from git commit metadata

Usage no npm install needed!

<script type="module">
  import elggConventionalChangelog from 'https://cdn.skypack.dev/elgg-conventional-changelog';
</script>

README

conventional-changelog

$ npm install elgg-conventional-changelog

Generate a changelog from git metadata, using these commit conventions.

View CONVENTIONS.md for a synposis of the conventions with commit examples.

Adapted from code originally written by @vojtajina, from grunt-conventional-changelog.

Example output

Documentation

Simple usage:

require('changelog')({
  repository: 'https://github.com/joyent/node',
  version: require('./package.json').version
}, function(err, log) {
  console.log('Here is your changelog!', log);
});

changelog(options, callback)

By default, calls the callback with a string containing a changelog from the previous tag to HEAD, using pkg.version, prepended to existing CHANGELOG.md (if it exists).

callback is the second parameter, and takes two parameters: (err, log). log is a string containing the newly generated changelog, and err is either an error or null.

options is the first parameter, an object. The following fields are available:

  • version {string} - The version to be written to the changelog. For example, {version: require('./package.json').version}

  • subtitle {string} - A string to display after the version title in the changelog. For example, it will show '## 1.0.0 "Super Version"' if codename '"Super Version"' is given. By default, it's blank.

  • repository {string} - If this is provided, allows issues and commit hashes to be linked to the actual commit. Usually used with github repositories. For example, {repository: 'http://github.com/joyent/node'}

  • commitLink {function(commitHash)} - If repository is provided, this function will be used to link to commits. By default, returns a github commit link based on options.repository: opts.repository + '/commit/' + hash

  • issueLink {function(issueId)} - If repository is provided, this function will be used to link to issues. By default, returns a github issue link based on options.repository: opts.repository + '/issues/' + id

  • from {string} - Which commit the changelog should start at. By default, uses previous tag, or if no previous tag the first commit.

  • to {string} - Which commit the changelog should end at. By default, uses HEAD.

  • file {string} - Which file to read the current changelog from and prepend the new changelog's contents to. By default, uses 'CHANGELOG.md'.

  • log {function()} - What logging function to use. For example, {log: grunt.log.ok}. By default, uses console.log.

  • warn {function()} - What warn function to use. For example, {warn: grunt.log.writeln}. By default, uses console.warn.

  • types {Object} - A map of commit types to section headings. This allows you to customize what sections will be included in the changelog.

    By default, always includes {fix: 'Bug Fixes', feat: 'Features', breaks: 'Breaking Changes'}

    Add new sections: {perf:'Performance'}

    Rename a section: {feat:'New stuff'}

    Alias two types to the same section: {feat: 'Features', feature: 'Features'}

License

BSD