Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    grunt-git-committerspublic

    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.5 Support Grunt 1.0
    • 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

    install

    npm i grunt-git-committers

    Downloadslast 7 days

    9

    version

    0.1.5

    license

    none

    repository

    github.com

    last publish

    collaborators

    • avatar