Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Get the committers from a git repository with some sorting and formatting options
JavaScript CoffeeScript
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
tasks
test
.editorconfig
.gitignore
.jshintrc
.npmignore
.travis.yml
AUTHORS.txt
Gruntfile.coffee
LICENSE-MIT
README.md
package.json

README.md

grunt-git-committers Build Status NPM version

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

Getting Started

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');

The "committers" task

Generate a list of committers for the current git repository.

Options

options.sort

Type: String Default value: chronological

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

options.email

Type: Boolean Default value: false

Set to true to include the emails beside the committers.

options.nomerges

Type: Boolean Default value: false

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

options.ouput

Type: String Default value: ./AUTHORS.txt

The output file where to save the list of committers.

Usage Examples

Default Options

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

Custom Options

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'
    },
  },
})

Contributing

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.

Release History

  • 0.1.2 Fix task for Darwin OS
  • 0.1.1 Minor bug fixes under windows
  • 0.1.0 Initial release
Something went wrong with that request. Please try again.