check

node-check

Configuration checker.

Install

npm install check

(Or clone the repo.)

Usage

var check = require('check');

var config = {
    database: {hostname: 'example.com', debug: false},
	someOtherSetting: 'bar'
};

check(config)
	.has('database.hostname') // Implicitly checks 'database'
	.isBoolean('database.debug')
	.has('missingSetting')   // Missing key - this will make check fail.
	.assert();               // Assert if anything isn't as required.

Will produce an error not entirely unlike this:

AssertionError: Incorrect configuration:
    Missing key 'missingSetting'.
at functionA (/your/source/code/a.js:line:col)
at functionB (/your/source/code/b.js:line:col)
...
at EventEmitter._tickCallback (node.js:190:38)

API

Initialization

check(object-literal)

Returns an chainable object whereon the following functions can be used.

.has(key)

Tests if the given key is present. This also works with dot-notation, so has('foo.bar') will check if foo exists and then if foo has a bar-thing stuck on.

.isArguments(key)

.isArray(key)

.isBoolean(key)

.isDate(key)

.isDirectory(key)

.isFile(key)

.isFunction(key)

.isNumber(key)

.isObject(key)

.isRegExp(key)

.isSocket(key)

.isString(key)

.isSymbolicLink(key)

First checks if the key is present (as if running .has(key)), and if the given key is the right type.

.assert()

Stops the chaining and assert() if any keys were missing.

.ok()

Stops the chaining and returns if any errors were found.

.errors()

Stops the chaining and returns a list of errors (if any).

Bugs

Plenty! Report them! And add ideas for great features.

License

ISC; see LICENSE.