shelljs-plugin-authors

A ShellJS plugin for generating a nicely formatted list of authors.

Usage

Let's assume that we're inside a git repo, and the output of git shortlog -se gives us something like:

    24  Andrew Powlowski <[e-mail]>
    39  Gregorio Heaney <[e-mail]>
    55  Miller Reichel <[e-mail]>
    70  Mervin Graham <[e-mail]>
    99  Hallie Paucek <[e-mail]>

We want to generate a nicely formatted list of authors sorted alphabetically by author name. There are two ways to do that with this module, first you can use it as a ShellJS plugin:

const shell = require('shelljs')
require('shelljs-plugin-authors')
const authors = shell.authors()
shell.echo(authors.stdout)
/*
Andrew Powlowski <[e-mail]>
Gregorio Heaney <[e-mail]>
Miller Reichel <[e-mail]>
Mervin Graham <[e-mail]>
Hallie Paucek <[e-mail]>
*/

Or you can use it via the CLI:

$ shelljs-authors
Andrew Powlowski <[e-mail]>
Gregorio Heaney <[e-mail]>
Miller Reichel <[e-mail]>
Mervin Graham <[e-mail]>
Hallie Paucek <[e-mail]>

If you'd prefer the list be sorted by number of commits per author, pass the -n option:

const shell = require('shelljs')
require('shelljs-plugin-authors')
const authors = shell.authors('-n')
shell.echo(authors.stdout)
/*
Hallie Paucek <[e-mail]>
Mervin Graham <[e-mail]>
Miller Reichel <[e-mail]>
Gregorio Heaney <[e-mail]>
Andrew Powlowski <[e-mail]>
*/

$ shelljs-authors -n
Hallie Paucek <[e-mail]>
Mervin Graham <[e-mail]>
Miller Reichel <[e-mail]>
Gregorio Heaney <[e-mail]>
Andrew Powlowski <[e-mail]>

API

Plugin

Options

• -n - Optional Sort the list by number of commits per author.

Example

shell.authors('-n')

CLI

$ shelljs-authors -h

  Usage: shelljs-authors [options]

  Generate a nicely formatted list of authors

  Options:

    -V, --version   output the version number
    -n, --numbered  Sort by number of commits per author
    -h, --help      output usage information

  Examples:

    $ shelljs-authors
    $ shelljs-authors -n

Installation

Plugin

$ npm i -D shelljs shelljs-plugin-authors

CLI

$ npm i -g shelljs shelljs-plugin-authors

License

MIT