Skip to content
Et tu, Brute? A tool for creating a cli which uses cli options and package.json options and merge them into default options.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib
spec
.bmp.yml
.editorconfig
.gitignore
.travis.yml
README.md
index.js
package.json

README.md

brutus v2.0.0 Build Status codecov.io

A tool for creating a cli which uses cli options and package.json options and merge them into default options

Install

npm install --save brutus

Usage

var brutus = require('brutus')({

    name: 'mycommand',
    options: {
        foo: "abc",
        bar: {},
        baz: [100, 200]
    },
    delegate: {

        mergeCliOptionsToPackageOptions: function (cliOptions, pkgOptions) {
            // merge options
        },

        mergePackageOptionsToCommandOptions: function (pkgOptions, cmdOptions) {
            // merge options
        },

        execute: function (cliOptions, cmdOptions) {
            // main process
        }

    }

})

// execute as a cli command (using cli options)
brutus.execAsCli()

Options

name: String

The name of the command. This is used as the key of the user's package options.

{
    "name": "users-package",

    "snowball": {
        "foo": "bar"
    }
}

If your command name is snowball, then the user's package options are {"foo": "bar"} in the above example.

options: Object

The default options for the command.

delegate: CommandDelegate Interface

Brutus delegates the merging methods and command execution through delegate object.

mergeCliOptionsToPkgOptions(cliOptions, pkgOptions)

param type
cliOptions Object
pkgOptions Object

Merges the user's cli options to the user's package options.

cliOptions is the parsed argv using minimist (i.e. require('minimist')(process.argv.slice(2)) )

mergePkgOptionsToCommandOptions(pkgOptions, cmdOptions)

param type
pkgOptions Object
cmdOptions Object

Merges the user's package options to the command default options.

pkgOptions are the part of the user's package.json of the key of your command name.

For example, your cmdName is snowball and the user's package.json is like the below:

{
    "name": "my-package",
    "snowball": {
        "foo": "bar"
    }
}

Then the pkgOptions are {foo: "bar"}. This is useful when you make your command's behaviour configurable by the user's package.json.

execute(cliOptions, cmdOptions)

param type
cliOptions Object
cmdOptions Object

Executes the command with cli and command options. The return value of execute becomes the exit code of the cli.

cmdOptions include information merged from the user's cli options and the user's package options using the above 2 methods.

You can’t perform that action at this time.