args-command-parser

Nodejs minimal opinionated command-line argument parser.

!GitHub

Installation

``bash
npm install args-command-parser
`

Usage

Assume that we have created JavaScript version of git and execute it like below:

`
node git.js commit -m "some message" --amend -abc value --between 1 10
`

Lets first import the parser from args-command-parser:

$3


`js
const { parser } = require('args-command-parser');
`

$3

`js
import argsCommandParser from 'args-command-parser';

const { parser } = argsCommandParser;
`

$3


`ts
import { parser } from 'https://deno.land/x/args_command_parser/mod.js';
`

now lets call the parser and grab the arguments:

`js
const argv = parser().data;
`

The value of the argv after the running the code above will be:

`
{
commands: [ 'commit' ],
shortSwitches: { m: [ 'some message' ], a: [], b: [], c: [ 'value' ] },
longSwitches: { amend: [], between: [ '1', '10' ] }
}
`

args-command-parser by default parse process.argv.slice(2) but you can pass any array of strings to it.

More Details

args-command-parser is an opinionated command-line parser. The idea is that the commands are in the format below:

`
node [command1 [command2 [...]]] [switches]
`

$3

Commands are the first arguments showing up. These are names without - or --. As soon as a switch is seen, the sequence of commands is considered finished.

$3

Switches can be in short or long format.

#### Short Switch

Short Switches are prefixed with - followed by one or more single-character switch. If more than one character is specified, each character is considered a Short Switch. Short Switches can be followed by zero to any number of values.

#### Long Switch

Long Switches are prefixed with --` followed by the switch name. Long Switches can be followed by zero to any number of values.

License

MIT