feat(configuration): Allow to directly pass a configuration object to…

… .config() (#480)

README.md

@@ -650,7 +650,9 @@ var argv = require('yargs')
 ```
 
 <a name="config"></a>.config([key], [description], [parseFn])
-------------
+-------------------------------------------------------------
+.config(object)
+---------------
 
 Tells the parser that if the option specified by `key` is passed in, it
 should be interpreted as a path to a JSON config file. The file is loaded
@@ -673,6 +675,24 @@ var argv = require('yargs')
   .argv
 ```
 
+You can also pass an explicit configuration `object`, it will be parsed 
+and its properties will be set as arguments.
+
+```js
+var argv = require('yargs')
+  .config({foo: 1, bar: 2})
+  .argv
+console.log(argv)
+```
+
+```
+$ node test.js
+{ _: [],
+  foo: 1,
+  bar: 2,
+  '$0': 'test.js' }
+```
+
 <a name="count"></a>.count(key)
 ------------
 

test/yargs.js

@@ -683,6 +683,15 @@ describe('yargs dsl tests', function () {
 
       argv.foo.should.equal('baz')
     })
+
+    it('allows to pass a configuration object', function () {
+      var argv = yargs
+          .config({foo: 1, bar: 2})
+          .argv
+
+      argv.foo.should.equal(1)
+      argv.bar.should.equal(2)
+    })
   })
 
   describe('normalize', function () {

yargs.js

@@ -175,6 +175,13 @@ function Yargs (processArgs, cwd, parentRequire) {
   }
 
   self.config = function (key, msg, parseFn) {
+    // allow to pass a configuration object
+    if (typeof key === 'object') {
+      options.configObjects = (options.configObjects || []).concat(key)
+      return self
+    }
+
+    // allow to provide a parsing function
     if (typeof msg === 'function') {
       parseFn = msg
       msg = null