Skip to content

NodeJS module is built for easier working with command line arguments.

License

Notifications You must be signed in to change notification settings

danitseitlin/cli-argument-parser

Repository files navigation

🤘 Quick Start

Run npm i cli-argument-parser

👌 Basic usage

import { cliArguments } from 'cli-argument-parser';
const arg1 = cliArguments.arg1;
const arg2 = cliArguments.arg2;

Run a cli with arg1 and arg2, ie: my-command --arg1=2 --arg2=1 And the values will be inside the variables we declared above.

🙊 Configurate unique CLI's

Using a configuration file

Create a file in the root of your project called cli.config.json and paste the following into it:

{
    prefix: '--',
    separator: '='
}

The prefix is a value which the argument must start with, -- is the default one. (ex: --arg=5)
The separator is a value which seperated between the argument name and argument value. = is the default one. (ex: --arg=5)
This gives you the abillity to configurate your cli arguments as you wish.

Using the CLI

If additional files are a mess in your opinion, it is also possible to pass the CLI configuration via CLI arguments. --cli-prefix to configurate the CLI prefix, ie: --cli-prefix=--
--cli-separator to configurate the CLI separator, ie: --cli-separator==

Using the code

Instead of using the existing cliArguments, you are able to also create a custom one, using the following code snippet:

import { filterArguments } from 'cli-argument-parser';
const arguments = filterArguments('--', '=');

The arguments variable will hold a JS object with arguments (just like cliArguments) filtered by defined prefix and separator .

About

NodeJS module is built for easier working with command line arguments.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published