clia

clia

Command line arguments parser and t3st example project.

usage

Example command line input:

node your-node-app hello -a -ab -d world

In your-node-app:

const clia = require('clia')

const conf = clia(process.argv.slice(2))

// test in your browser on: https://npm.runkit.com/clia
// const conf = clia('hello -a -ab -d world'.split(' '))

conf === {
  // arguments before any options
  plain: [ 'hello' ], 
  // options saved in opt (eg. --a -bd)
  opt: { a: true, b: true, d: true }, 
  // arguments after options are tagged with the last option (eg -d world, or --d world)
  // argument --key=value also saved in args, eg --d=world
  args: { d: [ 'world' ] }, 
  // the first value of each args property, so that you can use arg.prop instead of args.prop[0]
  arg: { d: 'world' }, 
}

edge cases

Empty or non-string inputs are ignored. Spaces are trimmed from inputs.

When -- is encountered, it is ignored. All subsequent inputs are treated as arguments even if they start with -.

An error is thrown when:

• any argument containts __proto__ to prevent prototype pollution
• key-value pair with missing key or value, eg: --store= or --=pet

alias

clia('run -o yaml --d=/usr/bin --fruit=mango'.split(' ')
                , ['output', 'directory', 'fruit'])

yields

{
    arg: {
        o: 'yaml', output: 'yaml',
        d: '/usr/bin', directory: '/usr/bin',
        fruit: 'mango'
    },
    args: {
        o: ['yaml'], output: ['yaml'],
        d: ['/usr/bin'], directory: ['/usr/bin'],
        // note key-value doesn't set option
        // even when kv/value matches alias 
        fruit: ['mango']
    },
    // note key-value doesn't set opt
    // even when kv/value is short option that has an alias
    opt: { o: true, output: true },
    plain: ['run']
}

Docs

All examples here

Dev/specs

Changelog

2020.8.10

• Ignore empty or non-string inputs
• Trim spaces around inputs