specify-assertions
Beautiful assertion library.
Philosophy
-
Straight-forward: Alright should get out of your way and just let you define your tests with what you already know: plain JavaScript.
-
No verbosity: We don't want
expect(x).to.eventually.be.boring...
-
Helpful error messages: When things go wrong, Alright should do its best to show you exactly what's wrong and how you might fix it.
-
Test-framework agnostic: Alright should work with anything that expect Errors to be thrown when assertions fail.
-
Extensible: It should be easy to extend the built-in assertions with plain JavaScript.
-
Work with older Browsers: Some people still need to support old IEs, Alright should work on them.
Example
Using the Sweet.js macros:
var _ = // simple assertions a + b not a + b // anything goes assertionsb should _b should not _ // asynchronous assertions with pure fantasy-land monads, or Promises/A+b will _b will not _
Using vanilla JavaScript:
var _ = // Use verify for synchronous assertions____ // use verifyFuture for monadic Futures, and verifyPromise for Promises/A+__
Installing
$ npm install specify-assertions
Tests
$ npm install
$ make test
Documentation
$ npm install
$ make documentation
Platform support
This library assumes an ES5 environment, but can be easily supported in ES3 platforms by the use of shims. Just include [es5-shim][] :)
Licence
Copyright (c) 2013-2014 Origami Tower.
This module is part of the Specify framework, and released under the MIT licence.