Eclipt

A complete library to quickly develop CLI programs. Check out the features:

• Process ARGV
• Custom args array
• Shorthand options (Eg.: -f, -g)
• Array options (Eg.: -a foo -a bar)
• Default values for options
• Flag options (that don't receive any value)
• Grouped flag shorthands (Eg.: -abc)
• Commands
• Help flag and output
• Version flag to execute custom version output
• Callback for commands
• Read modules in a directory as commands

Get Started

Install with: npm i -P eclipt

constEclipt=require('eclipt');// The first temp session is started automatically here,// A diretory will be creted inside your OS's temp dir.letcli=newEclipt('my-cli-tool',// your tool's command name{// Available options object'opt-1': [false,'A cool options','string'],// A regular option with a value'flag-1': [false,'A cool flag'],// An option that doesn't receive a value'flag-2': ['f','A flag with a shorthand notation'],// You may use -f'opt-2': [false,'An option with a default value','string','my-default']});// Read process argv and generate the cli data.letinput=cli.execute();console.log(input);

Reporting Bugs

If you have found any problems with this module, please:

1. Open an issue.
2. Describe what happened and how.
3. Also in the issue text, reference the label ~bug.

We will make sure to take a look when time allows us.

Proposing Features

If you wish to get that awesome feature or have some advice for us, please:

1. Open an issue.
2. Describe your ideas.
3. Also in the issue text, reference the label ~proposal.

Contributing

If you have spotted any enhancements to be made and is willing to get your hands dirty about it, fork us and submit your merge request so we can collaborate effectively.

Reference

Options Object

An object containing CLI options definition. Each key in the object is the name of an option and has assigned to it an array with the following data:

string: [// Option namefalse||character// Define a property shorthand form if needed.string// Describes the option (used in help output).null||string// Name of the expected option value. Leave it blank to define a flag.null||string// A default value for the option.]

Constructor

To create a new CLI, use the Eclipt constructor with the following arguments:

letcli=newEclipt('my-tool',// Your tool's command nameoptions,// The available options objectsettings// General settings for your CLI);

These are the settings supported by the constructor:

{expectedArgs: array,// Names to describe the expect positional argumentsnoArgs: boolean,// Whether positional arguments are supported or notrequireCommand: boolean,// Whether a command is required or notgetVersion: aFunction,// Function that retrieves the version for your toolonOutput: aFunction// To be executed whenever the cli means to output. Ex.: help or version output. Defaults to `console.log`}

Commands

You can add commands to your tool with cli.setCommand as follows:

cli.setCommand(name,{// The command name and settings objectexpectedArgs: array,// Names to describe the expect positional argumentsoptions: options,// The options object for the commandsummary: string,// A brief explanation of the commandcallback: aFunction,// Function to be executed if the command is callednoArgs: boolean// Whether positional arguments are supported or not});