Package Exports

shelljs-plugin-authors
shelljs-plugin-authors/src/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (shelljs-plugin-authors) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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 <Andrew_Powlowski@yahoo.com>
    39  Gregorio Heaney <Gregorio.Heaney43@yahoo.com>
    55  Miller Reichel <Miller_Reichel@yahoo.com>
    70  Mervin Graham <Mervin69@yahoo.com>
    99  Hallie Paucek <Hallie.Paucek@yahoo.com>

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 <Andrew_Powlowski@yahoo.com>
Gregorio Heaney <Gregorio.Heaney43@yahoo.com>
Miller Reichel <Miller_Reichel@yahoo.com>
Mervin Graham <Mervin69@yahoo.com>
Hallie Paucek <Hallie.Paucek@yahoo.com>
*/

Or you can use it via the CLI:

$ shelljs-authors
Andrew Powlowski <Andrew_Powlowski@yahoo.com>
Gregorio Heaney <Gregorio.Heaney43@yahoo.com>
Miller Reichel <Miller_Reichel@yahoo.com>
Mervin Graham <Mervin69@yahoo.com>
Hallie Paucek <Hallie.Paucek@yahoo.com>

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 <Hallie.Paucek@yahoo.com>
Mervin Graham <Mervin69@yahoo.com>
Miller Reichel <Miller_Reichel@yahoo.com>
Gregorio Heaney <Gregorio.Heaney43@yahoo.com>
Andrew Powlowski <Andrew_Powlowski@yahoo.com>
*/

$ shelljs-authors -n
Hallie Paucek <Hallie.Paucek@yahoo.com>
Mervin Graham <Mervin69@yahoo.com>
Miller Reichel <Miller_Reichel@yahoo.com>
Gregorio Heaney <Gregorio.Heaney43@yahoo.com>
Andrew Powlowski <Andrew_Powlowski@yahoo.com>

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