Package Exports

to-arg

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (to-arg) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

to-arg

Create a command-line argument from a string or string (key) and value.

Install with npm

npm i to-arg --save

Usage

var toArg = require('to-arg');

toArg('abc');
//=> '--abc'

toArg('abc', true);
//=> '--abc'

toArg('abc', 'xyz');
//=> '--abc=xyz'

toArg('abc', 'true');
//=> '--abc=true'

toArg('abc', 10);
//=> '--abc=10'

casing

Keys that are camelcase or contain spaces will be dash-cased:

toArg('fooBar');
//=> '--foo-bar'

toArg('a b c');
//=> '--a-b-c'

toArg('A');
//=> '--a'

Usage example

var obj = {
  foo: 'bar',
  abc: true,
  xyz: 10,
  one: false
};

var args = Object.keys(obj).map(function (key) {
  return toArg(key, obj[key]);
});
//=> ['--foo=bar', '--abc', '--xyz=10', '--no-one']

Options

invert

When the value is false an inverted flag is created by default:

toArg('a', false);
//=> '--no-a'

To disable inversion, pass false on the options:

toArg('a', false, {invert: false});
//=> '--a'

Other awesome libs

option-cache: Simple API for managing options in JavaScript applications.
config-cache: General purpose JavaScript object storage methods.

Run tests

Install dev dependencies:

npm i -d && npm test

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue

Author

Jon Schlinkert

This was inspired by grunt.option.

License

This file was generated by verb-cli on April 17, 2015.