uniformer

returns a key-value object from combined config file/argv values.

Changelog

v0.0.3

• Added support for a passed object defaults that is overriden by both file and argv sources
• fixed file and config path matching, to work cross platform abs/rel using path-resolver

v0.0.2

• Added support for --config and -config.
• This overrides the passed file parameter
• If users are told to use --config path/to/config.ext you can pass no arguments

v0.0.1

• Basic functionality
• merge argv and config values
• quick and easy

How?

Just npm install uniformer and then call require('uniformer')(opts);

check out the examples below.

options

uniformer takes an options object.

{
  file:'path/to/config.(json|yaml)'
}

for instance:

{
  file:'config.json'
}

if you don't specify a file option, uniformer pulls its data from process.argv. If you specify both, the config file values will be overriden by process.argv values.

examples

it's super easy to use...without config:

var uniformer = require('uniformer');
var normalizedOptionsObject = uniformer();

will return {machines:['server01','server02','localhost']} when your application is called like this:

$ node application.js --machines server01 server02 localhost

or

$ node application.js -machines server01 server02 localhost

or with config:

var uniformer = require('uniformer');
var normalizedOptionsObject = uniformer({file:'config.json'}); //this could be a json OR yaml file
//you call also just leave file: out (ie just call uniformer()), and if the user wants to use a config file they can specify --config path/to/file.ext

with a config.json that looks like:

{
  "machines":['server01','server02','localhost']
}

will return {machines:['server01','server02','localhost']} when your application is called like this:

$ node application.js

or will return {machines:['server01','server02','localhost'],deploy:true} when called like:

$ node application.js --deploy true

you can peruse the tests to learn a bit more.

More stuff?

You can read the issues to see what I want todo.

the license is MIT.