Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

dargs-object

r3b1k0.2.0

Fork of https://github.com/sindresorhus/dargs. Converts an object of options into an array of command-line arguments. Useful when calling command-line tools. Now object-aware

options, arguments, args, flags, cli

readme

dargs-object

Converts an object of options into an array of command-line arguments

Basically the inverse of an argument parser like nopt or minimist.

Forked from https://github.com/sindresorhus/dargs

Install

$ npm install --save dargs-object

Example

var dargs = require('dargs-object');

var obj = {
    foo: 'bar',
    hello: true,                    // results in only the key being used
    cake: false,                    // ignored
    camelCase: 5,                   // camelCase is slugged to `camel-case`
    multiple: ['value', 'value2'],  // converted to multiple arguments
    object: {test:'value'},
    sad: ':('
};

var options={
    excludes:['sad'],
    convertCamelCase:true,
    joinLists:false
};
console.log(dargs(obj, options));

/*
[
    '--foo', 'bar',
    '--hello',
    '--camel-case', '5',
    '--multiple', 'value',
    '--multiple', 'value2',
    '--object.test', 'value'
]
*/

API

dargs(obj, options)

obj

Type: Object

an object containing options to convert to command-line arguments.

options

Type: Object

Properties:

  • excludes: Keys to exclude.
  • joinLists: If false (default), array values will generate multiple flags: '--list thing1 --list thing2 --list thing3'. If true, array values will be passed, delimited, to a single flag: '--list thing1,thing2,thing3'.
  • convertCamelCase (default: false): Convert camelCase flags to camel-case

License

MIT © Ryan Bridges, based off the original dargs by Sindre Sorhus