Assert values using Joi schemas
npm install joi-assert   
> Assert values using Joi schemas
Use Spumko's Joi in assertion statements that validate and sanitize values.
Assertions throw an AssertionError with a compact, readable message if validation fails. This makes Joi schemas usable in assertions for use with frameworks like mocha.
If validation succeeds the sanitized value returned, via Joi's support for default values and unknown property stripping etc. This makes Joi schemas usable as input-assertions in the methods of user facing methods of your modules and APIs.
:warning: Early phase so users beware.
Get it from npm:
```bash``
$ npm install joi
$ npm install joi-assert
``js
// import plain Joi
var Joi = require('joi');
// import the module
var joiAssert = require('joi-assert');
// get a Joi schema
var schema = Joi.string().min(5);
// validate data and throw AssertionError on failure
joiAssert(raw, schema);
// assertion returns valid data as oneliner
var valid = joiAssert(raw, schema);
``
``js
// add schema description to error message
var schema = Joi.string().min(5).description('lower bound');
// additonal message per call
input = joiAssert(imput, schema, 'input check');
``
``js
// get a schema using default(), .stripUnknown etc
var schema = Joi.object({
foo: Joi.string().required(),
bar: Joi.string().optional().default('hoge')
}).object({
stripUnknown: true
});
// get valid but dirty input data
var raw = {
foo: 'abc',
nope: null
}
// pass through assertion
var data = joiAssert(raw, schema);
// data is now clean
{
foo: 'abc',
bar: 'hoge'
}
``
``js
// get a schema
var schema = Joi.string().min(5).max(10);
// get assertion closure
var fiveTen = joiAssert.bake(schema, 'five to ten');
// nice
fiveTen(10);
fiveTen(5);
// clean
input = fiveTen(input);
// kablam!
fiveTen(20);
// get fancy
var clean = [5, 6, 7, 8].map(fiveTen);
``
* Improve vars argument
* Support argument as Object, Array and String
* Consider sprintf style smart args (order etc)
* Test it
* Add options to customise error message:
* Amount of concatenated reports
* Multiline message
Install development dependencies:
``bash``
$ npm install
$ npm install -g grunt-cli
Build and run tests using grunt:
``bash``
$ grunt test
See the Gruntfile.js` for additional commands.
Pull requests with fixes are very welcome, for new features best ask via a issue first.
Copyright (c) 2014 Bart van der Schoor
Licensed under the MIT license.