grunt-git-committers

Get the committers from a git repository with some sorting and formatting options

grunt-git-committers

Get the committers from a git repository with some sorting and formatting options.

This plugin requires Grunt ~0.4.1

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-git-committers --save-dev

One the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-git-committers');

Generate a list of committers for the current git repository.

Type: String Default value: chronological

The sort type. Could be one of chronological, alphabetical or commits.

Type: Boolean Default value: false

Set to true to include the emails beside the committers.

Type: Boolean Default value: false

Set to true to exclude merge commits. It only works when sorting by commits.

Type: String Default value: ./AUTHORS.txt

The output file where to save the list of committers.

If using the default options you don't need to specify anything at your gruntfile, just call grunt committers task.

This will save a file CONTRIBUTORS.md with the list of committers and their emails, ordered by number of commits (from top to bottom) without counting the merge commits.

grunt.initConfig({
  committers: {
    options: {
      sort: 'commits',
      email: true,
      nomerges: true,
      output: 'CONTRIBUTORS.md'
    },
  },
})

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

  • 0.1.4 Update docs
  • 0.1.3 Use git-committers independant module
  • 0.1.2 Fix task for Darwin OS
  • 0.1.1 Minor bug fixes under windows
  • 0.1.0 Initial release