Merge 413af73 into 8ab5c76

README.md

@@ -92,12 +92,16 @@ const help = envier.helpString()
 Reference
 ---------
 
-#### `[new] Envie(description[, values=process.env])`
+#### `[new] Envie(description[, values=process.env], options={ noDefaults: false })`
 
 Creates a new `envie` instance which parses the keys of the object `values` using the `description`.
 `description` must be an object whose keys contain a [Joi](https://www.npmjs.com/package/joi) validator.
 By default, `process.env` is parsed. The `new` keyword is optional.
 
+You can specifiy `noDefaults` to true to get `undefined` instead of default value for non set key.
+This is specially useful if you want to use default values on local environment but want to ensure all required keys
+have a defined values when application is deployed.
+
 #### `envie.get(key)`
 
 Reads the parsed value for `key` if present and valid. Throws if the value is not valid.

index.js

@@ -7,9 +7,10 @@ module.exports = Envie
 Envie.Envie = Envie
 Envie.Joi = Joi
 
-function Envie (description, values) {
-  if (!(this instanceof Envie)) return new Envie(description, values)
+function Envie (description, values, options) {
+  if (!(this instanceof Envie)) return new Envie(description, values, options)
   if (!values) values = process.env
+  if (!options) options = { noDefaults: false }
 
   this.get = function (key) {
     const { error, value } = validate(key)
@@ -40,7 +41,7 @@ function Envie (description, values) {
   }
 
   function validate (key) {
-    return getValidator(key).validate(values[key])
+    return getValidator(key).validate(values[key], { noDefaults: options.noDefaults })
   }
 
   function getValidator (key) {

test/get.test.js

@@ -25,6 +25,13 @@ describe('new Envie({descriptions...}, {...values})', () => {
         it('returns the default value', () => {
           expect(envie.get('with_default')).to.equal('hello world')
         })
+
+        describe('but noDefaults option is true', () => {
+          const envie = Envie(description, {}, { noDefaults: true })
+          it('returns undefined', () => {
+            expect(envie.get('with_default')).to.equal(undefined)
+          })
+        })
       })
     })
 
@@ -45,6 +52,7 @@ describe('new Envie({descriptions...}, {...values})', () => {
         expect(() => envie.get('invalid')).to.throw(/invalid is not valid/i)
       })
     })
+
   })
 })