sergeant

sergeant

A CLI solution with simple argument parsing and built in help messages.

Example

const command = require('sergeant')
const assert = require('assert')

command('hello', function ({option, parameter, command}) {
  parameter('name', {
    description: 'the name',
    required: true
  })

  option('loud', {
    description: 'say it loud',
    aliases: ['l']
  })

  command('world', function ({option}) {
    option('loud', {
      description: 'say it loud',,
      aliases: ['l']
    })

    return function (args) {
      args.name = 'world'

      say(args)
    }
  })

  return function (args) {
    assert.notEqual(args.name, 'world', 'use hello world')

    say(args)
  }
})(process.argv.slice(2))

function say (args) {
  let message = `hello ${args.name}!`

  if (args.loud) {
    message = message.toUpperCase()
  }

  console.log(message)
}

API Reference

command

command(name, description, define)

• name: A string. The name of your command
• description: A string. A short description. Optional
• define: A function to define your command

define

define({[option, parameter, command})

• option
• parameter
• command

It should return a function to call when the command is run. See action

option

option(key, definition)

• key: The name of the option
• definition: An object that defines your option

parameter

parameter(key, definition)

• key: The name of the parameter
• definition: An object that defines your parameter

action

action(args)

It's passed args which are all the options and parameters when run.

definition

{aliases, description, multiple, required, type}

• aliases: Optional. An array of strings, each an alias.
• description: A short description
• multiple: Optional. A boolean. If true then multiple values are accepted.
• required: Optional. A boolean. If true it is required.
• type: A function that should return the default if no value is given.