diff --git a/.eslintrc.js b/.eslintrc.js
deleted file mode 100644
index 39033b6d..00000000
--- a/.eslintrc.js
+++ /dev/null
@@ -1,9 +0,0 @@
-module.exports = {
- "extends": "standard",
- "rules": {
- "no-var": ["error"],
- "prefer-const": ["error"],
- "prefer-arrow-callback": ["error"],
- "prefer-template": ["error"]
- }
-};
diff --git a/.gitignore b/.gitignore
index e4c4b4f6..3c3629e6 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,30 +1 @@
-*~
-
-# Logs
-logs
-*.log
-
-# Runtime data
-pids
-*.pid
-*.seed
-
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
-
-# Coverage directory used by tools like istanbul
-coverage
-
-# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# node-waf configuration
-.lock-wscript
-
-# Compiled binary addons (http://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directory
-# https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git-
node_modules
-.nyc_output
diff --git a/.travis.yml b/.travis.yml
index 54a9db62..aa1dc398 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,16 +1,6 @@
language: node_js
+
node_js:
-- '14'
-- '12'
-- '10'
-- '9'
-- '8'
-script: npm run test
-# deploy:
-# provider: npm
-# email: evan@fuzzy.ai
-# api_key:
-# secure: GBaiqCYxs6sYyGoyqWx/B066cJMe7wdeaVW6WCIJRJSkUO34ZKLI19sUCM8P6fV4qnhoIQH6LlnmWcu/8LpswCmx+5DWhNdcVzIWWJ4ewheccSlckdI2crqCaAkE52fQxLZbI/g+xiwE4QcYHNgmJIcONbf8PQwSPtYDK44Edh8ILxO+VdYg/AHpQyoCn8afovuh7nzNCdsR0iDBAY20RoSNungB/360riCCCaUxc95d/gzMccase2/z78zgQoz84ffarP1N5GjZlMsCm0u8aIMjI3YPiOWjwClXP7ZUH/VDrKpYhKxbFo2jb2h0ynhhneg+jK2b7rR5zXSK/koagT6y/IGl75/M5i9CTAEc6BlKBEa/KLDVl89IdXAr7b3KYY1KQdNuwpuxnX6QwIDRVqKdFzknkiUYttWvyL9SG/c6WfucYS07f+FKC4qrAcAjgt7VLV7N72amrFleTazQ67NSPpLaxjjX8qffRbjaACJwO2ydhVcKOXe3CqDxGgh3uvK90qfcBvO8U8fDz6759FT2HxYjpnYV7DXRuC47TDwQHHDNOQFDgFwOb2F1FqQAws9BWwbKtZWwPBdYaT0L3GYwlTMaL816D9sCxyo9whXPz0k7s59uks+VrP6t1x/WBFd68XTsGB7/B2h9LglLkQOFFl7PbOdQfqQZJqYA2uo=
-# on:
-# tags: true
-# repo: vowsjs/vows
+ - 0.4
+ - 0.6
+
diff --git a/CHANGELOG.md b/CHANGELOG.md
deleted file mode 100644
index 13aaebad..00000000
--- a/CHANGELOG.md
+++ /dev/null
@@ -1,577 +0,0 @@
-v1.0.0 / (?)
-============
- * [perjury](https://github.com/fuzzy-ai/perjury), a vows work-alike with a new
- codebase, becomes the new vows.
- * the minimum required Node version is now Node 9 (4, 5, 6, and 8 were previously supported by perjury and are now dropped; 7 was never supported)
-
-v0.8.1 / Fri, 21 Nov 2014
-=========================
- * [81333f3](https://github.com/flatiron/vows/commit/81333f3) [dist] Version bump. 0.8.1 (`indexzero`)
- * [73872a8](https://github.com/flatiron/vows/commit/73872a8) [fix doc] Remove all mentions of the word "promise", vows is based on the EventEmitter. (`indexzero`)
- * [a8314b8](https://github.com/flatiron/vows/commit/a8314b8) Delay process.exit for proper drain of streams on node 0.10 (`Illya Klymov`)
- * [01590ff](https://github.com/flatiron/vows/commit/01590ff) make importSuites work with jscover (`Reno Reckling`)
- * [a39d1b8](https://github.com/flatiron/vows/commit/a39d1b8) Ensure that assertions fail when arguments are missing (`Christian Tegnér`)
- * [049b026](https://github.com/flatiron/vows/commit/049b026) [fix] One significant digit for code coverage. Fixes #240. (`indexzero`)
- * [9ee52a7](https://github.com/flatiron/vows/commit/9ee52a7) Round coverage percentage down. (`David I. Lehn`)
- * [acbb20a](https://github.com/flatiron/vows/commit/acbb20a) [fix] Partially revert bc4c23929f3ce4ba66650130675405a1e85bb26c. Fixes #325. (`indexzero`)
- * [2405195](https://github.com/flatiron/vows/commit/2405195) [fix] Use `.toStringEx()` in test from #324. (`indexzero`)
- * [e9b4d76](https://github.com/flatiron/vows/commit/e9b4d76) Show full path in error traces (`execjosh`)
- * [d6118ec](https://github.com/flatiron/vows/commit/d6118ec) Refactor error stack trace file path extraction (`execjosh`)
- * [5dced8e](https://github.com/flatiron/vows/commit/5dced8e) Fixed recursive call of assertion errors which led to a huge delay when a test failed - Fixes cloudhead/vows#278 (`Pascal Mathis`)
- * [f5cec76](https://github.com/flatiron/vows/commit/f5cec76) Tests for assert.epsilon failing on NaN (`James Gibson`)
- * [ec0442c](https://github.com/flatiron/vows/commit/ec0442c) Make assert.epsilon fail for NaN actual value (`James Gibson`)
- * [64857e3](https://github.com/flatiron/vows/commit/64857e3) [dist] Towards a meaningful CHANGELOG.md. Generated from: https://github.com/indexzero/dotfiles/blob/master/scripts/git-changelog-all (`indexzero`)
- * [f18b325](https://github.com/flatiron/vows/commit/f18b325) [fix dist] Fix travis and the "^" operator on `node@0.8.x`. (`indexzero`)
- * [875f0d3](https://github.com/flatiron/vows/commit/875f0d3) Correct assignment for assert.notInclude() synonym assert.notIncludes() (`Evan Prodromou`)
- * [1c598f0](https://github.com/flatiron/vows/commit/1c598f0) [fix] Properly handle `NaN` in `assert.inDelta` extension. Fixes #120. Thanks @mbostock! (`indexzero`)
- * [1b44458](https://github.com/flatiron/vows/commit/1b44458) [fix] Fix typos in some reporters. Fixes #287. (`indexzero`)
- * [b14f762](https://github.com/flatiron/vows/commit/b14f762) [test] Add failing tests for #287. (`indexzero`)
- * [e9fb10d](https://github.com/flatiron/vows/commit/e9fb10d) Add instructive error message to `importSuites` that could help new users. (`Michael Floering`)
-
-v0.8.0 / Tue, 4 Nov 2014
-========================
- * [775db8f](https://github.com/flatiron/vows/commit/775db8f) [dist] Version bump. 0.8.0 (`indexzero`)
- * [623b375](https://github.com/flatiron/vows/commit/623b375) [dist] Update dependencies to latest. (`indexzero`)
- * [bf8e6aa](https://github.com/flatiron/vows/commit/bf8e6aa) [dist] Update contributors on README and package.json. (`indexzero`)
- * [f113849](https://github.com/flatiron/vows/commit/f113849) [doc] Added TravisCI build status. (`indexzero`)
- * [f9f37df](https://github.com/flatiron/vows/commit/f9f37df) sh instead of js (`Ionică Bizău`)
- * [8db36b9](https://github.com/flatiron/vows/commit/8db36b9) Code highlight (`Ionică Bizău`)
- * [43e917c](https://github.com/flatiron/vows/commit/43e917c) Regenerated package.json (`Ionică Bizău`)
- * [a7764ad](https://github.com/flatiron/vows/commit/a7764ad) Add tests on context and sub context, synchronous and asynchronous (`Romain`)
- * [03a04db](https://github.com/flatiron/vows/commit/03a04db) [fix] Support backwards compatibility for Object reporters in #190. (`indexzero`)
- * [f120d45](https://github.com/flatiron/vows/commit/f120d45) Ability to programmatically specify reporter (`Ilya Shaisultanov`)
- * [7939c94](https://github.com/flatiron/vows/commit/7939c94) [test] fix .travis.yml file needs quote, remove 0.9, add 0.11 (`Swaagie`)
- * [a5acef5](https://github.com/flatiron/vows/commit/a5acef5) Typo fix. (`Brian Donovan`)
- * [1e8fa11](https://github.com/flatiron/vows/commit/1e8fa11) Make coffeescript register itself if it has a register function. (`Steven H. Noble`)
- * [42f23c3](https://github.com/flatiron/vows/commit/42f23c3) refactor: remove line that was made redundant after the last merge from upstream (`adamstallard`)
- * [ef5e76b](https://github.com/flatiron/vows/commit/ef5e76b) ignore hg files (`adamstallard`)
- * [e6bcc64](https://github.com/flatiron/vows/commit/e6bcc64) update vows package (`adamstallard`)
- * [45e9fdf](https://github.com/flatiron/vows/commit/45e9fdf) Moved tag master to changeset 45104b15b3a8 (from changeset 45e0b0d31984) (`adamstallard`)
- * [ecac185](https://github.com/flatiron/vows/commit/ecac185) Moved tag default/master to changeset 45104b15b3a8 (from changeset 5797560897ea) (`adamstallard`)
- * [ce6c2c6](https://github.com/flatiron/vows/commit/ce6c2c6) update vows package (`adamstallard`)
- * [c8c2ff0](https://github.com/flatiron/vows/commit/c8c2ff0) Backed out changeset: be18031783bf (`adamstallard`)
- * [e86bddd](https://github.com/flatiron/vows/commit/e86bddd) Backed out changeset: 19f9533f9bae (`adamstallard`)
- * [f031545](https://github.com/flatiron/vows/commit/f031545) Added tag default for changeset 162f542dd244 (`adamstallard`)
- * [eaaf51a](https://github.com/flatiron/vows/commit/eaaf51a) Moved tag master to changeset 45e0b0d31984 (from changeset be18031783bf) (`adamstallard`)
- * [7595734](https://github.com/flatiron/vows/commit/7595734) Moved tag default/master to changeset 45e0b0d31984 (from changeset 5797560897ea) (`adamstallard`)
- * [d6e2872](https://github.com/flatiron/vows/commit/d6e2872) Added tag master for changeset be18031783bf (`adamstallard`)
- * [e1d3d16](https://github.com/flatiron/vows/commit/e1d3d16) remove accidental commit (`adamstallard`)
- * [2d77a7a](https://github.com/flatiron/vows/commit/2d77a7a) update vows package (`adamstallard`)
- * [1ed1b8c](https://github.com/flatiron/vows/commit/1ed1b8c) Added repository field to package.json (`Gabe De`)
- * [d1d02e0](https://github.com/flatiron/vows/commit/d1d02e0) [test] Test on recent versions of node (`Maciej Małecki`)
- * [bc4c239](https://github.com/flatiron/vows/commit/bc4c239) [fix] Do not use `util.{print,puts}` (`Maciej Małecki`)
- * [a23a1c9](https://github.com/flatiron/vows/commit/a23a1c9) continue to run subtopics even if a parent topic has an error in it (fixes #231) (`adamstallard`)
- * [eb66421](https://github.com/flatiron/vows/commit/eb66421) Set the return value to 'undefined' on an unexpected error (since we always use a callback); improve comments (`adamstallard`)
- * [8e4c8b8](https://github.com/flatiron/vows/commit/8e4c8b8) use node-glob instead of wildcard for better pattern support (`J. Lee Coltrane`)
- * [d6604c3](https://github.com/flatiron/vows/commit/d6604c3) Don't print out extra blank lines in the spec reporter when end of suite fires. (`adamstallard`)
- * [e10dc94](https://github.com/flatiron/vows/commit/e10dc94) Make the xunit reporter follow the established pattern of using the vows console module and allowing for overriding the stream. (`adamstallard`)
- * [98470cb](https://github.com/flatiron/vows/commit/98470cb) revert accidental inclusion of print statement (`adamstallard`)
- * [4acd17e](https://github.com/flatiron/vows/commit/4acd17e) Check that tests report errors like they should (`adamstallard`)
- * [50a13b5](https://github.com/flatiron/vows/commit/50a13b5) Handle errors correctly based on suite.options.error and the number of parameters expected by the vow: When suite.options.error is set to false or a vow expects two or more parameters, get the error as the first argument and don't report it; When suite.options.error is set to true and a vow expects zero or one parameters, report the error and do not run the vow. (`adamstallard`)
- * [26e5941](https://github.com/flatiron/vows/commit/26e5941) fix typo in comment (`adamstallard`)
- * [a7843f4](https://github.com/flatiron/vows/commit/a7843f4) [dist doc] Remove unnecessary Makefile and document that tests should be run with `npm test`. Fixes #241 (`indexzero`)
- * [458eb3e](https://github.com/flatiron/vows/commit/458eb3e) diff colors were reversed (`Andrew Petersen`)
- * [154b6cd](https://github.com/flatiron/vows/commit/154b6cd) Add a not include assertion (`Fred Cox`)
- * [4a9dc5d](https://github.com/flatiron/vows/commit/4a9dc5d) added nopstream to mimic writing to /dev/null on windows (`Dale Stammen`)
- * [5d087fc](https://github.com/flatiron/vows/commit/5d087fc) added nullstream.js to mock /dev/null on windows (`Dale Stammen`)
- * [92868a9](https://github.com/flatiron/vows/commit/92868a9) support for windows drives other than c: (`Dale Stammen`)
- * [f7d09c5](https://github.com/flatiron/vows/commit/f7d09c5) node can't write to nul. reserved filename in windows. changed to .nul. updated .gitignore (`Dale Stammen`)
- * [4c53be1](https://github.com/flatiron/vows/commit/4c53be1) fix for issue 248. file starts with a c (`Dale Stammen`)
-
-v0.7.0 / Fri, 16 Nov 2012
-=========================
- * [c683d88](https://github.com/flatiron/vows/commit/c683d88) [dist] Bump version to 0.7.0 (`Maciej Małecki`)
- * [8776492](https://github.com/flatiron/vows/commit/8776492) use nul for windows equivalent of /dev/null. Added nul to .gitignore (`Dale Stammen`)
- * [48683fb](https://github.com/flatiron/vows/commit/48683fb) fixed path handling for wildcards and test module loading with require (`Dale Stammen`)
- * [5085b39](https://github.com/flatiron/vows/commit/5085b39) remove console.log statementsif present from start of results (`Dale Stammen`)
- * [7f8d511](https://github.com/flatiron/vows/commit/7f8d511) remove os.EOL for strerr test. Only removed first result if not json (`Dale Stammen`)
- * [aace8dd](https://github.com/flatiron/vows/commit/aace8dd) skip over non json results (`Dale Stammen`)
- * [b5438a1](https://github.com/flatiron/vows/commit/b5438a1) remove --supress-stdout only on win32 (`Dale Stammen`)
- * [d419819](https://github.com/flatiron/vows/commit/d419819) remove windows specific reposne in stdout (`Dale Stammen`)
- * [8ceef77](https://github.com/flatiron/vows/commit/8ceef77) removed --supress-stdout from spawn. check for C: in file paths (`Dale Stammen`)
- * [cfe7888](https://github.com/flatiron/vows/commit/cfe7888) removed console.log (`Dale Stammen`)
- * [70865cc](https://github.com/flatiron/vows/commit/70865cc) added wildcard * support to files (`Dale Stammen`)
- * [e85197b](https://github.com/flatiron/vows/commit/e85197b) use process.execPath and not ./bin/vows in for cmd in call to exec(). Fix for windows (`Dale Stammen`)
- * [cde6d9b](https://github.com/flatiron/vows/commit/cde6d9b) added ignore .idea (`Dale Stammen`)
- * [304643f](https://github.com/flatiron/vows/commit/304643f) use process.execPath not ./bin/vows. This is consistent with how exec works in vows and works on windows. Use os.EOL to check oh no string so it works on platforms that use \r\n (`Dale Stammen`)
- * [d728652](https://github.com/flatiron/vows/commit/d728652) added cross-platform fixes to support windows (`Dale Stammen`)
- * [f412e4a](https://github.com/flatiron/vows/commit/f412e4a) [fix] Fix crashes on node v0.9.3 (`Maciej Małecki`)
- * [d073b06](https://github.com/flatiron/vows/commit/d073b06) Do not catch ReferenceError (`Romain`)
-
-v0.6.4 / Thu, 23 Aug 2012
-=========================
- * [e797515](https://github.com/flatiron/vows/commit/e797515) [dist] Bump version to 0.6.4 (`Maciej Małecki`)
- * [8dea08d](https://github.com/flatiron/vows/commit/8dea08d) [dist] Fix `package.json` (`Maciej Małecki`)
- * [fb123cc](https://github.com/flatiron/vows/commit/fb123cc) fix console require (`Jerry Sievert`)
- * [bfb4bf5](https://github.com/flatiron/vows/commit/bfb4bf5) Use plus/minus unicode in error msg (`Trevor Norris`)
- * [1e6eb0f](https://github.com/flatiron/vows/commit/1e6eb0f) Epsilon check fix (`Trevor Norris`)
- * [3c0dc3b](https://github.com/flatiron/vows/commit/3c0dc3b) Add IEEE float epsilon check (`Trevor Norris`)
- * [bfb8998](https://github.com/flatiron/vows/commit/bfb8998) Add Mocha credit. (`Reid Burke`)
- * [cbd6123](https://github.com/flatiron/vows/commit/cbd6123) Add Mocha-style multi-line string diffs. (`Reid Burke`)
- * [aa51288](https://github.com/flatiron/vows/commit/aa51288) Add \
to the HTML coverage report. (`Reid Burke`)
- * [f7afb1b](https://github.com/flatiron/vows/commit/f7afb1b) Better style for directory names in coverage menu. (`Reid Burke`)
- * [526f036](https://github.com/flatiron/vows/commit/526f036) Use Mocha's style for HTML coverage report. (`Reid Burke`)
- * [93dbc61](https://github.com/flatiron/vows/commit/93dbc61) Summarize coverage data for HTML report. (`Reid Burke`)
- * [abb0d5a](https://github.com/flatiron/vows/commit/abb0d5a) Implement TAP reporter (`execjosh`)
-
-v0.6.3 / Wed, 27 Jun 2012
-=========================
- * [f0d2ecc](https://github.com/flatiron/vows/commit/f0d2ecc) [dist] Bump version to 0.6.3 (`Maciej Małecki`)
- * [674830d](https://github.com/flatiron/vows/commit/674830d) [bin] Make isolate mode work in node >= 0.7 (`Maciej Małecki`)
- * [075b0eb](https://github.com/flatiron/vows/commit/075b0eb) [minor] `Math.floor` instead of `Math.ceil` (`Maciej Małecki`)
- * [796ac5d](https://github.com/flatiron/vows/commit/796ac5d) [bin] Add `--shuffle` option (`Maciej Małecki`)
- * [4347cdd](https://github.com/flatiron/vows/commit/4347cdd) [fix] Fix unsafe object iterations (`Maciej Małecki`)
- * [a785630](https://github.com/flatiron/vows/commit/a785630) Allow camelCase test filename (`Romain`)
- * [03f60dd](https://github.com/flatiron/vows/commit/03f60dd) Add `assert.lengthOf` on objects (`Romain`)
- * [38817c1](https://github.com/flatiron/vows/commit/38817c1) Exit code should be 1 if asynchronous errors occurs (`Olivier Bazoud`)
- * [3e60864](https://github.com/flatiron/vows/commit/3e60864) [refactor] Don't touch `require.extensions` (`Maciej Małecki`)
-
-v0.6.2 / Fri, 24 Feb 2012
-=========================
- * [6aa9673](https://github.com/flatiron/vows/commit/6aa9673) [dist] Version 0.6.2 (`Maciej Małecki`)
- * [6b803ab](https://github.com/flatiron/vows/commit/6b803ab) [bin] Use `process.execPath` instead of `process.argv[0]` (`Maciej Małecki`)
- * [1d06e90](https://github.com/flatiron/vows/commit/1d06e90) [api] Write XML coverage report to `coverage.xml` (`Maciej Małecki`)
- * [9dd9b9e](https://github.com/flatiron/vows/commit/9dd9b9e) [bin] Skip dotfiles before `fs.stat()`ing them (`Nathan Hunzaker`)
- * [4342fe9](https://github.com/flatiron/vows/commit/4342fe9) [ui] Add support for `\n` in context names (`jmreidy`)
- * [bbc8e55](https://github.com/flatiron/vows/commit/bbc8e55) [api] Make `assert.include` fail when given unknown type (`Maciej Małecki`)
- * [fe37eec](https://github.com/flatiron/vows/commit/fe37eec) [test] Add `.travis.yml` for testing on Travis CI (`Maciej Małecki`)
- * [b2ca904](https://github.com/flatiron/vows/commit/b2ca904) Add coverage report in xml format. (`Cliffano Subagio`)
-
-v0.6.1 / Mon, 26 Dec 2011
-=========================
- * [c84e55c](https://github.com/flatiron/vows/commit/c84e55c) [dist] Version 0.6.1 (`Maciej Małecki`)
- * [239df60](https://github.com/flatiron/vows/commit/239df60) [test] Test if exception thrown in the topic gets passed down (`Bernardo Heynemann`)
- * [6f84e3b](https://github.com/flatiron/vows/commit/6f84e3b) [api fix] When topic `throw`s, treat exception as a return value (`Maciej Małecki`)
- * [722d4d8](https://github.com/flatiron/vows/commit/722d4d8) Documentation bug fix: Rename *length* to *lengthOf* in a test. (`Johnny Weng Luu`)
- * [08b0650](https://github.com/flatiron/vows/commit/08b0650) [reporters/json] fix async error reporting (`Fedor Indutny`)
- * [fbf7f69](https://github.com/flatiron/vows/commit/fbf7f69) [fix] Fix leaking `self` (`Maciej Małecki`)
- * [9853e64](https://github.com/flatiron/vows/commit/9853e64) Async topic is passed to vows with topic-less subcontext (`seebees`)
-
-v0.6.0 / Fri, 25 Nov 2011
-=========================
- * [82d5541](https://github.com/flatiron/vows/commit/82d5541) [dist] Version bump. 0.6.0 (`indexzero`)
- * [3943fec](https://github.com/flatiron/vows/commit/3943fec) event order for 'on' (`seebees`)
- * [d9fe353](https://github.com/flatiron/vows/commit/d9fe353) [minor] Update style from previous commit (`indexzero`)
- * [e92c1e4](https://github.com/flatiron/vows/commit/e92c1e4) Added --no-color option to suppress terminal colors (`Alexander Shtuchkin`)
- * [8788a52](https://github.com/flatiron/vows/commit/8788a52) [v0.6 fix] Properly inspect errors (`Maciej Małecki`)
- * [6760a2e](https://github.com/flatiron/vows/commit/6760a2e) [merge] Manual merge of #135 since the fork no longer exists. Fixes #135 (`indexzero`)
- * [ddd9588](https://github.com/flatiron/vows/commit/ddd9588) When an uncaught exception is caught in watch mode, print it in the console and continue watch. (`Julien Guimont`)
- * [ddf3cf4](https://github.com/flatiron/vows/commit/ddf3cf4) [merge] add support for coffee files when printing out errors. Fixes #140 (`indexzero`)
- * [1448de2](https://github.com/flatiron/vows/commit/1448de2) When called outside the vows context where `this.stack` && `source` are undefined it will now no longer crash and burn (`Raynos`)
- * [c92aabc](https://github.com/flatiron/vows/commit/c92aabc) Expose console so we can re-use it in custom reporters. (`Raynos`)
- * [c67786f](https://github.com/flatiron/vows/commit/c67786f) [merge] Manual merge of #95 since the fork no longer exists. Fixes #95 (`indexzero`)
- * [81482b1](https://github.com/flatiron/vows/commit/81482b1) Fixed indentation and some missing semicolons requested in #82 (`Ryan Olds`)
- * [f39a4e2](https://github.com/flatiron/vows/commit/f39a4e2) Add support for asynchronous teardowns. (`Daniel Brockman`)
- * [a44ee69](https://github.com/flatiron/vows/commit/a44ee69) Edited README.md via GitHub (`Jerry Sievert`)
- * [a781c45](https://github.com/flatiron/vows/commit/a781c45) events other then success (`seebees`)
- * [d081d49](https://github.com/flatiron/vows/commit/d081d49) Buffer not needed and leaking a global. (`Nicolas Morel`)
- * [482d09c](https://github.com/flatiron/vows/commit/482d09c) adding a filter to the watch logic, so that only test files are run (`jmreidy`)
- * [f77e4bd](https://github.com/flatiron/vows/commit/f77e4bd) fixing regular expression for specFileExt to use an OR (`jmreidy`)
- * [e7fbdb4](https://github.com/flatiron/vows/commit/e7fbdb4) test require should refer to lib/vows, not system vows (`jmreidy`)
- * [907d308](https://github.com/flatiron/vows/commit/907d308) Adding vows support for underscores, in addition to dashes, in spec or test names (`jmreidy`)
-
-v0.5.13 / Wed, 2 Nov 2011
-=========================
- * [a5912ba](https://github.com/flatiron/vows/commit/a5912ba) [dist] Version bump. 0.5.13 (`indexzero`)
- * [7290532](https://github.com/flatiron/vows/commit/7290532) [fix] Fix failed assertions output (`Maciej Małecki`)
-
-v0.5.12 / Sat, 22 Oct 2011
-==========================
- * [ef4a803](https://github.com/flatiron/vows/commit/ef4a803) [dist] Version bump. 0.5.12 (`indexzero`)
- * [58f44f0](https://github.com/flatiron/vows/commit/58f44f0) [dist] Add test script for `npm test` (`indexzero`)
- * [bd14209](https://github.com/flatiron/vows/commit/bd14209) [fix minor] Remove unnecessary argument in `exec` callback (`Maciej Małecki`)
- * [00509bd](https://github.com/flatiron/vows/commit/00509bd) [test] Test `--supress-stdout` flag (`Maciej Małecki`)
- * [8ce12a5](https://github.com/flatiron/vows/commit/8ce12a5) [test] Add fixtures for supress-stdout test (`Maciej Małecki`)
- * [50052f5](https://github.com/flatiron/vows/commit/50052f5) [test v0.6] Make `assert-test.js` v0.6-compatible (`Maciej Małecki`)
- * [fde1216](https://github.com/flatiron/vows/commit/fde1216) [refactor minor] Use `JSON.parse` when getting version (`Maciej Małecki`)
- * [cc76162](https://github.com/flatiron/vows/commit/cc76162) [refactor minor] Remove unused variables in `vows.addVow.runTest` (`Maciej Małecki`)
- * [006476f](https://github.com/flatiron/vows/commit/006476f) [v0.6] Handle stdout suppressing correctly (`Maciej Małecki`)
- * [87462e6](https://github.com/flatiron/vows/commit/87462e6) [api] Rename `assert.length` to `assert.lengthOf` (`Maciej Małecki`)
- * [fd44e08](https://github.com/flatiron/vows/commit/fd44e08) [fix v0.6] No `error.stack` for nextTick errors (`Maciej Małecki`)
- * [eac4362](https://github.com/flatiron/vows/commit/eac4362) [refactor v0.6] Remove/replace `sys` usages (`Maciej Małecki`)
- * [485698d](https://github.com/flatiron/vows/commit/485698d) (doc) add 'authors' section to README (`Alexis Sellier`)
-
-v0.5.11 / Sat, 20 Aug 2011
-==========================
- * [3843409](https://github.com/flatiron/vows/commit/3843409) (dist) Version bump. 0.5.11 (`indexzero`)
- * [954386c](https://github.com/flatiron/vows/commit/954386c) (test) Added tests for error pass thru (`indexzero`)
- * [0108f1f](https://github.com/flatiron/vows/commit/0108f1f) Allow arguments to flow through to callbacks in error conditions. (`Ben Taber`)
- * [3b9acac](https://github.com/flatiron/vows/commit/3b9acac) add unified coverage maps, and fix issue when using coverage without instrumentation (`Jerry Sievert`)
- * [3a2f697](https://github.com/flatiron/vows/commit/3a2f697) add unified coverage maps, and fix issue when using coverage without instrumentation (`Jerry Sievert`)
- * [5b2ae84](https://github.com/flatiron/vows/commit/5b2ae84) (fix) Check topic.constructor to reverse regression introduced by instanceof check (`indexzero`)
- * [c7f9e3c](https://github.com/flatiron/vows/commit/c7f9e3c) added assert.isNotEmpty and assert.isDefined (`nekaab`)
-
-v0.5.10 / Fri, 12 Aug 2011
-==========================
- * [484b5f4](https://github.com/flatiron/vows/commit/484b5f4) [fix] Update references to `stylize` after refactor (`indexzero`)
- * [f18b45c](https://github.com/flatiron/vows/commit/f18b45c) (minor) Move .vowsText and .contextText out of reporters/spec into vows/console (`indexzero`)
- * [a813268](https://github.com/flatiron/vows/commit/a813268) (fix) Remove unecessary reference to spec in reporters/dot-matrix.js. Fixes #117 (`indexzero`)
- * [0d8c406](https://github.com/flatiron/vows/commit/0d8c406) [fix] Dont always append a tailing `\n` to all test output (`indexzero`)
- * [67b7ce7](https://github.com/flatiron/vows/commit/67b7ce7) (minor) Update package.json (`indexzero`)
- * [33aeb64](https://github.com/flatiron/vows/commit/33aeb64) (dist) Version bump. 0.5.10 (`indexzero`)
- * [889b748](https://github.com/flatiron/vows/commit/889b748) [bin test] Added additional teardown test. Update bin/vows to support absolute path. #83 (`indexzero`)
- * [c8ee815](https://github.com/flatiron/vows/commit/c8ee815) [style] respect cloudhead's style (`Fedor Indutny`)
- * [dcf5021](https://github.com/flatiron/vows/commit/dcf5021) [isolate] fixed test fixtures naming (`Fedor Indutny`)
- * [9be20ef](https://github.com/flatiron/vows/commit/9be20ef) [isolate] allow reporters to output raw data (`Fedor Indutny`)
- * [5c40a46](https://github.com/flatiron/vows/commit/5c40a46) [isolate] tests (`Fedor Indutny`)
- * [26fc3f7](https://github.com/flatiron/vows/commit/26fc3f7) [isolate] supress-stdout option and true stream usage in reporters (`Fedor Indutny`)
- * [d53c429](https://github.com/flatiron/vows/commit/d53c429) [isolate] exec => spawn, stream suite output, fix command line arguments to child process (`Fedor Indutny`)
- * [c2a1d60](https://github.com/flatiron/vows/commit/c2a1d60) [isolate] collect results (`Fedor Indutny`)
- * [b275024](https://github.com/flatiron/vows/commit/b275024) [isolate] implement runner (`Fedor Indutny`)
- * [3543c0e](https://github.com/flatiron/vows/commit/3543c0e) [isolate] added command line option (`Fedor Indutny`)
- * [63a15e7](https://github.com/flatiron/vows/commit/63a15e7) Provide some very rudimentary CSS & JS to collapse the 'covered' source by default and use colours to draw your eye to the areas that need tackling (`ciaranj`)
- * [96a17a2](https://github.com/flatiron/vows/commit/96a17a2) use instanceof to check if the return value from a topic is an EventEmitter (`seebees`)
- * [3e98285](https://github.com/flatiron/vows/commit/3e98285) Test for change (`seebees`)
-
-v0.5.9 / Fri, 22 Jul 2011
-=========================
- * [e80e96d](https://github.com/flatiron/vows/commit/e80e96d) (dist) version bump (`cloudhead`)
- * [76e9175](https://github.com/flatiron/vows/commit/76e9175) add /bin folder to package.json (`cloudhead`)
- * [d597378](https://github.com/flatiron/vows/commit/d597378) fix assert.inDelta global vars (`cloudhead`)
- * [9418795](https://github.com/flatiron/vows/commit/9418795) remove `require.paths` dependency (`cloudhead`)
- * [3d400b8](https://github.com/flatiron/vows/commit/3d400b8) adds coverage map functionality (`Jerry Sievert`)
- * [bc868fa](https://github.com/flatiron/vows/commit/bc868fa) (new) added assert.inDelta (`mynyml`)
- * [db608e2](https://github.com/flatiron/vows/commit/db608e2) NaN !== Boolean (`Joshua Kehn`)
- * [4144271](https://github.com/flatiron/vows/commit/4144271) Implemented isBoolean and tests to match (`Joshua Kehn`)
- * [342dbae](https://github.com/flatiron/vows/commit/342dbae) added assert.deepInclude (`mynyml`)
- * [27f683a](https://github.com/flatiron/vows/commit/27f683a) added assert.deepInclude (`mynyml`)
-
-v0.5.8 / Sat, 12 Mar 2011
-=========================
- * [7c9b21d](https://github.com/flatiron/vows/commit/7c9b21d) (dist) version bump (`Alexis Sellier`)
- * [72b9299](https://github.com/flatiron/vows/commit/72b9299) (style) ws (`Alexis Sellier`)
- * [381c0a3](https://github.com/flatiron/vows/commit/381c0a3) Fixed CoffeeScript support on Node 0.3+ (`Janne Hietamäki`)
- * [697ada4](https://github.com/flatiron/vows/commit/697ada4) (minor test) cleanup (`Alexis Sellier`)
- * [3291d77](https://github.com/flatiron/vows/commit/3291d77) fix vow context when global (`Alexis Sellier`)
-
-v0.5.7 / Sun, 20 Feb 2011
-=========================
- * [f700eed](https://github.com/flatiron/vows/commit/f700eed) (dist) version bump (`Alexis Sellier`)
- * [7b20446](https://github.com/flatiron/vows/commit/7b20446) support for this.callback.call({}, ...) (`Alexis Sellier`)
- * [7874f54](https://github.com/flatiron/vows/commit/7874f54) improve async error report (`Alexis Sellier`)
- * [332b522](https://github.com/flatiron/vows/commit/332b522) include test filename in some error reports (`Alexis Sellier`)
- * [1ddf5b1](https://github.com/flatiron/vows/commit/1ddf5b1) (api) support for /.test.js$/ filenames (`Alexis Sellier`)
- * [93da10b](https://github.com/flatiron/vows/commit/93da10b) (minor) cleanup (`cloudhead`)
- * [402e309](https://github.com/flatiron/vows/commit/402e309) Fixed watch mode. (`Matteo Collina`)
-
-v0.5.6 / Mon, 31 Jan 2011
-=========================
- * [0b54a98](https://github.com/flatiron/vows/commit/0b54a98) (dist) revert to node 0.2.6, version bump to 0.5.6 (`cloudhead`)
- * [f1ff2c1](https://github.com/flatiron/vows/commit/f1ff2c1) preserve 0.2.6 compatibility (`cloudhead`)
- * [d6ba141](https://github.com/flatiron/vows/commit/d6ba141) added simple xunit support, so vows can be used together with Hudson (`Anders Thøgersen`)
- * [d88924d](https://github.com/flatiron/vows/commit/d88924d) (dist) update package.json to include node version (`cloudhead`)
- * [a00c89d](https://github.com/flatiron/vows/commit/a00c89d) Updated teardown to execute after subcontexts complete (`Jeremiah Wuenschel`)
-
-v0.5.4 / Sat, 29 Jan 2011
-=========================
- * [c2633dc](https://github.com/flatiron/vows/commit/c2633dc) (dist) version bump (`cloudhead`)
- * [4361e42](https://github.com/flatiron/vows/commit/4361e42) use 'on' instead of 'addListener' (`cloudhead`)
- * [eb4d50d](https://github.com/flatiron/vows/commit/eb4d50d) support '.' in filenames (`cloudhead`)
- * [3030206](https://github.com/flatiron/vows/commit/3030206) (test) test for multiple arguments in callbacks (`cloudhead`)
- * [1c18b66](https://github.com/flatiron/vows/commit/1c18b66) remove listeners warning on topics (`cloudhead`)
- * [8fb1a56](https://github.com/flatiron/vows/commit/8fb1a56) support for multiple arguments passed to sub-topics (`cloudhead`)
- * [398443d](https://github.com/flatiron/vows/commit/398443d) (minor) aliased export to exportTo (`cloudhead`)
- * [3b1545a](https://github.com/flatiron/vows/commit/3b1545a) (bin) update for node 0.2.5 (`cloudhead`)
- * [f0f823d](https://github.com/flatiron/vows/commit/f0f823d) (bin) fix auto-discover mode (`cloudhead`)
-
-v0.5.3 / Wed, 29 Dec 2010
-=========================
- * [3d12553](https://github.com/flatiron/vows/commit/3d12553) (dist) version bump (`cloudhead`)
- * [936e18a](https://github.com/flatiron/vows/commit/936e18a) fix some error messages (`cloudhead`)
- * [64760fe](https://github.com/flatiron/vows/commit/64760fe) (bin) fix exit status (`cloudhead`)
-
-v0.5.2 / Wed, 13 Oct 2010
-=========================
- * [349437b](https://github.com/flatiron/vows/commit/349437b) (dist) version bump (`cloudhead`)
- * [61c01d9](https://github.com/flatiron/vows/commit/61c01d9) tell user if no tests were run. (`cloudhead`)
- * [50077aa](https://github.com/flatiron/vows/commit/50077aa) Pass suite reference to batches (`Yurii Rashkovskii`)
- * [213d6cd](https://github.com/flatiron/vows/commit/213d6cd) Made a change that eliminates the following bug (see http://github.com/cloudhead/vows/issues#issue/16): Sometimes you want to test an object that inherits from EventEmitter. In this case, if you return said testable object as the topic, then the code hangs if the EventEmitter subclass instance that I'm testing doesn't emit "success" or "error." (`bnoguchi`)
-
-v0.5.1 / Tue, 24 Aug 2010
-=========================
- * [679e8a6](https://github.com/flatiron/vows/commit/679e8a6) (dist) version bump (`cloudhead`)
- * [c3ad80d](https://github.com/flatiron/vows/commit/c3ad80d) (new) basic teardown support (`cloudhead`)
-
-v0.5.0 / Tue, 10 Aug 2010
-=========================
- * [7cdf94f](https://github.com/flatiron/vows/commit/7cdf94f) (dist) version bump, update package.json (`cloudhead`)
- * [e8cf93e](https://github.com/flatiron/vows/commit/e8cf93e) (minor) naming/style changes (`cloudhead`)
- * [db57e70](https://github.com/flatiron/vows/commit/db57e70) Add ability to circumvent `addBatch` (`Travis Swicegood`)
- * [36c5c47](https://github.com/flatiron/vows/commit/36c5c47) Add ability to run .coffee files (`Travis Swicegood`)
- * [ccf6ec0](https://github.com/flatiron/vows/commit/ccf6ec0) (doc) fix link (`Alexis Sellier`)
-
-v0.4.6 / Thu, 1 Jul 2010
-========================
- * [d78e098](https://github.com/flatiron/vows/commit/d78e098) (dist) version bump (`cloudhead`)
- * [a6c51c4](https://github.com/flatiron/vows/commit/a6c51c4) better assert.isNaN check (`cloudhead`)
- * [2b7398e](https://github.com/flatiron/vows/commit/2b7398e) ability to pass suite options to export method (`cloudhead`)
- * [4fc9097](https://github.com/flatiron/vows/commit/4fc9097) (new) --no-error (`cloudhead`)
- * [f2eb7b2](https://github.com/flatiron/vows/commit/f2eb7b2) more refactoring in addVow (`cloudhead`)
- * [cca54cf](https://github.com/flatiron/vows/commit/cca54cf) refactor counter updates (`cloudhead`)
- * [c98bcc4](https://github.com/flatiron/vows/commit/c98bcc4) (doc) fix README (`Alexis Sellier`)
- * [726b82f](https://github.com/flatiron/vows/commit/726b82f) updated README for site (`cloudhead`)
-
-v0.4.5 / Mon, 28 Jun 2010
-=========================
- * [ed576d7](https://github.com/flatiron/vows/commit/ed576d7) (dist) version bump (`cloudhead`)
- * [5cdc2ba](https://github.com/flatiron/vows/commit/5cdc2ba) (api) watch mode can take arguments, fixed a couple edge cases (`cloudhead`)
-
-v0.4.4 / Sun, 27 Jun 2010
-=========================
- * [9ea324f](https://github.com/flatiron/vows/commit/9ea324f) (dist) version bump (`cloudhead`)
- * [e0ffeea](https://github.com/flatiron/vows/commit/e0ffeea) fix --version (`cloudhead`)
- * [afd3aab](https://github.com/flatiron/vows/commit/afd3aab) handle edge case in this.callback, where a single boolean is returned (`cloudhead`)
- * [30e6688](https://github.com/flatiron/vows/commit/30e6688) don't exit until stdout is drained (`cloudhead`)
- * [d1b71d8](https://github.com/flatiron/vows/commit/d1b71d8) (test) add an empty batch to make sure it works (`cloudhead`)
- * [92aafed](https://github.com/flatiron/vows/commit/92aafed) improved error message when callback returns uncaught error (`cloudhead`)
- * [93aeaa3](https://github.com/flatiron/vows/commit/93aeaa3) result of this.callback is passed down to nested topics (`cloudhead`)
- * [ae16916](https://github.com/flatiron/vows/commit/ae16916) fixed a bug with falsy topics (`cloudhead`)
-
-v0.4.3 / Thu, 24 Jun 2010
-=========================
- * [335a8ee](https://github.com/flatiron/vows/commit/335a8ee) (dist) version bump (`cloudhead`)
- * [7875366](https://github.com/flatiron/vows/commit/7875366) return an appropriate exit code from bin/vows, depending on success of the tests. (`cloudhead`)
- * [4e1da2f](https://github.com/flatiron/vows/commit/4e1da2f) allow this.callback to be used more flexibly (`cloudhead`)
-
-v0.4.2 / Wed, 23 Jun 2010
-=========================
- * [3d83502](https://github.com/flatiron/vows/commit/3d83502) (dist) version bump (`cloudhead`)
- * [b94c047](https://github.com/flatiron/vows/commit/b94c047) fixed watch mode in OS X Terminal (`cloudhead`)
- * [a532f17](https://github.com/flatiron/vows/commit/a532f17) rename context.name => context.description, and make context.name be the last level only (`cloudhead`)
- * [cd4a763](https://github.com/flatiron/vows/commit/cd4a763) remove throw/doesNotThrow message customization, cause it's fucked (`cloudhead`)
- * [6298227](https://github.com/flatiron/vows/commit/6298227) (minor) fixed grammar in assertion message (`cloudhead`)
-
-v0.4.1 / Thu, 17 Jun 2010
-=========================
- * [a2f11f0](https://github.com/flatiron/vows/commit/a2f11f0) (dist) version bump (`cloudhead`)
- * [df248d4](https://github.com/flatiron/vows/commit/df248d4) include subject in error message (`cloudhead`)
- * [cf3f4e2](https://github.com/flatiron/vows/commit/cf3f4e2) use suite's reporter for errors (`cloudhead`)
- * [833a2a0](https://github.com/flatiron/vows/commit/833a2a0) console.result prints 'dropped' vows (`cloudhead`)
- * [3d1217a](https://github.com/flatiron/vows/commit/3d1217a) detect un-fired vows on exit, and report error (`cloudhead`)
- * [e1d1ea5](https://github.com/flatiron/vows/commit/e1d1ea5) track vows and vow statuses in batches (`cloudhead`)
- * [8917efe](https://github.com/flatiron/vows/commit/8917efe) fix indentation in assert.equal error message (`cloudhead`)
- * [31c46cf](https://github.com/flatiron/vows/commit/31c46cf) (dist) fix Makefile (`cloudhead`)
- * [8ac48b9](https://github.com/flatiron/vows/commit/8ac48b9) rename some internal functions for consistency (`cloudhead`)
- * [0acf40e](https://github.com/flatiron/vows/commit/0acf40e) update --help command (`cloudhead`)
- * [3f3cc66](https://github.com/flatiron/vows/commit/3f3cc66) silent reporter (`cloudhead`)
- * [692cb71](https://github.com/flatiron/vows/commit/692cb71) try to handle async errors more intelligently (`cloudhead`)
- * [7ed9f65](https://github.com/flatiron/vows/commit/7ed9f65) (api) '-m' and '-r' now require a space between pattern (`cloudhead`)
- * [82f6e5e](https://github.com/flatiron/vows/commit/82f6e5e) (new) added more options to bin (`cloudhead`)
- * [75ff4ab](https://github.com/flatiron/vows/commit/75ff4ab) (api) addVows => addBatch (`cloudhead`)
- * [a7f9f30](https://github.com/flatiron/vows/commit/a7f9f30) (test) improve test descriptions (`cloudhead`)
- * [e53338c](https://github.com/flatiron/vows/commit/e53338c) (api) don't add space between context descriptions in some cases (`cloudhead`)
- * [1593768](https://github.com/flatiron/vows/commit/1593768) (test) remove other-test.js (`cloudhead`)
- * [f2ff9b5](https://github.com/flatiron/vows/commit/f2ff9b5) (test) move assert module tests to its own file (`cloudhead`)
- * [5f415df](https://github.com/flatiron/vows/commit/5f415df) output function name in AssertionError, if {expected} is a function (`cloudhead`)
-
-v0.4.0 / Tue, 15 Jun 2010
-=========================
- * [0b32f54](https://github.com/flatiron/vows/commit/0b32f54) (dist) version bump to 0.4.0 (`cloudhead`)
- * [3e0fb87](https://github.com/flatiron/vows/commit/3e0fb87) improve subject appearance in spec.js (`cloudhead`)
- * [29161c7](https://github.com/flatiron/vows/commit/29161c7) make sure we only output on exit, if there's a failure (`cloudhead`)
- * [98418c7](https://github.com/flatiron/vows/commit/98418c7) set batch.status to 'end' when ended (`cloudhead`)
- * [5a3362f](https://github.com/flatiron/vows/commit/5a3362f) catch silent async failures on exit (`cloudhead`)
- * [6546552](https://github.com/flatiron/vows/commit/6546552) don't try to exist when tests complete (`cloudhead`)
- * [7edb97a](https://github.com/flatiron/vows/commit/7edb97a) reset pending vows in Suite#reset (`cloudhead`)
- * [6baca02](https://github.com/flatiron/vows/commit/6baca02) nicer output. refactor of formatters (`cloudhead`)
-
-v0.3.5 / Sun, 13 Jun 2010
-=========================
- * [4a1a65a](https://github.com/flatiron/vows/commit/4a1a65a) (dist) version bump (`cloudhead`)
- * [f10884d](https://github.com/flatiron/vows/commit/f10884d) improved assertion error messages. added tests (`cloudhead`)
- * [72eecd7](https://github.com/flatiron/vows/commit/72eecd7) (new) added new assertions (`cloudhead`)
- * [1e90188](https://github.com/flatiron/vows/commit/1e90188) set styles to false for inspector (`cloudhead`)
- * [47c2d1f](https://github.com/flatiron/vows/commit/47c2d1f) (new) support multiple test suites per file (`cloudhead`)
- * [bb9a5af](https://github.com/flatiron/vows/commit/bb9a5af) abort() function to exit with an error (`cloudhead`)
- * [90e0bae](https://github.com/flatiron/vows/commit/90e0bae) (api) watch mode is activated with -w (`cloudhead`)
- * [1cdfd1c](https://github.com/flatiron/vows/commit/1cdfd1c) don't output contexts for pending vows in watch mode (`cloudhead`)
- * [3416f44](https://github.com/flatiron/vows/commit/3416f44) fix spec reporter + pending vow (`cloudhead`)
- * [4b92fa4](https://github.com/flatiron/vows/commit/4b92fa4) (new api) '-m' matches a string, changes -R to -r (`cloudhead`)
-
-v0.3.4 / Wed, 9 Jun 2010
-========================
- * [25abf72](https://github.com/flatiron/vows/commit/25abf72) (dist) version bump (`cloudhead`)
- * [8052146](https://github.com/flatiron/vows/commit/8052146) fix/improve the cleanup on exit (`cloudhead`)
- * [df83078](https://github.com/flatiron/vows/commit/df83078) print a different cue when running tests in watch mode (`cloudhead`)
- * [c533efa](https://github.com/flatiron/vows/commit/c533efa) fix context reporting for dot-matrix (`cloudhead`)
- * [3e67750](https://github.com/flatiron/vows/commit/3e67750) remove deprecated 'brief' option (`cloudhead`)
- * [11a1edd](https://github.com/flatiron/vows/commit/11a1edd) (new) tests can be 'pending' (`cloudhead`)
- * [062450c](https://github.com/flatiron/vows/commit/062450c) handle this.callback called synchronously (`cloudhead`)
-
-v0.3.3 / Tue, 8 Jun 2010
-========================
- * [311df5f](https://github.com/flatiron/vows/commit/311df5f) (dist) version bump (`cloudhead`)
- * [55a7a92](https://github.com/flatiron/vows/commit/55a7a92) print contexts in dot-matrix & watch output (`cloudhead`)
- * [06b5563](https://github.com/flatiron/vows/commit/06b5563) (doc) updated README (`cloudhead`)
-
-v0.3.2 / Mon, 7 Jun 2010
-========================
- * [4079f57](https://github.com/flatiron/vows/commit/4079f57) (dist) version bump (`cloudhead`)
- * [cca5d46](https://github.com/flatiron/vows/commit/cca5d46) move inspect() to vows/console (`cloudhead`)
-
-v0.3.1 / Mon, 7 Jun 2010
-========================
- * [fe7ae18](https://github.com/flatiron/vows/commit/fe7ae18) (dist) version bump (`cloudhead`)
- * [a0dacb7](https://github.com/flatiron/vows/commit/a0dacb7) Set default for `options` in run(). (`cloudhead`)
- * [e27bdfc](https://github.com/flatiron/vows/commit/e27bdfc) round time output (`cloudhead`)
-
-v0.3.0 / Sat, 5 Jun 2010
-========================
- * [868cd9f](https://github.com/flatiron/vows/commit/868cd9f) ability to print messages without a nl (`cloudhead`)
- * [b851ffe](https://github.com/flatiron/vows/commit/b851ffe) only the spec reporter prints subjects (`cloudhead`)
- * [d5b0d34](https://github.com/flatiron/vows/commit/d5b0d34) pattern matching is operational (`cloudhead`)
- * [09e31cf](https://github.com/flatiron/vows/commit/09e31cf) better remaining vow detection and handling (`cloudhead`)
- * [b3985d8](https://github.com/flatiron/vows/commit/b3985d8) we don't support vows as functions anymore (`cloudhead`)
- * [a2e15a2](https://github.com/flatiron/vows/commit/a2e15a2) better vow counting (`cloudhead`)
- * [7beb71d](https://github.com/flatiron/vows/commit/7beb71d) parse vows at run-time, so we can apply a matcher (`cloudhead`)
- * [247015b](https://github.com/flatiron/vows/commit/247015b) use options in run() or default to Suite (`cloudhead`)
- * [ee77415](https://github.com/flatiron/vows/commit/ee77415) Suite-level matcher/reporter (`cloudhead`)
- * [aae87c2](https://github.com/flatiron/vows/commit/aae87c2) no more global module state (`cloudhead`)
- * [f825f7f](https://github.com/flatiron/vows/commit/f825f7f) tidy up the requires in bin/vows (`cloudhead`)
- * [b9d856e](https://github.com/flatiron/vows/commit/b9d856e) (dist) lib is lib/vows (`cloudhead`)
- * [2f9bb00](https://github.com/flatiron/vows/commit/2f9bb00) (dist) added bin to package.json (`cloudhead`)
- * [575d1a5](https://github.com/flatiron/vows/commit/575d1a5) updated Makefile to use test runner (`cloudhead`)
- * [7d93078](https://github.com/flatiron/vows/commit/7d93078) (dist) version bump (`cloudhead`)
- * [c3afbbc](https://github.com/flatiron/vows/commit/c3afbbc) revised vows.js header (`cloudhead`)
- * [ec867b6](https://github.com/flatiron/vows/commit/ec867b6) output fixes (`cloudhead`)
- * [1f2abe5](https://github.com/flatiron/vows/commit/1f2abe5) (new) watch reporter (`cloudhead`)
- * [b9882a5](https://github.com/flatiron/vows/commit/b9882a5) add print() function to reporters (`cloudhead`)
- * [151b76c](https://github.com/flatiron/vows/commit/151b76c) fuck the buffer (`cloudhead`)
- * [1ab43bd](https://github.com/flatiron/vows/commit/1ab43bd) report subject on run() (`cloudhead`)
- * [88b5ade](https://github.com/flatiron/vows/commit/88b5ade) complete rewrite of bin/vows (`cloudhead`)
- * [af04a10](https://github.com/flatiron/vows/commit/af04a10) exported Suites also run automatically when file is run directly (`cloudhead`)
- * [244cd01](https://github.com/flatiron/vows/commit/244cd01) reset Suite before running it, instead of after, so we don't upset the exit check (`cloudhead`)
- * [7ce4579](https://github.com/flatiron/vows/commit/7ce4579) another test, just to test runner (`cloudhead`)
- * [0e3b661](https://github.com/flatiron/vows/commit/0e3b661) ability to export batch/suite (`cloudhead`)
- * [073e875](https://github.com/flatiron/vows/commit/073e875) ability to reset batch/suite (`cloudhead`)
- * [bd8a4f8](https://github.com/flatiron/vows/commit/bd8a4f8) refactor reporters, share more. (`cloudhead`)
- * [8cd49ba](https://github.com/flatiron/vows/commit/8cd49ba) 'reporter' option instead of boolean flags. Also pass subject to Suite. (`cloudhead`)
- * [e2d1951](https://github.com/flatiron/vows/commit/e2d1951) bye bye addVow (`cloudhead`)
- * [e5855a2](https://github.com/flatiron/vows/commit/e5855a2) fix dot-matrix reporter not reporting errors (`cloudhead`)
- * [6fe14ec](https://github.com/flatiron/vows/commit/6fe14ec) suite.js init (`cloudhead`)
- * [b9c0329](https://github.com/flatiron/vows/commit/b9c0329) Complete re-architecturing of vows. (`cloudhead`)
- * [4adab80](https://github.com/flatiron/vows/commit/4adab80) dot-matrix is the default reporter (`cloudhead`)
- * [e16cadf](https://github.com/flatiron/vows/commit/e16cadf) (dist) cleanup Makefile (`cloudhead`)
- * [7200208](https://github.com/flatiron/vows/commit/7200208) moved vows.prepare to extras.js (`cloudhead`)
- * [14278d0](https://github.com/flatiron/vows/commit/14278d0) cleaned up project structure a little (`cloudhead`)
- * [fb7d8a9](https://github.com/flatiron/vows/commit/fb7d8a9) extracted console utils out of spec/dot-matrix reporters (`cloudhead`)
- * [ba8c46e](https://github.com/flatiron/vows/commit/ba8c46e) (new) dot-matrix reporter (`cloudhead`)
-
-v0.2.5 / Mon, 24 May 2010
-=========================
- * [0a53b70](https://github.com/flatiron/vows/commit/0a53b70) (dist) version bump (`cloudhead`)
- * [ce73ecd](https://github.com/flatiron/vows/commit/ce73ecd) Cleaned up the inner loop a little (`cloudhead`)
- * [9fa313c](https://github.com/flatiron/vows/commit/9fa313c) Fix incorrect binding in test functions. (`cloudhead`)
-
-v0.2.4 / Sun, 23 May 2010
-=========================
- * [b10a30a](https://github.com/flatiron/vows/commit/b10a30a) (dist) version bump (`cloudhead`)
- * [2f231b1](https://github.com/flatiron/vows/commit/2f231b1) (doc) updated README with assertion macros (`cloudhead`)
- * [179f854](https://github.com/flatiron/vows/commit/179f854) (new) assert.instanceOf assert.isUndefined (`cloudhead`)
- * [87afe4c](https://github.com/flatiron/vows/commit/87afe4c) don't complain about return value in topic if old (`cloudhead`)
-
-v0.2.3 / Sat, 22 May 2010
-=========================
- * [f867791](https://github.com/flatiron/vows/commit/f867791) (dist) version bump (`cloudhead`)
- * [cb9e66e](https://github.com/flatiron/vows/commit/cb9e66e) (new) added assert.isNull, and made isObject more robust (`cloudhead`)
- * [cf459bc](https://github.com/flatiron/vows/commit/cf459bc) fixed inspector doing weird shit. (`cloudhead`)
-
-v0.2.2 / Sat, 22 May 2010
-=========================
- * [5df28a5](https://github.com/flatiron/vows/commit/5df28a5) (dist) version bump (`cloudhead`)
- * [c741f7b](https://github.com/flatiron/vows/commit/c741f7b) (minor doc) typo in README (`cloudhead`)
- * [8092bb3](https://github.com/flatiron/vows/commit/8092bb3) throw error when this.callback with a return value (`cloudhead`)
- * [70cf79e](https://github.com/flatiron/vows/commit/70cf79e) (minor) standardized error messages (`cloudhead`)
- * [a214eb8](https://github.com/flatiron/vows/commit/a214eb8) (new) Support for callback-style async testing (`cloudhead`)
- * [c600238](https://github.com/flatiron/vows/commit/c600238) (doc) new install instructions (`cloudhead`)
- * [473e215](https://github.com/flatiron/vows/commit/473e215) (dist) fixed dependencies (`cloudhead`)
- * [0083f0a](https://github.com/flatiron/vows/commit/0083f0a) (dist) version bump (`cloudhead`)
- * [94a58be](https://github.com/flatiron/vows/commit/94a58be) (dist) updated paths and package.json (`cloudhead`)
- * [03a4171](https://github.com/flatiron/vows/commit/03a4171) (new) test for NaN, and added assert.isNaN (`cloudhead`)
- * [3f4bbec](https://github.com/flatiron/vows/commit/3f4bbec) throw Error if missing top-level context (`cloudhead`)
- * [748e1ee](https://github.com/flatiron/vows/commit/748e1ee) added 'install' task (`cloudhead`)
- * [babc2e6](https://github.com/flatiron/vows/commit/babc2e6) version bump to 0.2.0 (`cloudhead`)
-
-v0.2.0 / Mon, 17 May 2010
-=========================
- * [fba631c](https://github.com/flatiron/vows/commit/fba631c) (minor) renamed statusText to status (`cloudhead`)
- * [bf80bec](https://github.com/flatiron/vows/commit/bf80bec) time can equal 0, check more reliably (`cloudhead`)
- * [98c70ad](https://github.com/flatiron/vows/commit/98c70ad) make console reporter a little more powerful (`cloudhead`)
- * [1606341](https://github.com/flatiron/vows/commit/1606341) use json reporter if --json is passed (`cloudhead`)
- * [8a1d447](https://github.com/flatiron/vows/commit/8a1d447) overhaul of continuous testing functionality, to use json backend (`cloudhead`)
- * [cc041ee](https://github.com/flatiron/vows/commit/cc041ee) fix JSON reporter (`cloudhead`)
- * [a604161](https://github.com/flatiron/vows/commit/a604161) renamed 'printer' -> 'reporter' (`cloudhead`)
- * [dc9a746](https://github.com/flatiron/vows/commit/dc9a746) Decouple the reporting system. (`cloudhead`)
- * [aba0f57](https://github.com/flatiron/vows/commit/aba0f57) updated SS (`Alexis Sellier`)
- * [1882f19](https://github.com/flatiron/vows/commit/1882f19) (fix) topics getting added multiple times (`cloudhead`)
- * [f59fb55](https://github.com/flatiron/vows/commit/f59fb55) version bump (`cloudhead`)
-
-v0.1.4 / Sun, 16 May 2010
-=========================
- * [f887206](https://github.com/flatiron/vows/commit/f887206) (fix) output the subjects without need for nextTick (`cloudhead`)
- * [1cb886c](https://github.com/flatiron/vows/commit/1cb886c) (fix) count vows properly, by skipping 'topic' keys (`cloudhead`)
- * [6454351](https://github.com/flatiron/vows/commit/6454351) fixed bug with function returning topics (`cloudhead`)
- * [053d7de](https://github.com/flatiron/vows/commit/053d7de) (test) topics returning functions (`cloudhead`)
- * [28f23ca](https://github.com/flatiron/vows/commit/28f23ca) make sure result doesn't precede title (`cloudhead`)
- * [219ea81](https://github.com/flatiron/vows/commit/219ea81) fix lastTopic not being set properly (`cloudhead`)
- * [0cefa91](https://github.com/flatiron/vows/commit/0cefa91) version bump (`cloudhead`)
-
-v0.1.3 / Wed, 12 May 2010
-=========================
- * [e97b946](https://github.com/flatiron/vows/commit/e97b946) pass emitted errors if test is expecting it (`cloudhead`)
- * [d79b6d5](https://github.com/flatiron/vows/commit/d79b6d5) fixed assert.include on objects (`cloudhead`)
- * [e43aa0e](https://github.com/flatiron/vows/commit/e43aa0e) added assert.length & assert.isFunction (`cloudhead`)
- * [99eb7de](https://github.com/flatiron/vows/commit/99eb7de) improved emitter code in describe() (`cloudhead`)
- * [8a4f76d](https://github.com/flatiron/vows/commit/8a4f76d) vows.describe is the default now (`cloudhead`)
-
-v0.1.2 / Tue, 11 May 2010
-=========================
- * [06290ee](https://github.com/flatiron/vows/commit/06290ee) updated readme/comments to new API (`cloudhead`)
- * [fee2e78](https://github.com/flatiron/vows/commit/fee2e78) version bump (`cloudhead`)
- * [15648b1](https://github.com/flatiron/vows/commit/15648b1) 'end' takes some parameters (`cloudhead`)
- * [a54c076](https://github.com/flatiron/vows/commit/a54c076) when passing a function, there is no promise, also print an nl (`cloudhead`)
- * [4fc5b9c](https://github.com/flatiron/vows/commit/4fc5b9c) only count vows if passing an object to addVows() (`cloudhead`)
- * [0dd8387](https://github.com/flatiron/vows/commit/0dd8387) tests. (`cloudhead`)
- * [cb3ab7e](https://github.com/flatiron/vows/commit/cb3ab7e) don't require a topic at all (`cloudhead`)
- * [57fa14b](https://github.com/flatiron/vows/commit/57fa14b) use 'end' as a completion event for test-suites (`cloudhead`)
- * [68e147d](https://github.com/flatiron/vows/commit/68e147d) pass the test-suite promises to tryFinish() (`cloudhead`)
- * [bfa2a26](https://github.com/flatiron/vows/commit/bfa2a26) keep track of the number of test suites (`cloudhead`)
- * [f394e79](https://github.com/flatiron/vows/commit/f394e79) test for chained vows (`cloudhead`)
- * [b7a65c0](https://github.com/flatiron/vows/commit/b7a65c0) vow counting is sync. emit success when local remaining == 0 (`cloudhead`)
- * [b95d282](https://github.com/flatiron/vows/commit/b95d282) API change, ability to run serial test suites (`cloudhead`)
- * [fa51949](https://github.com/flatiron/vows/commit/fa51949) allow nested contexts with no topics (`cloudhead`)
- * [0b891d6](https://github.com/flatiron/vows/commit/0b891d6) topic/subject ref fix (`cloudhead`)
- * [6e49a11](https://github.com/flatiron/vows/commit/6e49a11) write an error if an EventEmitter hasn't fired (`cloudhead`)
- * [06485b8](https://github.com/flatiron/vows/commit/06485b8) added spinning wheel (`cloudhead`)
- * [8260e38](https://github.com/flatiron/vows/commit/8260e38) updated READMe (`cloudhead`)
- * [8a03c2a](https://github.com/flatiron/vows/commit/8a03c2a) 'setup' is now called 'topic' (`cloudhead`)
- * [a7b5857](https://github.com/flatiron/vows/commit/a7b5857) allow non-function subjects (`cloudhead`)
- * [11d2e8f](https://github.com/flatiron/vows/commit/11d2e8f) added isEmpty and typeOf assertion macros (`cloudhead`)
-
-v0.1.1 / Sun, 2 May 2010
-========================
- * [abadd5d](https://github.com/flatiron/vows/commit/abadd5d) updated eyes (`cloudhead`)
- * [1198d46](https://github.com/flatiron/vows/commit/1198d46) evaluate everything within an 'environment', which is passed down (`cloudhead`)
- * [531d4bf](https://github.com/flatiron/vows/commit/531d4bf) refactored escape code printing (`cloudhead`)
- * [c1167bd](https://github.com/flatiron/vows/commit/c1167bd) package.json (`cloudhead`)
- * [d15c538](https://github.com/flatiron/vows/commit/d15c538) rename makefile to Makefile (`cloudhead`)
- * [333a7f2](https://github.com/flatiron/vows/commit/333a7f2) attempt to detect the name of the test folder (`cloudhead`)
- * [3cfd5a5](https://github.com/flatiron/vows/commit/3cfd5a5) explicitly return vows.promise from test runner (`cloudhead`)
- * [b78539e](https://github.com/flatiron/vows/commit/b78539e) allow access to Context object, from tests (`cloudhead`)
- * [1348def](https://github.com/flatiron/vows/commit/1348def) describe is an alias of tell (`cloudhead`)
- * [ba08ca3](https://github.com/flatiron/vows/commit/ba08ca3) use typeof instead of instanceof (`cloudhead`)
-
-v0.1.0 / Sat, 1 May 2010
-========================
- * [547d478](https://github.com/flatiron/vows/commit/547d478) forgot to remove some test code (`cloudhead`)
- * [5bba9c3](https://github.com/flatiron/vows/commit/5bba9c3) default value for matcher (`cloudhead`)
- * [1a64009](https://github.com/flatiron/vows/commit/1a64009) bin/vows, autotesting utility (`cloudhead`)
- * [051bb40](https://github.com/flatiron/vows/commit/051bb40) formatting (`cloudhead`)
- * [3db9c6a](https://github.com/flatiron/vows/commit/3db9c6a) the matcher is an option now. -R'match string' (`cloudhead`)
- * [d4d7e3e](https://github.com/flatiron/vows/commit/d4d7e3e) the --brief option. Also fixed various buffering problems (`cloudhead`)
- * [6d6c950](https://github.com/flatiron/vows/commit/6d6c950) changed spacing in test output (`cloudhead`)
- * [8b2afda](https://github.com/flatiron/vows/commit/8b2afda) don't use a Vow object, just use Object.create() (`cloudhead`)
- * [70ef3a6](https://github.com/flatiron/vows/commit/70ef3a6) whitespace (`cloudhead`)
- * [1d14683](https://github.com/flatiron/vows/commit/1d14683) Buffer test output, return EventEmitter. (`cloudhead`)
- * [50f76f8](https://github.com/flatiron/vows/commit/50f76f8) other repos should be submodules (`Matt Lyon`)
- * [1b02c0a](https://github.com/flatiron/vows/commit/1b02c0a) bugfix: only add setup vals to context once (`Matt Lyon`)
diff --git a/LICENSE b/LICENSE
index d6456956..a1edd93b 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,202 +1,20 @@
-
- Apache License
- Version 2.0, January 2004
- http://www.apache.org/licenses/
-
- TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
- 1. Definitions.
-
- "License" shall mean the terms and conditions for use, reproduction,
- and distribution as defined by Sections 1 through 9 of this document.
-
- "Licensor" shall mean the copyright owner or entity authorized by
- the copyright owner that is granting the License.
-
- "Legal Entity" shall mean the union of the acting entity and all
- other entities that control, are controlled by, or are under common
- control with that entity. For the purposes of this definition,
- "control" means (i) the power, direct or indirect, to cause the
- direction or management of such entity, whether by contract or
- otherwise, or (ii) ownership of fifty percent (50%) or more of the
- outstanding shares, or (iii) beneficial ownership of such entity.
-
- "You" (or "Your") shall mean an individual or Legal Entity
- exercising permissions granted by this License.
-
- "Source" form shall mean the preferred form for making modifications,
- including but not limited to software source code, documentation
- source, and configuration files.
-
- "Object" form shall mean any form resulting from mechanical
- transformation or translation of a Source form, including but
- not limited to compiled object code, generated documentation,
- and conversions to other media types.
-
- "Work" shall mean the work of authorship, whether in Source or
- Object form, made available under the License, as indicated by a
- copyright notice that is included in or attached to the work
- (an example is provided in the Appendix below).
-
- "Derivative Works" shall mean any work, whether in Source or Object
- form, that is based on (or derived from) the Work and for which the
- editorial revisions, annotations, elaborations, or other modifications
- represent, as a whole, an original work of authorship. For the purposes
- of this License, Derivative Works shall not include works that remain
- separable from, or merely link (or bind by name) to the interfaces of,
- the Work and Derivative Works thereof.
-
- "Contribution" shall mean any work of authorship, including
- the original version of the Work and any modifications or additions
- to that Work or Derivative Works thereof, that is intentionally
- submitted to Licensor for inclusion in the Work by the copyright owner
- or by an individual or Legal Entity authorized to submit on behalf of
- the copyright owner. For the purposes of this definition, "submitted"
- means any form of electronic, verbal, or written communication sent
- to the Licensor or its representatives, including but not limited to
- communication on electronic mailing lists, source code control systems,
- and issue tracking systems that are managed by, or on behalf of, the
- Licensor for the purpose of discussing and improving the Work, but
- excluding communication that is conspicuously marked or otherwise
- designated in writing by the copyright owner as "Not a Contribution."
-
- "Contributor" shall mean Licensor and any individual or Legal Entity
- on behalf of whom a Contribution has been received by Licensor and
- subsequently incorporated within the Work.
-
- 2. Grant of Copyright License. Subject to the terms and conditions of
- this License, each Contributor hereby grants to You a perpetual,
- worldwide, non-exclusive, no-charge, royalty-free, irrevocable
- copyright license to reproduce, prepare Derivative Works of,
- publicly display, publicly perform, sublicense, and distribute the
- Work and such Derivative Works in Source or Object form.
-
- 3. Grant of Patent License. Subject to the terms and conditions of
- this License, each Contributor hereby grants to You a perpetual,
- worldwide, non-exclusive, no-charge, royalty-free, irrevocable
- (except as stated in this section) patent license to make, have made,
- use, offer to sell, sell, import, and otherwise transfer the Work,
- where such license applies only to those patent claims licensable
- by such Contributor that are necessarily infringed by their
- Contribution(s) alone or by combination of their Contribution(s)
- with the Work to which such Contribution(s) was submitted. If You
- institute patent litigation against any entity (including a
- cross-claim or counterclaim in a lawsuit) alleging that the Work
- or a Contribution incorporated within the Work constitutes direct
- or contributory patent infringement, then any patent licenses
- granted to You under this License for that Work shall terminate
- as of the date such litigation is filed.
-
- 4. Redistribution. You may reproduce and distribute copies of the
- Work or Derivative Works thereof in any medium, with or without
- modifications, and in Source or Object form, provided that You
- meet the following conditions:
-
- (a) You must give any other recipients of the Work or
- Derivative Works a copy of this License; and
-
- (b) You must cause any modified files to carry prominent notices
- stating that You changed the files; and
-
- (c) You must retain, in the Source form of any Derivative Works
- that You distribute, all copyright, patent, trademark, and
- attribution notices from the Source form of the Work,
- excluding those notices that do not pertain to any part of
- the Derivative Works; and
-
- (d) If the Work includes a "NOTICE" text file as part of its
- distribution, then any Derivative Works that You distribute must
- include a readable copy of the attribution notices contained
- within such NOTICE file, excluding those notices that do not
- pertain to any part of the Derivative Works, in at least one
- of the following places: within a NOTICE text file distributed
- as part of the Derivative Works; within the Source form or
- documentation, if provided along with the Derivative Works; or,
- within a display generated by the Derivative Works, if and
- wherever such third-party notices normally appear. The contents
- of the NOTICE file are for informational purposes only and
- do not modify the License. You may add Your own attribution
- notices within Derivative Works that You distribute, alongside
- or as an addendum to the NOTICE text from the Work, provided
- that such additional attribution notices cannot be construed
- as modifying the License.
-
- You may add Your own copyright statement to Your modifications and
- may provide additional or different license terms and conditions
- for use, reproduction, or distribution of Your modifications, or
- for any such Derivative Works as a whole, provided Your use,
- reproduction, and distribution of the Work otherwise complies with
- the conditions stated in this License.
-
- 5. Submission of Contributions. Unless You explicitly state otherwise,
- any Contribution intentionally submitted for inclusion in the Work
- by You to the Licensor shall be under the terms and conditions of
- this License, without any additional terms or conditions.
- Notwithstanding the above, nothing herein shall supersede or modify
- the terms of any separate license agreement you may have executed
- with Licensor regarding such Contributions.
-
- 6. Trademarks. This License does not grant permission to use the trade
- names, trademarks, service marks, or product names of the Licensor,
- except as required for reasonable and customary use in describing the
- origin of the Work and reproducing the content of the NOTICE file.
-
- 7. Disclaimer of Warranty. Unless required by applicable law or
- agreed to in writing, Licensor provides the Work (and each
- Contributor provides its Contributions) on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
- implied, including, without limitation, any warranties or conditions
- of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
- PARTICULAR PURPOSE. You are solely responsible for determining the
- appropriateness of using or redistributing the Work and assume any
- risks associated with Your exercise of permissions under this License.
-
- 8. Limitation of Liability. In no event and under no legal theory,
- whether in tort (including negligence), contract, or otherwise,
- unless required by applicable law (such as deliberate and grossly
- negligent acts) or agreed to in writing, shall any Contributor be
- liable to You for damages, including any direct, indirect, special,
- incidental, or consequential damages of any character arising as a
- result of this License or out of the use or inability to use the
- Work (including but not limited to damages for loss of goodwill,
- work stoppage, computer failure or malfunction, or any and all
- other commercial damages or losses), even if such Contributor
- has been advised of the possibility of such damages.
-
- 9. Accepting Warranty or Additional Liability. While redistributing
- the Work or Derivative Works thereof, You may choose to offer,
- and charge a fee for, acceptance of support, warranty, indemnity,
- or other liability obligations and/or rights consistent with this
- License. However, in accepting such obligations, You may act only
- on Your own behalf and on Your sole responsibility, not on behalf
- of any other Contributor, and only if You agree to indemnify,
- defend, and hold each Contributor harmless for any liability
- incurred by, or claims asserted against, such Contributor by reason
- of your accepting any such warranty or additional liability.
-
- END OF TERMS AND CONDITIONS
-
- APPENDIX: How to apply the Apache License to your work.
-
- To apply the Apache License to your work, attach the following
- boilerplate notice, with the fields enclosed by brackets "[]"
- replaced with your own identifying information. (Don't include
- the brackets!) The text should be enclosed in the appropriate
- comment syntax for the file format. We also recommend that a
- file or class name and description of purpose be included on the
- same "printed page" as the copyright notice for easier
- identification within third-party archives.
-
- Copyright [yyyy] [name of copyright owner]
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
+Copyright (c) 2009 cloudhead
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/Makefile b/Makefile
new file mode 100644
index 00000000..6bf89912
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,7 @@
+#
+# Run all tests
+#
+test:
+ @@bin/vows test/*
+
+.PHONY: test install
diff --git a/README.md b/README.md
index a1cd56ad..bfa410e9 100644
--- a/README.md
+++ b/README.md
@@ -1,592 +1,65 @@
-# vows
+Vows
+====
-vows is a testing framework for NodeJS.
+> Asynchronous BDD & continuous integration for node.js
-## License
+#### #
- - Copyright 2016-2018 fuzzy.ai
- - Copyright 2017 AJ Jordan
+introduction
+------------
+There are two reasons why we might want asynchronous testing. The first, and obvious reason is that node.js is asynchronous, and therefore our tests need to be. The second reason is to make test suites which target I/O libraries run much faster.
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
+_Vows_ is an experiment in making this possible, while adding a minimum of overhead.
-
+synopsis
+--------
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
+ var vows = require('vows'),
+ assert = require('assert');
-## Example
+ vows.describe('Deep Thought').addBatch({
+ 'An instance of DeepThought': {
+ topic: new DeepThought,
-```javascript
-
-var vows = require('vows');
-
-// vows does not pollute the assert module namespace by default
-
-var assert = vows.assert;
-
-vows
- .describe("My first vows test")
- .addBatch({
- 'When we open a file': {
- topic: function() {
- fs.open("/tmp/fakefile", "w", this.callback);
- },
- 'it works': function(err, fd) {
- assert.ifError(err);
- assert.isNumber(fd);
- },
- teardown: function(fd) {
- fs.close(fd, this.callback);
- }
- 'and we write to the file': {
- topic: function(fd) {
- fs.write(fd, "My dog has fleas\n", this.callback);
- },
- 'it works': function(err, written, buffer) {
- assert.ifError(err);
- assert.greater(written, 0);
- assert.isString(buffer);
- }
- }
- }
- })
- .run();
-
-```
-
-## Introduction
-
-### Requiring
-
-You require the module like any other module.
-
-### Assert macros
-
-vows provides its own suite of assert macros. To use them, you should use the
-`assert` property from the `vows` module, like so:
-
-```javascript
-var vows = require('vows');
-var assert = vows.assert;
-```
-
-### Data structures
-
-The basic way to use tests is to build really large hierarchical
-objects with a particular well-defined form.
-
-### Batch
-
-For `vows`, the core concept is the test `batch`. A batch is an object that
-consists of the following:
-
- - A `topic` function that generates values to be tested
-
- - One or more test functions, which accept the results of the `topic` and
- use assert macros to validate the results
-
- - Zero or more sub-batches
-
- - An optional `teardown` function that cleans up any values generated by the
- topic
-
-A batch can be either *synchronous* or *asynchronous*. For a synchronous batch,
-the `topic` function just returns a value, and the test functions measure that
-value:
-
-```javascript
-let batch = {
- "We get the answer": {
- topic() {
- return 6 * 7;
- },
- "it equals 42": (err, answer) => {
- assert.ifError(err);
- assert.equal(answer, 42);
- }
- }
-};
-```
-
-For an asynchronous batch, the topic returns its results through the `callback`
-property of `this`. `vows` knows that the callback will be used because the
-result returned by the `topic` function is `undefined`.
-
-```javascript
-let batch = {
- "When we get the answer asynchronously": {
- topic() {
- setImmediate(() => {
- this.callback(null, 6 * 7);
- });
- return undefined;
- },
- "it equals 42": (err, answer) => {
- assert.ifError(err);
- assert.equal(answer, 42);
- }
- }
-};
-```
-
-Alternately, a topic can return a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise).
-vows will resolve the returned Promise and call tests with the same
-`(err, results)` format as with other types of call.
-
-```javascript
-let batch = {
- "When we get the answer": {
- topic() {
- return new Promise((resolve, reject) => {
- fs.open("/tmp/testfile", "w", (err, fd) => {
- if (err) {
- reject(err);
- } else {
- resolve(fd);
- }
- })
- });
- },
- "it equals 42": (err, fd) => {
- assert.ifError(err);
- assert.isNumber(fd);
- }
- }
-};
-```
-
-Note that all test functions receive at least an `err` argument, and then one or
-more arguments. Synchronous batches can only have one test argument;
-asynchronous batches can have a lot.
-
-For backwards compatibility, it's possible to call `this.callback` synchronously
-in your `topic`. vows will simply call `setImmediate` to call the callback
-later. But that is a tricky and confusing way to write your tests, and you
-should probably avoid it.
-
-A batch can also have sub-batches. These are just properties of the batch that
-are also batch objects, with their own `topic`, tests, sub-batches, `teardown`,
-etc. The argument to the topic will be the results of the parent batch, in
-reverse order up the hierarchy.
-
-```javascript
-let batch = {
- "When we get the answer": {
- topic() {
- return 6 * 7;
- },
- "it equals 42": (err, answer) => {
- assert.ifError(err);
- assert.isNumber(answer);
- assert.equal(answer, 42);
- },
- "and we ask a couple of questions": {
- topic(answer) {
- return [
- "What is six times seven?",
- "How many roads must a person walk down?"
- ];
- },
- "they look plausible": (err, questions) => {
- assert.ifError(err);
- assert.isString(question[0]);
- assert.equal(question[0][question[0].length - 1], '?');
- assert.isString(question[1]);
- assert.equal(question[1][question[1].length - 1], '?');
- },
- "and we compare the answer and the question": {
- topic(questions, answer) {
- setImmediate(() => {
- this.callback(null, questions[0], questions[1], answer);
- });
- return undefined;
- },
- "they match up well": (err, question0, question1, answer) => {
- assert.ifError(err);
- // NB: you need to implement isAnswerTo yourself
- assert(isAnswerTo(answer, question0));
- assert(isAnswerTo(answer, question1));
- }
- }
- }
- }
-};
-```
-
-Note that if a batch's `topic` returns more than one value to its callback, they
-will be provided *in order* for any sub-batches' `topic`, but hierarchically
-*in reverse order*. This may be a little confusing.
-
-Note also that if an error occurs, in either the topic or the tests, the
-sub-batches will not be run.
-
-The `teardown` method is called after all the tests and sub-batches have been
-run. So, the order is something like this:
-
- - topic
- - tests
- - sub-batches (if there are no errors)
- - teardown
-
-The `teardown` gets the non-error results of the `topic` as arguments. It's
-useful for cleaning up things that the `topic` made a mess of.
-
-```javascript
-
-batch = {
- 'When we open a file': {
- topic: function() {
- fs.open("/tmp/fakefile", "w", this.callback);
- },
- 'it works': function(err, fd) {
- assert.ifError(err);
- assert.isNumber(fd);
- },
- teardown: function(fd) {
- fs.close(fd, this.callback);
- }
- }
-};
-
-```
-
-`teardown` functions can also be synchronous or asynchronous, or they can return
-a Promise. However, the results are ignored.
-
-```javascript
-let batch = {
- "When we get the answer": {
- topic() {
- return new Promise((resolve, reject) => {
- fs.open("/tmp/testfile", "w", (err, fd) => {
- if (err) {
- reject(err);
- } else {
- resolve(fd);
- }
- })
- });
- },
- "it equals 42": (err, fd) => {
- assert.ifError(err);
- assert.isNumber(fd);
- },
- teardown(fd) {
- return new Promise((resolve, reject) => {
- if (typeof(fd) != 'number') {
- reject(new Error("File descriptor is not a number"));
- } else {
- fs.close(fd, (err) => {
- if (err) {
- reject(err);
- } else {
- resolve();
+ 'should know the answer to the ultimate question of life': function (deepThought) {
+ assert.equal (deepThought.question('what is the answer to the universe?'), 42);
}
- })
}
- });
- }
- }
-};
-```
-
-Note that the teardown will be called regardless of whether errors happened or
-not, so it's a good idea to check the arguments to make sure they're valid.
-
-Teardowns are called as soon as the batch finishes; this is different from how
-vows.js works, but it is better.
-
-If you're using a version of node that can handle [async/await syntax](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function),
-(>= 7.10.1), you can use async functions in your topics and teardowns, which can
-make your aysnchronous test code about as lovely and compact as can be.
-
-```javascript
-
-const fs = require('fs');
-const util = require('util');
-
-// util.promisify is available in node > 8.0.0
-
-const open = util.promisify(fs.open);
-const close = util.promisify(fs.close);
-
-let batch = {
- "When we get the answer": {
- topic: async function () {
- return await open("/tmp/testfile", "w");
- },
- "it equals 42": (err, fd) => {
- assert.ifError(err);
- assert.isNumber(fd);
- },
- teardown: async function (fd) {
- return await close(fd);
- }
- }
-};
-```
-
-### Suite
-
-Batches are organized into suites. You create a suite with the `describe` method
-of `vows`.
-
-```javascript
-const vows = require('vows');
-
-let suite = vows.describe('A new suite');
-```
-
-You can then add one or more batches to the suite using the `addBatch` method.
-
-```javascript
-suite.addBatch(batch1);
-suite.addBatch(batch2);
-suite.addBatch(batch3);
-```
-
-Finally, you have two options to actually run the test suite. The first is the
-aptly-named `run()` method, which runs all the tests and reports the results to
-`stdout`. You can then run the script through node and you'll run all your
-tests.
-
-Alternately, you can use the `export()` method, passing the current `module` as
-an argument. This will change the `exports` property of the `module` to be the
-`run()` method of the suite. In other words, the module will now export a single
-function that runs the suite.
-
-The `vows` command-line tool can be used to run all your test modules that
-use `export()`.
-
-```shell
-./node_modules/.bin/vows test/*.js
-```
-
-All the suite methods are [chainable](https://en.wikipedia.org/wiki/Method_chaining).
-The typical way to actually use this library, then, is to require vows, use the
-`describe` method to create a suite, use `addBatch` to add one or more batches,
-and then use `export(module)` or more rarely `run()` to run the suite.
-
-```javascript
-const fs = require('fs');
-const vows = require('vows');
-let assert = vows.assert;
-
-vows.describe('Input/output tests')
- .addBatch({
- 'When we open a file': {
- topic: function() {
- fs.open("/tmp/fakefile", "w", this.callback);
- },
- 'it works': function(err, fd) {
- assert.ifError(err);
- assert.isNumber(fd);
- },
- teardown: function(fd) {
- fs.close(fd, this.callback);
- }
- }
- })
- .export(module);
-```
-
-### CoffeeScript
-
-[CoffeeScript](http://coffeescript.org/) is a nice pre-processor for JavaScript.
-If you write your test scripts in CoffeeScript, it's totally OK to run them with
-the `vows` command-line tool, as-is.
-
-```shell
-./node_modules/.bin/vows test/*.js test/*.coffee
-```
-
-`vows` uses the CoffeeScript package to load the test modules automatically.
-
-## Debugging
-
-[Test-driven development](https://en.wikipedia.org/wiki/Test-driven_development)
-means roughly that write your tests *first*, then write the implementations,
-then keep running the tests till they work.
-
-`vows` doesn't necessarily do a fantastic job at this, but it's a little
-better, and it's definitely a goal. `vows` uses the
-[debug](https://www.npmjs.com/package/debug) library to spoot out debug info to
-stderr at run time. This can be very useful for looking at how the `vows`
-module is running, and figuring out where errors are happening.
-
-To use it, define the `DEBUG` environment variable when running your tests:
-
-```shell
-DEBUG=vows:* ./node_modules/.bin/vows mytest.js
-```
-
-Watch this space for more help in doing TDD with vows.
-
-## Compatibility
-
-This 1.x version is incompatible with previous 0.x versions of vows in a few
-small ways.
-
- - vows 0.x will check the
- [arity](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/length)
- of test methods and call the method different ways based on that arity. With
- vows 1.x, tests will always take an error argument and then zero or
- more result arguments. This should help preserve your sanity and make you
- write more robust tests.
-
- - vows 0.x will automatically pollute the namespace of the `assert` module.
- vows 1.x makes you use a property instead.
-
- - vows 0.x handle all teardowns at the same time, without waiting for
- sub-batch teardowns to finish. vows 1.x handles teardowns when the batch is
- finished, so you can do things like deleting created files in your sub-batch
- teardowns, and deleting their directory in your main batch teardown,
- and things will just work right.
-
-- vows 0.x treat a Promise returned from the topic just like any
- other results. So test functions will receive the Promise as a results
- argument. vows 1.x will resolve the Promise and pass the results to the
- test instead. So, if your tests expect to receive a Promise passed
- synchronously, you should change that.
-
-- vows 1.x does not pass `this.context` to the topic.
-
-- vows 1.x does not support many of the undocumented features of vows 0.x,
- including `vows.prepare()`, `beforeSuite()`, `afterSuite()`, and
- `vows.options`.
-
-- vows 1.x only provides a single, default reporter.
-
-- vows 1.x does not support command-line control of verbosity (`-v` or `-s`).
-
-- vows 1.x does not support the `-m` or `-r` command-line flags.
-
-- vows 0.x automatically runs any tests in the `test` or `spec` directory.
- vows 1.x requires that you specify the tests you want to run.
-
-- vows 1.x does not support the `-i` (isolate) command-line flag.
-
-## assert
-
-The exposed `assert` module-ish object has a number of useful methods for doing
-tests.
-
-The module exposes all the methods of the built-in
-[assert](https://nodejs.org/api/assert.html) module. It also has the following
-utility methods. Each will do a check and if the check fails, will throw a new
-`AssertionError` with either the `message` argument as its message, or a
-standard message for that macro.
-
-### assert.epsilon(eps, actual, expected, message)
-
-Checks that the number `actual` is within `eps` from `expected`.
-
-### assert.match(actual, expected, message)
-
-Checks that `actual` matches the regular expression `expected`. Note that
-`actual` will be coerced to a string if it is not one already.
-
-`assert.matches` is a synonym.
-
-### assert.isTrue(actual, message)
-
-Checks that `actual` is `true` (not just truthy; `true`).
-
-### assert.isFalse(actual, message)
-
-Checks that `actual` is `false` (not just falsy; `false`).
-
-### assert.isZero(actual, message)
-
-Checks that `actual` is 0.
-
-### assert.isNotZero(actual, message)
-
-Checks that `actual` is not 0.
-
-### assert.greater(actual, expected, message)
-
-Checks that `actual` is strictly greater than `expected`.
-
-### assert.lesser(actual, expected, message)
-
-Checks that `actual` is strictly lesser than `expected`.
-
-### assert.inDelta(actual, expected, delta, message)
-
-Checks that `actual` is less than `delta` away from `expected`. It's a lot
-like `assert.epsilon()`.
-
-### assert.include(actual, expected, message)
-
-Checks that `actual` contains `expected`. `assert.includes` is a synonym.
-
-### assert.notInclude(actual, expected, message)
-
-Checks that `actual` does not contain `expected`. `assert.notIncludes` is a
-synonym.
-
-### assert.isEmpty(actual, message)
-
-Checks that `actual` is empty (an empty array or an object with no properties).
-
-### assert.isNotEmpty(actual, message)
-
-Checks that `actual` is not empty.
-
-### assert.isArray(actual, message)
-
-Checks that `actual` is an array.
-
-### assert.isObject(actual, message)
-
-Checks that `actual` is an object.
-
-### assert.isNumber(actual, message)
-
-Checks that `actual` is a number.
-
-### assert.isBoolean(actual, message)
-
-Checks that `actual` is a boolean (`true` or `false`).
-
-### assert.isNaN(actual, message)
-
-Checks that `actual` is `NaN`.
-
-### assert.isNull(actual, message)
-
-Checks that `actual` is `null`.
-
-### assert.isNotNull(actual, message)
-
-Checks that `actual` is not `null`.
+ });
-### assert.isUndefined(actual, message)
+coverage reporting
+------------------
+Code coverage reporting is available if _instrumented_ code is detected. Currently only _instrumentation_ via [node-jscoverage](https://github.com/visionmedia/node-jscoverage) is supported. When _instrumented_ code is detected and coverage reporting is enabled using any of the `--cover-plain`, `--cover-html`, or `--cover-json` options a code coverage map is generated.
-Checks that `actual` is `undefined`.
+### downloading and installing [node-jscoverage](https://github.com/visionmedia/node-jscoverage)
+[node-jscoverage](https://github.com/visionmedia/node-jscoverage) is a binary package that needs to be compiled from source:
-### assert.isDefined(actual, message)
+ $ git clone https://github.com/visionmedia/node-jscoverage.git
+ $ cd node-jscoverage/
+ $ ./configure
+ checking for a BSD-compatible install... /usr/bin/install -c
+ checking whether build environment is sane... yes
+ [...]
+ $ make && sudo make install
-Checks that `actual` is not `undefined`.
+### instrumenting with jscoverage
-### assert.isString(actual, message)
+ $ jscoverage myfile.js myfile-instrumented.js
+
+installation
+------------
-Checks that `actual` is a string.
+ $ npm install vows
-### assert.isFunction(actual, message)
+documentation
+-------------
-Checks that `actual` is a function.
+Head over to
-### assert.typeOf(actual, expected, message)
+authors
+-------
-Checks that `actual` is of type `expected`.
+Alexis Sellier <>, Charlie Robbins,
-### assert.instanceOf(actual, expected, message)
+*...and many others*
-Checks that `actual` is an object and an instance of `expected`.
diff --git a/bin/vows b/bin/vows
new file mode 100755
index 00000000..1e701e2e
--- /dev/null
+++ b/bin/vows
@@ -0,0 +1,560 @@
+#!/usr/bin/env node
+
+var path = require('path'),
+ fs = require('fs'),
+ util = require('util'),
+ events = require('events');
+
+//
+// Attempt to load Coffee-Script. If it's not available, continue on our
+// merry way, if it is available, set it up so we can include `*.coffee`
+// scripts and start searching for them.
+//
+var fileExt, specFileExt;
+
+try {
+ var coffee = require('coffee-script');
+ if (require.extensions) {
+ require.extensions['.coffee'] = function (module, filename) {
+ var content = coffee.compile(fs.readFileSync(filename, 'utf8'));
+ return module._compile(content, filename);
+ };
+ } else {
+ require.registerExtension('.coffee', function (content) { return coffee.compile(content) });
+ }
+ fileExt = /\.(js|coffee)$/;
+ specFileExt = /[.(-|_)](test|spec)\.(js|coffee)$/;
+} catch (_) {
+ fileExt = /\.js$/;
+ specFileExt = /[.(-|_)](test|spec)\.js$/;
+}
+
+var inspect = require('eyes').inspector({
+ stream: null,
+ styles: { string: 'grey', regexp: 'grey' }
+});
+
+var vows = require('../lib/vows');
+var cutils = require('../lib/vows/console');
+var stylize = require('../lib/vows/console').stylize;
+var _reporter = require('../lib/vows/reporters/dot-matrix'), reporter = {
+ name: _reporter.name
+};
+var _coverage;
+
+var help = [
+ "usage: vows [FILE, ...] [options]",
+ "",
+ "options:",
+ " -v, --verbose Enable verbose output",
+ " -w, --watch Watch mode",
+ " -s, --silent Don't report",
+ " -i, --isolate Run each test in it's own vows process",
+ " -m PATTERN Only run tests matching the PATTERN string",
+ " -r PATTERN Only run tests matching the PATTERN regexp",
+ " --json Use JSON reporter",
+ " --spec Use Spec reporter",
+ " --dot-matrix Use Dot-Matrix reporter",
+ " --xunit Use xUnit reporter",
+ " --cover-plain Print plain coverage map if detected",
+ " --cover-html Write coverage map to \"coverage.html\"",
+ " --cover-json Write unified coverage map to \"coverage.json\"",
+ " --cover-xml Write coverage map to \"coverage.xml\" in Emma xml",
+ " --no-color Don't use terminal colors",
+ " --version Show version",
+ " -h, --help You're staring at it"
+].join('\n');
+
+var options = {
+ reporter: reporter,
+ matcher: /.*/,
+ watch: false,
+ coverage: false,
+ isolate: false,
+ nocolor: !process.stdout.isTTY
+};
+
+var files = [];
+
+// Get rid of process runner
+// ('node' in most cases)
+var arg, args = [], argv = process.argv.slice(2);
+
+// Current directory index,
+// and path of test folder.
+var root, testFolder;
+
+//
+// Parse command-line parameters
+//
+while (arg = argv.shift()) {
+ if (arg === __filename) { continue }
+
+ if (arg[0] !== '-') {
+ args.push(arg);
+ } else {
+ arg = arg.match(/^--?(.+)/)[1];
+
+ if (arg[0] === 'r') {
+ options.matcher = new(RegExp)(argv.shift());
+ } else if (arg[0] === 'm') {
+ options.matcher = (function (str) { // Create an escaped RegExp
+ var specials = '. * + ? | ( ) [ ] { } \\ ^ ? ! = : $'.split(' ').join('|\\'),
+ regex = new(RegExp)('(\\' + specials + ')', 'g');
+ return new(RegExp)(str.replace(regex, '\\$1'));
+ })(argv.shift());
+ } else if (arg in options) {
+ options[arg] = true;
+ } else {
+ switch (arg) {
+ case 'json':
+ _reporter = require('../lib/vows/reporters/json');
+ break;
+ case 'spec':
+ _reporter = require('../lib/vows/reporters/spec');
+ break;
+ case 'dot-matrix':
+ _reporter = require('../lib/vows/reporters/dot-matrix');
+ break;
+ case 'silent':
+ case 's':
+ _reporter = require('../lib/vows/reporters/silent');
+ break;
+ case 'xunit':
+ _reporter = require('../lib/vows/reporters/xunit');
+ break;
+ case 'cover-plain':
+ options.coverage = true;
+ _coverage = require('../lib/vows/coverage/report-plain');
+ break;
+ case 'cover-html':
+ options.coverage = true;
+ _coverage = require('../lib/vows/coverage/report-html');
+ break;
+ case 'cover-json':
+ options.coverage = true;
+ _coverage = require('../lib/vows/coverage/report-json');
+ break;
+ case 'cover-xml':
+ options.coverage = true;
+ _coverage = require('../lib/vows/coverage/report-xml');
+ break;
+ case 'verbose':
+ case 'v':
+ options.verbose = true;
+ break;
+ case 'watch':
+ case 'w':
+ options.watch = true;
+ break;
+ case 'supress-stdout':
+ options.supressStdout = true;
+ break;
+ case 'isolate':
+ case 'i':
+ options.isolate = true;
+ break;
+ case 'no-color':
+ options.nocolor = true;
+ break;
+ case 'color':
+ options.nocolor = false;
+ break;
+ case 'no-error':
+ options.error = false;
+ break;
+ case 'version':
+ console.log('vows ' + vows.version);
+ process.exit(0);
+ case 'help':
+ case 'h':
+ console.log(help);
+ process.exit(0);
+ break;
+ }
+ }
+ }
+}
+
+if (options.nocolor) {
+ cutils.nocolor = true;
+ inspect = require('eyes').inspector({ stream: null, styles: false });
+}
+
+if (options.supressStdout) {
+ _reporter.setStream && _reporter.setStream(process.stdout);
+ var devNullStream = fs.createWriteStream('/dev/null');
+ process.__defineGetter__('stdout', function () {
+ return devNullStream;
+ });
+}
+
+if (options.watch) {
+ options.reporter = reporter = require('../lib/vows/reporters/watch');
+}
+
+msg('bin', 'argv', args);
+msg('bin', 'options', { reporter: options.reporter.name, matcher: options.matcher });
+
+if (args.length === 0 || options.watch) {
+ msg('bin', 'discovering', 'folder structure');
+ root = fs.readdirSync('.');
+
+ if (root.indexOf('test') !== -1) {
+ testFolder = 'test';
+ } else if (root.indexOf('spec') !== -1) {
+ testFolder = 'spec';
+ } else {
+ abort("runner", "couldn't find test folder");
+ }
+ msg('bin', 'discovered', "./" + testFolder);
+ if (args.length === 0) {
+ args = paths(testFolder).filter(function (f) {
+ return specFileExt.test(f);
+ });
+
+ if (options.watch) {
+ args = args.concat(paths('lib'), paths('src'));
+ }
+ }
+}
+
+if (! options.watch) {
+ reporter.report = function (data, filename) {
+ switch (data[0]) {
+ case 'subject':
+ case 'vow':
+ case 'context':
+ case 'error':
+ _reporter.report(data, filename);
+ break;
+ case 'end':
+ (options.verbose || _reporter.name === 'json') &&
+ _reporter.report(data);
+ break;
+ case 'finish':
+ options.verbose ?
+ _reporter.print('\n')
+ :
+ _reporter.print(' ');
+ break;
+ }
+ };
+ reporter.reset = function () { _reporter.reset && _reporter.reset() };
+ reporter.print = _reporter.print;
+
+ files = args.map(function (a) {
+ return (!a.match(/^\//))
+ ? path.join(process.cwd(), a.replace(fileExt, ''))
+ : a.replace(fileExt, '');
+ });
+
+ runSuites(importSuites(files), function (results) {
+ var status = results.errored ? 2 : (results.broken ? 1 : 0);
+
+ !options.verbose && _reporter.print('\n');
+ msg('runner', 'finish');
+ _reporter.report(['finish', results], {
+ write: function (str) {
+ util.print(str.replace(/^\n\n/, '\n'));
+ }
+ });
+ try {
+ if (options.coverage === true && _$jscoverage !== undefined) {
+ _coverage.report(_$jscoverage);
+ }
+ } catch (err) {
+ // ignore the undefined jscoverage
+ }
+ if (process.stdout.write('')) { // Check if stdout is drained
+ process.exit(status);
+ } else {
+ process.stdout.on('drain', function () {
+ process.exit(status);
+ });
+ }
+ });
+} else {
+ //
+ // Watch mode
+ //
+ (function () {
+ var pendulum = [
+ '. ', '.. ', '... ', ' ...',
+ ' ..', ' .', ' .', ' ..',
+ '... ', '.. ', '. '
+ ];
+ var strobe = ['.', ' '];
+ var status,
+ cue,
+ current = 0,
+ running = 0,
+ lastRun,
+ colors = ['32m', '33m', '31m'],
+ timer = setInterval(tick, 100);
+ process.on('uncaughtException', exception);
+ process.on('exit', cleanup);
+ process.on('SIGINT', function () {
+ process.exit(0);
+ });
+ process.on('SIGQUIT', function () {
+ changed();
+ });
+
+ cursorHide();
+
+ // Run every 100ms
+ function tick() {
+ if (running && (cue !== strobe)) {
+ cue = strobe, current = 0;
+ } else if (!running && (cue !== pendulum)) {
+ cue = pendulum, current = 0;
+ }
+
+ eraseLine();
+ lastRun && !running && esc(colors[status.errored ? 2 : (status.broken ? 1 : 0)]);
+ print(cue[current]);
+
+ if (current == cue.length - 1) { current = -1 }
+
+ current ++;
+ esc('39m');
+ cursorRestore();
+ }
+
+ //
+ // Utility functions
+ //
+ function print(str) { util.print(str) }
+ function esc(str) { print("\x1b[" + str) }
+ function eraseLine() { esc("0K") }
+ function cursorRestore() { esc("0G") }
+ function cursorHide() { esc("?25l") }
+ function cursorShow() { esc("?25h") }
+ function cleanup() { eraseLine(), cursorShow(), clearInterval(timer), print('\n') }
+ function exception(err) { print(err.stack || err.message || JSON.stringify(err)), running = 0}
+
+ //
+ // Get a matching test for a given file
+ //
+ function getMatchingTest(file, join) {
+ join || (join = '-');
+ var testFile;
+ if (specFileExt.test(file)) {
+ testFile = path.join(testFolder, file);
+ }
+ else {
+ var root, extension;
+ _s = file.split('.'), root = _s[0], extension = _s[1];
+ testFile = path.join(testFolder, root + join + testFolder + "." + extension);
+ }
+
+ try {
+ fs.statSync(testFile);
+ } catch (e) {
+ if (join == '-') {
+ return getMatchingTest(file, '_');
+ }
+ else {
+ msg('watcher', 'no equivalence found, running all tests.');
+ testFile = null;
+ }
+ }
+ return testFile;
+ }
+
+ //
+ // Called when a file has been modified.
+ // Run the matching tests and change the status.
+ //
+ function changed(file) {
+ status = { honored: 0, broken: 0, errored: 0, pending: 0 };
+
+ msg('watcher', 'detected change in', file);
+
+ file = getMatchingTest(file);
+
+ var files = (specFileExt.test(file) ? [file] : paths(testFolder)).map(function (p) {
+ return path.join(process.cwd(), p);
+ }).filter(function (p) {
+ return specFileExt.test(p);
+ }).map(function (p) {
+ var cache = require.main.moduleCache || require.cache;
+ if (cache[p]) { delete(cache[p]) }
+ return p;
+ }).map(function (p) {
+ return p.replace(fileExt, '');
+ });
+
+ running ++;
+
+ runSuites(importSuites(files), function (results) {
+ delete(results.time);
+ print(cutils.result(results).join('') + '\n\n');
+ lastRun = new(Date);
+ status = results;
+ running --;
+ });
+ }
+
+ msg('watcher', 'watching', args);
+
+ //
+ // Watch all relevant files,
+ // and call `changed()` on change.
+ //
+ args.forEach(function (p) {
+ fs.watchFile(p, function (current, previous) {
+ if (new(Date)(current.mtime).valueOf() ===
+ new(Date)(previous.mtime).valueOf()) { return }
+ else {
+ changed(p);
+ }
+ });
+ });
+ })();
+}
+
+function runSuites(suites, callback) {
+ var results = {
+ honored: 0,
+ broken: 0,
+ errored: 0,
+ pending: 0,
+ total: 0,
+ time: 0
+ };
+ reporter.reset();
+
+ (function run(suites, callback) {
+ var suite = suites.shift();
+ if (suite) {
+ msg('runner', "running", suite.subject + ' ', options.watch ? false : true);
+ suite.run(options, function (result) {
+ Object.keys(result).forEach(function (k) {
+ results[k] += result[k];
+ });
+ run(suites, callback);
+ });
+ } else {
+ callback(results);
+ }
+ })(suites, callback);
+}
+
+function importSuites(files) {
+ msg(options.watcher ? 'watcher' : 'runner', 'loading', files);
+
+ var spawn = require('child_process').spawn;
+
+ function cwdname(f) {
+ return f.replace(process.cwd() + '/', '') + '.js';
+ }
+
+ function wrapSpawn(f) {
+ f = cwdname(f);
+ return function (options, callback) {
+ var args = [process.argv[1], '--json', '--supress-stdout', f],
+ p = spawn(process.argv[0], args),
+ result;
+
+ p.on('exit', function (code) {
+ callback(
+ !result ?
+ {errored: 1, total: 1}
+ :
+ result
+ );
+ });
+
+ var buffer = [];
+ p.stdout.on('data', function (data) {
+ data = data.toString().split(/\n/g);
+ if (data.length == 1) {
+ buffer.push(data[0]);
+ } else {
+ data[0] = buffer.concat(data[0]).join('');
+ buffer = [data.pop()];
+
+ data.forEach(function (data) {
+ if (data) {
+ data = JSON.parse(data);
+ if (data && data[0] === 'finish') {
+ result = data[1];
+ } else {
+ reporter.report(data);
+ }
+ }
+ });
+ }
+ });
+
+ p.stderr.pipe(process.stderr);
+ }
+ }
+
+ return files.reduce(options.isolate ? function (suites, f) {
+ return suites.concat({
+ run: wrapSpawn(f)
+ });
+ } : function (suites, f) {
+ var obj = require(f);
+ return suites.concat(Object.keys(obj).map(function (s) {
+ obj[s]._filename = cwdname(f);
+ return obj[s];
+ }));
+ }, [])
+}
+
+//
+// Recursively traverse a hierarchy, returning
+// a list of all relevant .js files.
+//
+function paths(dir) {
+ var paths = [];
+
+ try { fs.statSync(dir) }
+ catch (e) { return [] }
+
+ (function traverse(dir, stack) {
+ stack.push(dir);
+ fs.readdirSync(stack.join('/')).forEach(function (file) {
+ //
+ // Skip dotfiles and `vendor` directory before `fs.stat()`ing them.
+ // Not doing so causes race conditions with Emacs buffer files
+ // (`.#filename.js`).
+ //
+ if (file[0] == '.' || file === 'vendor') {
+ return;
+ }
+
+ var path = stack.concat([file]).join('/'),
+ stat = fs.statSync(path);
+
+ if (stat.isFile() && fileExt.test(file)) {
+ paths.push(path);
+ } else if (stat.isDirectory()) {
+ traverse(file, stack);
+ }
+ });
+ stack.pop();
+ })(dir || '.', []);
+
+ return paths;
+}
+
+function msg(cmd, subject, str, p) {
+ if (options.verbose) {
+ util[p ? 'print' : 'puts']( stylize('vows ', 'green')
+ + stylize(cmd, 'bold')
+ + ' ' + subject + ' '
+ + (str ? (typeof(str) === 'string' ? str : inspect(str)) : '')
+ );
+ }
+}
+
+function abort(cmd, str) {
+ console.log(stylize('vows ', 'red') + stylize(cmd, 'bold') + ' ' + str);
+ console.log(stylize('vows ', 'red') + stylize(cmd, 'bold') + ' exiting');
+ process.exit(-1);
+}
diff --git a/bin/vows.js b/bin/vows.js
deleted file mode 100644
index 69d949f2..00000000
--- a/bin/vows.js
+++ /dev/null
@@ -1,83 +0,0 @@
-#!/usr/bin/env node
-
-// vows.js -- command-line driver for vows test scripts
-//
-// Copyright 2016 fuzzy.ai
-//
-// Licensed under the Apache License, Version 2.0 (the "License")
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-/* jshint esversion: 6 */
-
-'use strict'
-
-const path = require('path')
-
-const _ = require('lodash')
-const async = require('async')
-const debug = require('debug')('vows:command-line')
-
-// This registers a hook so that coffeescript modules can be loaded
-
-require('coffeescript/register')
-
-const argv = require('yargs')
- .help('h')
- .argv
-
-const cwd = process.cwd()
-
-let broken = 0
-let successes = 0
-let failures = 0
-
-const runTestSuite = (testFileName, callback) => {
- const testPath = path.join(cwd, testFileName)
- const runner = require(testPath)
- if (!_.isFunction(runner)) {
- callback(new Error(`Path ${testFileName} does not return a function`))
- } else {
- runner((err, suiteBroken, suiteSuccesses, suiteFailures) => {
- if (err) {
- callback(err)
- } else if (!_.isNumber(suiteBroken)) {
- callback(new Error(`suiteBroken for ${testFileName} should be a number, is ${suiteBroken}`))
- } else if (!_.isNumber(suiteSuccesses)) {
- callback(new Error(`suiteSuccesses for ${testFileName} should be a number, is ${suiteSuccesses}`))
- } else if (!_.isNumber(suiteFailures)) {
- callback(new Error(`suiteFailures for ${testFileName} should be a number, is ${suiteFailures}`))
- } else {
- debug(`Finished suite ${testFileName}: ${suiteBroken}, ${suiteSuccesses}, ${suiteFailures}`)
- broken += suiteBroken
- successes += suiteSuccesses
- failures += suiteFailures
- callback(null)
- }
- })
- }
-}
-
-async.eachSeries(argv._, runTestSuite, (err) => {
- if (err) {
- console.error(err)
- } else {
- console.log('SUMMARY')
- console.log(`\tBroken:\t\t${broken}`)
- console.log(`\tSuccesses:\t${successes}`)
- console.log(`\tFailures:\t${failures}`)
- if (broken > 0 || failures > 0) {
- process.exit(1)
- } else {
- process.exit(0)
- }
- }
-})
diff --git a/lib/assert.js b/lib/assert.js
deleted file mode 100644
index bce18ddc..00000000
--- a/lib/assert.js
+++ /dev/null
@@ -1,150 +0,0 @@
-// assert.js -- extended asserts
-//
-// Copyright 2016 fuzzy.ai
-//
-// Licensed under the Apache License, Version 2.0 (the "License")
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-/* jshint esversion: 6 */
-
-'use strict'
-
-const assert = require('assert')
-const debug = require('debug')('vows:assert')
-const _ = require('lodash')
-
-// This can't be an arrow function because of some weird stuff with `this`.
-// If it is, then plain `assert()` doesn't work and you have to `assert.ok()`
-const me = function () {
- debug(arguments)
- assert.apply(this, arguments)
-}
-
-module.exports = me
-
-// Copy everything from assert module to this module
-
-_.assign(me, assert)
-
-// Extend this module with some extra utilities
-
-me.epsilon = function (eps, actual, expected, message) {
- me.isNumber(eps)
- me.isNumber(actual)
- me.isNumber(expected)
- return me.lesser(Math.abs(actual - expected), eps)
-}
-
-me.match = function (actual, expected, message) {
- assert(_.isRegExp(expected), `${expected} must be a regular expression`)
- return assert(expected.test(actual),
- message || `${actual} does not match ${expected}`)
-}
-
-me.matches = me.match
-
-me.isTrue = (actual, message) =>
- assert(actual === true, message || 'Argument must be true')
-
-me.isFalse = (actual, message) =>
- assert(actual === false, message || 'Argument must be false')
-
-me.isZero = (actual, message) =>
- assert.equal(actual, 0, message || 'Argument must be zero')
-
-me.isNotZero = (actual, message) =>
- assert.notEqual(actual, 0, message || 'Argument must not be zero')
-
-me.greater = (actual, expected, message) =>
- assert(actual > expected,
- message || `${actual} is not greater than ${expected}`)
-
-me.lesser = (actual, expected, message) =>
- assert(actual < expected,
- message || `${actual} is not less than ${expected}`)
-
-me.inDelta = (actual, expected, delta, message) =>
- assert(Math.abs(actual - expected) <= delta,
- message || `${actual} is not greater than ${expected}`)
-
-me.include = (actual, expected, message) =>
- assert(_.hasIn(actual, expected),
- message || `${actual} does not contain ${expected}`)
-
-me.includes = me.include
-
-me.notInclude = (actual, expected, message) =>
- assert(!_.hasIn(actual, expected),
- message || `${actual} contains ${expected}`)
-
-me.notIncludes = me.notInclude
-
-// FIXME: figure out include/deepInclude
-
-me.deepInclude = me.include
-
-me.deepIncludes = me.deepInclude
-
-me.isEmpty = (actual, message) =>
- assert(_.isEmpty(actual), message || `${actual} is not empty`)
-
-me.isNotEmpty = (actual, message) =>
- assert(!_.isEmpty(actual), message || `${actual} is empty`)
-
-me.lengthOf = function (actual, expected, message) {
- assert(actual !== null)
- me.include(actual, 'length')
- return assert.equal(actual.length, expected,
- `Length is ${actual.length} not ${expected}`)
-}
-
-me.isArray = (actual, message) =>
- assert(_.isArray(actual), message || 'Argument is not an array')
-
-me.isObject = (actual, message) =>
- assert(_.isObject(actual), message || 'Argument must be an object')
-
-me.isNumber = (actual, message) =>
- assert(_.isNumber(actual), message || 'Argument must be a number')
-
-me.isBoolean = (actual, message) =>
- assert(_.isBoolean(actual), message || 'Argument must be a boolean')
-
-me.isNaN = (actual, message) =>
- assert(_.isNaN(actual), message || 'Argument must be NaN')
-
-me.isNull = (actual, message) =>
- assert(_.isNull(actual), message || 'Argument must be null')
-
-me.isNotNull = (actual, message) =>
- assert(!_.isNull(actual), message || 'Argument must not be null')
-
-me.isUndefined = (actual, message) =>
- assert(_.isUndefined(actual), message || 'Argument must be undefined')
-
-me.isDefined = (actual, message) =>
- assert(!_.isUndefined(actual), message || 'Argument must be defined')
-
-me.isString = (actual, message) =>
- assert(_.isString(actual), message || 'Argument must be a string')
-
-me.isFunction = (actual, message) =>
- assert(_.isFunction(actual), message || 'Argument must be a function')
-
-me.typeOf = (actual, expected, message) =>
- // eslint-disable-next-line valid-typeof
- assert(typeof (actual) === expected,
- message || `Argument is not of type ${expected}`)
-
-me.instanceOf = (actual, expected, message) =>
- assert(actual instanceof expected,
- message || `Argument is not an instance of ${expected}`)
diff --git a/lib/assert/error.js b/lib/assert/error.js
new file mode 100644
index 00000000..3f52271d
--- /dev/null
+++ b/lib/assert/error.js
@@ -0,0 +1,42 @@
+var stylize = require('../vows/console').stylize;
+var inspect = require('../vows/console').inspect;
+
+require('assert').AssertionError.prototype.toString = function () {
+ var that = this,
+ source;
+
+ if (this.stack) {
+ source = this.stack.match(/([a-zA-Z0-9._-]+\.(?:js|coffee))(:\d+):\d+/);
+ }
+
+ function parse(str) {
+ var actual = inspect(that.actual, {showHidden: that.actual instanceof Error}),
+ expected;
+
+ if (that.expected instanceof Function) {
+ expected = that.expected.name;
+ }
+ else {
+ expected = inspect(that.expected, {showHidden: that.actual instanceof Error});
+ }
+
+ return str.replace(/{actual}/g, actual).
+ replace(/{operator}/g, stylize(that.operator, 'bold')).
+ replace(/{expected}/g, expected);
+ }
+
+ if (this.message) {
+ var msg = stylize(parse(this.message), 'yellow');
+ if (source) {
+ msg += stylize(' // ' + source[1] + source[2], 'grey');
+ }
+ return msg;
+ } else {
+ return stylize([
+ this.expected,
+ this.operator,
+ this.actual
+ ].join(' '), 'yellow');
+ }
+};
+
diff --git a/lib/assert/macros.js b/lib/assert/macros.js
new file mode 100644
index 00000000..154aa143
--- /dev/null
+++ b/lib/assert/macros.js
@@ -0,0 +1,215 @@
+var assert = require('assert'),
+ utils = require('./utils');
+
+var messages = {
+ 'equal' : "expected {expected},\n\tgot\t {actual} ({operator})",
+ 'notEqual' : "didn't expect {actual} ({operator})"
+};
+messages['strictEqual'] = messages['deepEqual'] = messages['equal'];
+messages['notStrictEqual'] = messages['notDeepEqual'] = messages['notEqual'];
+
+for (var key in messages) {
+ assert[key] = (function (key, callback) {
+ return function (actual, expected, message) {
+ callback(actual, expected, message || messages[key]);
+ };
+ })(key, assert[key]);
+}
+
+assert.ok = (function (callback) {
+ return function (actual, message) {
+ callback(actual, message || "expected expression to evaluate to {expected}, but was {actual}");
+ };
+})(assert.ok);
+
+assert.match = function (actual, expected, message) {
+ if (! expected.test(actual)) {
+ assert.fail(actual, expected, message || "expected {actual} to match {expected}", "match", assert.match);
+ }
+};
+assert.matches = assert.match;
+
+assert.isTrue = function (actual, message) {
+ if (actual !== true) {
+ assert.fail(actual, true, message || "expected {expected}, got {actual}", "===", assert.isTrue);
+ }
+};
+assert.isFalse = function (actual, message) {
+ if (actual !== false) {
+ assert.fail(actual, false, message || "expected {expected}, got {actual}", "===", assert.isFalse);
+ }
+};
+assert.isZero = function (actual, message) {
+ if (actual !== 0) {
+ assert.fail(actual, 0, message || "expected {expected}, got {actual}", "===", assert.isZero);
+ }
+};
+assert.isNotZero = function (actual, message) {
+ if (actual === 0) {
+ assert.fail(actual, 0, message || "expected non-zero value, got {actual}", "===", assert.isNotZero);
+ }
+};
+
+assert.greater = function (actual, expected, message) {
+ if (actual <= expected) {
+ assert.fail(actual, expected, message || "expected {actual} to be greater than {expected}", ">", assert.greater);
+ }
+};
+assert.lesser = function (actual, expected, message) {
+ if (actual >= expected) {
+ assert.fail(actual, expected, message || "expected {actual} to be lesser than {expected}", "<", assert.lesser);
+ }
+};
+
+assert.inDelta = function (actual, expected, delta, message) {
+ var lower = expected - delta;
+ var upper = expected + delta;
+ if (actual < lower || actual > upper) {
+ assert.fail(actual, expected, message || "expected {actual} to be in within *" + delta.toString() + "* of {expected}", null, assert.inDelta);
+ }
+};
+
+//
+// Inclusion
+//
+assert.include = function (actual, expected, message) {
+ if ((function (obj) {
+ if (isArray(obj) || isString(obj)) {
+ return obj.indexOf(expected) === -1;
+ } else if (isObject(actual)) {
+ return ! obj.hasOwnProperty(expected);
+ }
+ return true;
+ })(actual)) {
+ assert.fail(actual, expected, message || "expected {actual} to include {expected}", "include", assert.include);
+ }
+};
+assert.includes = assert.include;
+
+assert.deepInclude = function (actual, expected, message) {
+ if (!isArray(actual)) {
+ return assert.include(actual, expected, message);
+ }
+ if (!actual.some(function (item) { return utils.deepEqual(item, expected) })) {
+ assert.fail(actual, expected, message || "expected {actual} to include {expected}", "include", assert.deepInclude);
+ }
+};
+assert.deepIncludes = assert.deepInclude;
+
+//
+// Length
+//
+assert.isEmpty = function (actual, message) {
+ if ((isObject(actual) && Object.keys(actual).length > 0) || actual.length > 0) {
+ assert.fail(actual, 0, message || "expected {actual} to be empty", "length", assert.isEmpty);
+ }
+};
+assert.isNotEmpty = function (actual, message) {
+ if ((isObject(actual) && Object.keys(actual).length === 0) || actual.length === 0) {
+ assert.fail(actual, 0, message || "expected {actual} to be not empty", "length", assert.isNotEmpty);
+ }
+};
+
+assert.lengthOf = function (actual, expected, message) {
+ if (actual.length !== expected) {
+ assert.fail(actual, expected, message || "expected {actual} to have {expected} element(s)", "length", assert.length);
+ }
+};
+
+//
+// Type
+//
+assert.isArray = function (actual, message) {
+ assertTypeOf(actual, 'array', message || "expected {actual} to be an Array", assert.isArray);
+};
+assert.isObject = function (actual, message) {
+ assertTypeOf(actual, 'object', message || "expected {actual} to be an Object", assert.isObject);
+};
+assert.isNumber = function (actual, message) {
+ if (isNaN(actual)) {
+ assert.fail(actual, 'number', message || "expected {actual} to be of type {expected}", "isNaN", assert.isNumber);
+ } else {
+ assertTypeOf(actual, 'number', message || "expected {actual} to be a Number", assert.isNumber);
+ }
+};
+assert.isBoolean = function (actual, message) {
+ if (actual !== true && actual !== false) {
+ assert.fail(actual, 'boolean', message || "expected {actual} to be a Boolean", "===", assert.isBoolean);
+ }
+};
+assert.isNaN = function (actual, message) {
+ if (actual === actual) {
+ assert.fail(actual, 'NaN', message || "expected {actual} to be NaN", "===", assert.isNaN);
+ }
+};
+assert.isNull = function (actual, message) {
+ if (actual !== null) {
+ assert.fail(actual, null, message || "expected {expected}, got {actual}", "===", assert.isNull);
+ }
+};
+assert.isNotNull = function (actual, message) {
+ if (actual === null) {
+ assert.fail(actual, null, message || "expected non-null value, got {actual}", "===", assert.isNotNull);
+ }
+};
+assert.isUndefined = function (actual, message) {
+ if (actual !== undefined) {
+ assert.fail(actual, undefined, message || "expected {actual} to be {expected}", "===", assert.isUndefined);
+ }
+};
+assert.isDefined = function (actual, message) {
+ if(actual === undefined) {
+ assert.fail(actual, 0, message || "expected {actual} to be defined", "===", assert.isDefined);
+ }
+};
+assert.isString = function (actual, message) {
+ assertTypeOf(actual, 'string', message || "expected {actual} to be a String", assert.isString);
+};
+assert.isFunction = function (actual, message) {
+ assertTypeOf(actual, 'function', message || "expected {actual} to be a Function", assert.isFunction);
+};
+assert.typeOf = function (actual, expected, message) {
+ assertTypeOf(actual, expected, message, assert.typeOf);
+};
+assert.instanceOf = function (actual, expected, message) {
+ if (! (actual instanceof expected)) {
+ assert.fail(actual, expected, message || "expected {actual} to be an instance of {expected}", "instanceof", assert.instanceOf);
+ }
+};
+
+//
+// Utility functions
+//
+
+function assertTypeOf(actual, expected, message, caller) {
+ if (typeOf(actual) !== expected) {
+ assert.fail(actual, expected, message || "expected {actual} to be of type {expected}", "typeOf", caller);
+ }
+};
+
+function isArray (obj) {
+ return Array.isArray(obj);
+}
+
+function isString (obj) {
+ return typeof(obj) === 'string' || obj instanceof String;
+}
+
+function isObject (obj) {
+ return typeof(obj) === 'object' && obj && !isArray(obj);
+}
+
+// A better `typeof`
+function typeOf(value) {
+ var s = typeof(value),
+ types = [Object, Array, String, RegExp, Number, Function, Boolean, Date];
+
+ if (s === 'object' || s === 'function') {
+ if (value) {
+ types.forEach(function (t) {
+ if (value instanceof t) { s = t.name.toLowerCase() }
+ });
+ } else { s = 'null' }
+ }
+ return s;
+}
diff --git a/lib/assert/utils.js b/lib/assert/utils.js
new file mode 100644
index 00000000..dccd0f65
--- /dev/null
+++ b/lib/assert/utils.js
@@ -0,0 +1,77 @@
+
+// Taken from node/lib/assert.js
+exports.deepEqual = function (actual, expected) {
+ if (actual === expected) {
+ return true;
+
+ } else if (Buffer.isBuffer(actual) && Buffer.isBuffer(expected)) {
+ if (actual.length != expected.length) return false;
+
+ for (var i = 0; i < actual.length; i++) {
+ if (actual[i] !== expected[i]) return false;
+ }
+ return true;
+
+ } else if (actual instanceof Date && expected instanceof Date) {
+ return actual.getTime() === expected.getTime();
+
+ } else if (typeof actual != 'object' && typeof expected != 'object') {
+ return actual == expected;
+
+ } else {
+ return objEquiv(actual, expected);
+ }
+}
+
+// Taken from node/lib/assert.js
+exports.notDeepEqual = function (actual, expected, message) {
+ if (exports.deepEqual(actual, expected)) {
+ fail(actual, expected, message, 'notDeepEqual', assert.notDeepEqual);
+ }
+}
+
+// Taken from node/lib/assert.js
+function isUndefinedOrNull(value) {
+ return value === null || value === undefined;
+}
+
+// Taken from node/lib/assert.js
+function isArguments(object) {
+ return Object.prototype.toString.call(object) == '[object Arguments]';
+}
+
+// Taken from node/lib/assert.js
+function objEquiv(a, b) {
+ if (isUndefinedOrNull(a) || isUndefinedOrNull(b))
+ return false;
+ if (a.prototype !== b.prototype) return false;
+ if (isArguments(a)) {
+ if (!isArguments(b)) {
+ return false;
+ }
+ a = pSlice.call(a);
+ b = pSlice.call(b);
+ return exports.deepEqual(a, b);
+ }
+ try {
+ var ka = Object.keys(a),
+ kb = Object.keys(b),
+ key, i;
+ } catch (e) {
+ return false;
+ }
+ if (ka.length != kb.length)
+ return false;
+ ka.sort();
+ kb.sort();
+ for (i = ka.length - 1; i >= 0; i--) {
+ if (ka[i] != kb[i])
+ return false;
+ }
+ for (i = ka.length - 1; i >= 0; i--) {
+ key = ka[i];
+ if (!exports.deepEqual(a[key], b[key])) return false;
+ }
+ return true;
+}
+
diff --git a/lib/at-most-once.js b/lib/at-most-once.js
deleted file mode 100644
index e6f98be5..00000000
--- a/lib/at-most-once.js
+++ /dev/null
@@ -1,55 +0,0 @@
-// at-most-once.js -- run a function at most once
-//
-// Copyright 2016 fuzzy.ai
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-/* jshint esversion: 6 */
-
-'use strict'
-
-const debug = require('debug')('vows:at-most-once')
-
-const assert = require('./assert')
-
-class AtMostOnceError extends Error {
- constructor (name, called) {
- const message = `${name} wrapper called ${called} times!`
- super(message)
- this.message = message
- this.functionName = name
- this.called = called
- this.name = 'AtMostOnceError'
- }
-}
-
-const atMostOnce = function (fn) {
- let called = 0
- assert.isFunction(fn)
- const name = (fn.name) ? `${fn.name}()` : ''
- debug(`Creating atMostOnce() wrapper for ${name}`)
- const wrapper = function () {
- const args = Array.prototype.slice.call(arguments)
- called += 1
- if (called === 1) {
- debug(`First call of atMostOnce() wrapper of ${name}`)
- return fn.apply(null, args)
- } else {
- debug(`call number ${called} of atMostOnce() wrapper of ${name}`)
- throw new AtMostOnceError(name, called)
- }
- }
- return wrapper
-}
-
-module.exports = atMostOnce
diff --git a/lib/batch.js b/lib/batch.js
deleted file mode 100644
index 9816ac28..00000000
--- a/lib/batch.js
+++ /dev/null
@@ -1,339 +0,0 @@
-// batch.js -- A batch of tests for vows
-//
-// Copyright 2016 fuzzy.ai
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-/* jshint esversion: 6 */
-
-'use strict'
-
-const _ = require('lodash')
-const async = require('async')
-const debug = require('debug')('vows:batch')
-
-const assert = require('./assert')
-const atMostOnce = require('./at-most-once')
-const Report = require('./report')
-
-class Batch {
- constructor (title, definition) {
- this.title = title
- assert.isString(this.title, 'Batch title must be a string')
- assert.isObject(definition, 'Batch definition must be an object')
-
- debug(`Batch constructor with title '${this.title}'`)
- debug(`Definition for '${this.title}' has ${_.keys(definition).length} keys`)
-
- this.topic = null
- this.teardown = null
- this.tests = {}
- this.batches = {}
-
- for (const name in definition) {
- const value = definition[name]
- assert.isString(name,
- `keys of definition must be strings, not '${name}'`)
-
- if (name === 'topic') {
- assert.ok(!_.isNil(value), 'topic must be defined and not null')
- debug(`Adding topic to '${this.title}'`)
- if (_.isFunction(value)) {
- this.topic = value
- } else {
- this.topic = () => {
- return value
- }
- }
- } else if (name === 'teardown') {
- debug(`Adding teardown to '${this.title}'`)
- assert.isFunction(value,
- `'teardown' of '${this.title}' must be a function`)
- this.teardown = value
- } else if (_.isFunction(value)) {
- debug(`Adding test '${name}' to '${this.title}'`)
- this.tests[name] = value
- } else if (_.isObject(value)) {
- debug(`Adding batch '${name}' to '${this.title}'`)
- this.batches[name] = new Batch(`${this.title} ${name}`, value)
- } else {
- throw new Error(`Unexpected value '${value}' for key '${name}'`)
- }
- }
-
- assert.isFunction(this.topic, `Batch '${this.title}' has no topic`)
-
- assert(_.size(this.tests) > 0 || _.size(this.batches) > 0,
- `Batch '${this.title}' has no sub-batches or tests`)
-
- debug(`Batch '${this.title}' has ${_.size(this.tests)} tests`)
- debug(`Batch '${this.title}' has ${_.size(this.batches)} batches`)
-
- if (this.teardown !== null) {
- debug(`Batch '${this.title}' has a teardown`)
- } else {
- debug(`Batch '${this.title}' has no teardown`)
- }
- }
-
- run (args, callback) {
- assert.isArray(args, 'Args to Batch::run() must be an array')
- assert.isFunction(callback, 'Callback for Batch::run() must be function')
-
- debug(`Beginning run of batch '${this.title}'`)
-
- this.report = new Report(this.title)
-
- debug('Creating callback')
-
- const next = this.onTopicComplete(args, callback)
-
- let results = null
-
- // It's weird to call this.callback() synchronously, but we
- // allow it. If it's called while the topic is running,
- // we just call setImmediate() to do it "later".
-
- let sync = null
- const title = this.title
-
- const thisCallback = function () {
- const args = Array.prototype.slice.call(arguments)
- if (sync) {
- debug(`this.callback called synchronously from topic '${title}'`)
- setImmediate(() => {
- debug(`this.callback of topic '${title}' activated after setImmediate()`)
- next.apply(null, args)
- })
- } else {
- debug(`this.callback called asynchronously from topic '${title}'`)
- next.apply(null, args)
- }
- }
-
- debug(`Beginning topic of batch '${this.title}'`)
-
- try {
- sync = true
- results = this.topic.apply({ callback: thisCallback }, args)
- sync = false
- } catch (err) {
- sync = false
- debug(`Error running topic of batch '${this.title}'`)
- return next(err)
- }
-
- debug(`Completed topic of batch '${this.title}'`)
-
- if (_.isUndefined(results)) {
- debug(`Results of topic of batch '${this.title}' undefined; running async`)
- } else if (!_.isUndefined(Promise) && (results instanceof Promise)) {
- debug(`Results of topic of batch '${this.title}' defined and is a Promise; resolving`)
- results
- .then(function () {
- debug(arguments.length)
- const args = Array.prototype.slice.call(arguments)
- debug(`Resolved Promise returned by topic with ${args.length} arguments`)
- debug(args)
- // We pass along a null in zero position for the error value
- next.apply(null, _.concat([null], args))
- })
- .catch((err) => {
- next(err)
- })
- } else {
- debug(`Results of topic of batch '${this.title}' defined and not a Promise; running sync`)
- next(null, results)
- }
-
- return undefined
- }
-
- onTopicComplete (args, callback) {
- return atMostOnce(function () {
- const calledWith = Array.prototype.slice.call(arguments)
- const err = calledWith[0]
- const results = calledWith.slice(1)
-
- debug(`Results for topic of '${this.title}': ${err}, ${results.join(', ')}`)
-
- this.runTests(err, results)
- this.report.successes = _.keys(this.tests).length - this.report.failures
-
- assert.ok(_.isFinite(this.report.failures), `failures must be a finite number, not ${this.report.failures}`)
- assert.ok(_.isFinite(this.report.successes), `successes must be a finite number, not ${this.report.successes}`)
- assert.equal(this.report.successes + this.report.failures, _.keys(this.tests).length, 'failures + successes != number of tests')
-
- if (err) {
- this.report.broken = 1
- debug(`Error ${err} from topic; skipping batches for '${this.title}'`)
- this.runTeardown(results, callback)
- } else if (this.report.failures > 0) {
- debug(`${this.report.failures} failures; skipping batches for '${this.title}'`)
- this.runTeardown(results, callback)
- } else {
- debug(`${this.report.failures} failures; running batches for '${this.title}'`)
- this.runSubBatches(args, results, (err) => {
- if (err) {
- debug(`runSubBatches for '${this.title}' returned error '${err}'`)
-
- this.runTeardown(results, callback)
- } else {
- debug(`runSubBatches for '${this.title}' complete`)
-
- this.runTeardown(results, callback)
- }
- })
- }
-
- return undefined
- }.bind(this))
- }
-
- runTeardown (topicResults, callback) {
- const next = this.onTeardownComplete(callback)
-
- if (this.teardown !== null) {
- debug(`Running teardown for '${this.title}'`)
-
- try {
- const tdres = this.teardown.apply({ callback: next }, topicResults)
- if (_.isUndefined(tdres)) {
- return debug(`Results of teardown for '${this.title}' are undef; running async`)
- } else if (!_.isUndefined(Promise) && tdres instanceof Promise) {
- debug(`Results of teardown for '${this.title}' are defined and a Promise; resolving`)
- tdres
- .then((realTdres) => {
- next(null, realTdres)
- })
- .catch((err) => {
- next(err)
- })
- } else {
- debug(`Results of teardown for '${this.title}' are defined and not a Promise; running sync`)
- return next(null, tdres)
- }
- } catch (err) {
- debug(`Error thrown on teardown for '${this.title}': '${err}'`)
- return next(err)
- }
- } else {
- debug(`No teardown for '${this.title}'`)
-
- return next(null)
- }
- }
-
- onTeardownComplete (callback) {
- return atMostOnce(function () {
- const calledWith = Array.prototype.slice.call(arguments)
- const err = calledWith[0]
- const results = calledWith.slice(1)
-
- debug(`Teardown for '${this.title}' is complete`)
-
- if (err !== null) {
- debug(`Teardown for '${this.title}' called with err '${err}'`)
- }
-
- if ((results !== null) && results.length > 0) {
- debug(`Teardown for '${this.title}' called with results '${results}'`)
- }
-
- // Clear the report
-
- const report = this.report
- this.report = null
-
- return callback(null, report)
- }.bind(this))
- }
-
- runTests (err, results) {
- debug(`Running ${_.size(this.tests)} tests for batch '${this.title}'`)
-
- if (_.size(this.tests) > 0) {
- const args = _.concat([err], results)
-
- debug(`Passing args '${args.join(', ')}' to tests for batch '${this.title}'`)
-
- for (const name in this.tests) {
- const test = this.tests[name]
- assert.isString(name, `Name of test must be a string; '${name}'`)
- assert.isFunction(test, 'Test is not a function')
-
- debug(`Running test '${name}' for '${this.title}'`)
-
- try {
- test.apply(null, args)
- assert.ok(_.isObject(this.report))
- assert.ok(_.isObject(this.report.tests))
- this.report.tests[name] = true
-
- debug(`Finished running test '${name}' for '${this.title}'`)
- } catch (caught) {
- debug(`Error running test '${name}' for '${this.title}'`)
-
- assert.ok(_.isObject(this.report))
- assert.ok(_.isObject(this.report.tests))
- this.report.tests[name] = `${caught.name}: ${caught.message}`
- this.report.failures += 1
- }
- }
- }
- }
-
- runSubBatches (args, results, callback) {
- const batch = this
-
- assert.isArray(args, 'args for runSubBatches() must be an array')
- assert.isArray(results, 'results for runSubBatches() must be an array')
- assert.isFunction(callback, 'callback for runSubBatches() must be an array')
-
- debug(`Running ${_.size(this.batches)} batches for batch '${this.title}'`)
-
- if (_.size(this.batches) === 0) {
- return callback(null)
- } else {
- const batchArgs = _.concat(_.clone(results), args)
-
- debug(`Passing args '${batchArgs.join(', ')}' to batches for '${this.title}'`)
-
- const runBatch = (sub, callback) => {
- sub.run(batchArgs, (err, report) => {
- if (err) {
- debug(`Running sub-batch ${sub.title} resulted in an error`)
- batch.report.addSub(sub.title, report)
- callback(err)
- } else {
- debug(`Running sub-batch ${sub.title} succeeded`)
- batch.report.addSub(sub.title, report)
- callback(null)
- }
- })
- }
-
- return async.each(this.batches, runBatch, err => {
- if (err) {
- debug(`Running batches for '${this.title}' resulted in ${err}`)
- callback(err)
- } else {
- debug(`Running batches for '${this.title}' succeeded`)
- callback(null)
- }
- })
- }
- }
-}
-
-module.exports = Batch
diff --git a/lib/index.js b/lib/index.js
deleted file mode 100644
index 24c26b7e..00000000
--- a/lib/index.js
+++ /dev/null
@@ -1,33 +0,0 @@
-// index.js -- main module for vows
-//
-// Copyright 2016 fuzzy.ai
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-/* jshint esversion: 6 */
-
-'use strict'
-
-const debug = require('debug')('vows')
-
-const Suite = require('./suite')
-
-const describe = function (description) {
- debug(`Creating new suite with description '${description}'`)
- return new Suite(description)
-}
-
-module.exports = {
- describe,
- assert: require('./assert')
-}
diff --git a/lib/report.js b/lib/report.js
deleted file mode 100644
index 40defb3b..00000000
--- a/lib/report.js
+++ /dev/null
@@ -1,39 +0,0 @@
-// report.js -- Report of the results of a batch and its sub-batches
-//
-// Copyright 2017 fuzzy.ai
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-/* jshint esversion: 6 */
-
-'use strict'
-
-class Report {
- constructor (title) {
- this.title = title
- this.broken = 0
- this.successes = 0
- this.failures = 0
- this.tests = {}
- this.subs = {}
- }
-
- addSub (title, report) {
- this.subs[title] = report
- this.broken += report.broken
- this.successes += report.successes
- this.failures += report.failures
- }
-}
-
-module.exports = Report
diff --git a/lib/suite.js b/lib/suite.js
deleted file mode 100644
index 7bafd469..00000000
--- a/lib/suite.js
+++ /dev/null
@@ -1,129 +0,0 @@
-// suite.js -- a suite of batches of tests for vows
-//
-// Copyright 2016 fuzzy.ai
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-/* jshint esversion: 6 */
-
-'use strict'
-
-const _ = require('lodash')
-const async = require('async')
-const debug = require('debug')('vows:suite')
-
-const assert = require('./assert')
-const Batch = require('./batch')
-
-class Suite {
- constructor (description) {
- this.run = this.run.bind(this)
- this.description = description
- assert.isString(this.description, 'Suite description must be a string')
-
- debug(`Suite constructor with description '${this.description}'`)
-
- this.batches = []
- }
-
- addBatch (obj) {
- assert.isObject(obj, 'Argument to addBatch must be an Object')
- assert.equal(_.keys(obj).length, 1, 'Argument to addBatch must have one key')
-
- const title = _.keys(obj)[0]
-
- debug(`Adding batch '${title}' to suite '${this.description}'`)
-
- const batch = new Batch(title, obj[title])
-
- this.batches.push(batch)
-
- return this
- }
-
- export (module) {
- assert.isObject(module, 'Module is not an object')
-
- module.exports = this.run
-
- return this
- }
-
- run (callback) {
- let broken = 0
- let successes = 0
- let failures = 0
- const suite = this
-
- assert(_.isUndefined(callback) || _.isFunction(callback),
- 'If defined callback must be a function')
-
- const runBatch = (batch, callback) => {
- assert.isObject(batch, 'batch is not an object')
- assert.instanceOf(batch, Batch, 'batch is not a Batch')
- debug(`Running batch '${batch.title}' from suite '${this.description}'`)
- batch.run([], (err, report) => {
- if (err) {
- callback(err)
- } else {
- debug(`Batch ${batch.title} complete`)
-
- broken += report.broken
- successes += report.successes
- failures += report.failures
-
- suite.showReport(report)
-
- callback(null)
- }
- })
- }
-
- debug(`Running ${_.size(this.batches)} batches for suite '${this.description}'`)
-
- console.log()
- console.log(this.description)
- console.log()
-
- async.eachSeries(this.batches, runBatch, (err) => {
- if (err) {
- console.error(err)
- }
-
- console.log()
-
- if (_.isFunction(callback)) {
- return callback(null, broken, successes, failures)
- }
- })
-
- return this
- }
-
- showReport (report) {
- const suite = this
- console.log(report.title)
- _.each(report.tests, (value, name) => {
- if (_.isString(value)) {
- console.log(` ${name}: ${value}`)
- } else {
- console.log(` ${name}: OK`)
- }
- })
- _.each(report.subs, (subReport) => {
- suite.showReport(subReport)
- })
- }
-}
-
-module.exports = Suite
diff --git a/lib/vows.js b/lib/vows.js
new file mode 100644
index 00000000..363f96f2
--- /dev/null
+++ b/lib/vows.js
@@ -0,0 +1,255 @@
+//
+// Vows.js - asynchronous event-based BDD for node.js
+//
+// usage:
+//
+// var vows = require('vows');
+//
+// vows.describe('Deep Thought').addBatch({
+// "An instance of DeepThought": {
+// topic: new DeepThought,
+//
+// "should know the answer to the ultimate question of life": function (deepThought) {
+// assert.equal (deepThought.question('what is the answer to the universe?'), 42);
+// }
+// }
+// }).run();
+//
+var util = require('util'),
+ path = require('path'),
+ events = require('events'),
+ vows = exports;
+
+// Options
+vows.options = {
+ Emitter: events.EventEmitter,
+ reporter: require('./vows/reporters/dot-matrix'),
+ matcher: /.*/,
+ error: true // Handle "error" event
+};
+
+vows.__defineGetter__('reporter', function () {
+ return vows.options.reporter;
+});
+
+var stylize = require('./vows/console').stylize;
+var console = vows.console = require('./vows/console');
+
+vows.inspect = require('./vows/console').inspect;
+vows.prepare = require('./vows/extras').prepare;
+vows.tryEnd = require('./vows/suite').tryEnd;
+
+//
+// Assertion Macros & Extensions
+//
+require('./assert/error');
+require('./assert/macros');
+
+//
+// Suite constructor
+//
+var Suite = require('./vows/suite').Suite;
+
+//
+// This function gets added to events.EventEmitter.prototype, by default.
+// It's essentially a wrapper around `on`, which adds all the specification
+// goodness.
+//
+function addVow(vow) {
+ var batch = vow.batch,
+ event = vow.binding.context.event || 'success',
+ self = this;
+
+ batch.total ++;
+ batch.vows.push(vow);
+
+ // always set a listener on the event
+ this.on(event, function () {
+ var args = Array.prototype.slice.call(arguments);
+ // If the vow is a sub-event then we know it is an
+ // emitted event. So I don't muck with the arguments
+ // However the legacy behavior:
+ // If the callback is expecting two or more arguments,
+ // pass the error as the first (null) and the result after.
+ if (!(this.ctx && this.ctx.isEvent) &&
+ vow.callback.length >= 2 && batch.suite.options.error) {
+ args.unshift(null);
+ }
+ runTest(args, this.ctx);
+ vows.tryEnd(batch);
+ });
+
+ if (event !== 'error') {
+ this.on("error", function (err) {
+ if (vow.callback.length >= 2 || !batch.suite.options.error) {
+ runTest(arguments, this.ctx);
+ } else {
+ output('errored', { type: 'promise', error: err.stack ||
+ err.message || JSON.stringify(err) });
+ }
+ vows.tryEnd(batch);
+ });
+ }
+
+ // in case an event fired before we could listen
+ if (this._vowsEmitedEvents &&
+ this._vowsEmitedEvents.hasOwnProperty(event)) {
+ // make sure no one is messing with me
+ if (Array.isArray(this._vowsEmitedEvents[event])) {
+ // I don't think I need to optimize for one event,
+ // I think it is more important to make sure I check the vow n times
+ self._vowsEmitedEvents[event].forEach(function(args) {
+ runTest(args, self.ctx);
+ });
+ } else {
+ // initial conditions problem
+ throw new Error('_vowsEmitedEvents[' + event + '] is not an Array')
+ }
+ vows.tryEnd(batch);
+ }
+
+ return this;
+
+ function runTest(args, ctx) {
+ if (vow.callback instanceof String) {
+ return output('pending');
+ }
+
+ if (vow.binding.context.isEvent && vow.binding.context.after) {
+ var after = vow.binding.context.after;
+ // only need to check order. I won't get here if the after event
+ // has never been emitted
+ if (self._vowsEmitedEventsOrder.indexOf(after) >
+ self._vowsEmitedEventsOrder.indexOf(event)) {
+ output('broken', event + ' emitted before ' + after);
+ return;
+ }
+ }
+
+ // Run the test, and try to catch `AssertionError`s and other exceptions;
+ // increment counters accordingly.
+ try {
+ vow.callback.apply(ctx === global || !ctx ? vow.binding : ctx, args);
+ output('honored');
+ } catch (e) {
+ if (e.name && e.name.match(/AssertionError/)) {
+ output('broken', e.toString().replace(/\`/g, '`'));
+ } else {
+ output('errored', e.stack || e.message || e);
+ }
+ }
+ }
+
+ function output(status, exception) {
+ batch[status] ++;
+ vow.status = status;
+
+ if (vow.context && batch.lastContext !== vow.context) {
+ batch.lastContext = vow.context;
+ batch.suite.report(['context', vow.context]);
+ }
+ batch.suite.report(['vow', {
+ title: vow.description,
+ context: vow.context,
+ status: status,
+ exception: exception || null
+ }]);
+ }
+};
+
+//
+// On exit, check that all promises have been fired.
+// If not, report an error message.
+//
+process.on('exit', function () {
+ var results = { honored: 0, broken: 0, errored: 0, pending: 0, total: 0 },
+ failure;
+
+ vows.suites.forEach(function (s) {
+ if ((s.results.total > 0) && (s.results.time === null)) {
+ s.reporter.print('\n\n');
+ s.reporter.report(['error', { error: "Asynchronous Error", suite: s }]);
+ }
+ s.batches.forEach(function (b) {
+ var unFired = [];
+
+ b.vows.forEach(function (vow) {
+ if (! vow.status) {
+ if (unFired.indexOf(vow.context) === -1) {
+ unFired.push(vow.context);
+ }
+ }
+ });
+
+ if (unFired.length > 0) { util.print('\n') }
+
+ unFired.forEach(function (title) {
+ s.reporter.report(['error', {
+ error: "callback not fired",
+ context: title,
+ batch: b,
+ suite: s
+ }]);
+ });
+
+ if (b.status === 'begin') {
+ failure = true;
+ results.errored ++;
+ results.total ++;
+ }
+ Object.keys(results).forEach(function (k) { results[k] += b[k] });
+ });
+ });
+ if (failure) {
+ util.puts(console.result(results));
+ }
+});
+
+vows.suites = [];
+
+// We need the old emit function so we can hook it
+// and do magic to deal with events that have fired
+var oldEmit = vows.options.Emitter.prototype.emit;
+
+//
+// Create a new test suite
+//
+vows.describe = function (subject) {
+ var suite = new(Suite)(subject);
+
+ this.options.Emitter.prototype.addVow = addVow;
+ // just in case someone emit's before I get to it
+ this.options.Emitter.prototype.emit = function (event) {
+ this._vowsEmitedEvents = this._vowsEmitedEvents || {};
+ this._vowsEmitedEventsOrder = this._vowsEmitedEventsOrder || [];
+ // slice off the event
+ var args = Array.prototype.slice.call(arguments, 1);
+ // if multiple events are fired, add or push
+ if (this._vowsEmitedEvents.hasOwnProperty(event)) {
+ this._vowsEmitedEvents[event].push(args);
+ } else {
+ this._vowsEmitedEvents[event] = [args];
+ }
+
+ // push the event onto a stack so I have an order
+ this._vowsEmitedEventsOrder.push(event);
+ return oldEmit.apply(this, arguments);
+ }
+ this.suites.push(suite);
+
+ //
+ // Add any additional arguments as batches if they're present
+ //
+ if (arguments.length > 1) {
+ for (var i = 1, l = arguments.length; i < l; ++i) {
+ suite.addBatch(arguments[i]);
+ }
+ }
+
+ return suite;
+};
+
+
+vows.version = JSON.parse(require('fs')
+ .readFileSync(path.join(__dirname, '..', 'package.json')))
+ .version
diff --git a/lib/vows/console.js b/lib/vows/console.js
new file mode 100644
index 00000000..900cef96
--- /dev/null
+++ b/lib/vows/console.js
@@ -0,0 +1,140 @@
+var eyes = require('eyes').inspector({ stream: null, styles: false });
+
+// Stylize a string
+this.stylize = function stylize(str, style) {
+ if (module.exports.nocolor) {
+ return str;
+ }
+
+ var styles = {
+ 'bold' : [1, 22],
+ 'italic' : [3, 23],
+ 'underline' : [4, 24],
+ 'cyan' : [96, 39],
+ 'yellow' : [33, 39],
+ 'green' : [32, 39],
+ 'red' : [31, 39],
+ 'grey' : [90, 39],
+ 'green-hi' : [92, 32],
+ };
+ return '\033[' + styles[style][0] + 'm' + str +
+ '\033[' + styles[style][1] + 'm';
+};
+
+var $ = this.$ = function (str) {
+ str = new(String)(str);
+
+ ['bold', 'grey', 'yellow', 'red', 'green', 'white', 'cyan', 'italic'].forEach(function (style) {
+ Object.defineProperty(str, style, {
+ get: function () {
+ return exports.$(exports.stylize(this, style));
+ }
+ });
+ });
+ return str;
+};
+
+this.puts = function (options) {
+ var stylize = exports.stylize;
+ options.stream || (options.stream = process.stdout);
+ options.tail = options.tail || '';
+
+ return function (args) {
+ args = Array.prototype.slice.call(arguments);
+ if (!options.raw) {
+ args = args.map(function (a) {
+ return a.replace(/`([^`]+)`/g, function (_, capture) { return stylize(capture, 'italic') })
+ .replace(/\*([^*]+)\*/g, function (_, capture) { return stylize(capture, 'bold') })
+ .replace(/\n/g, function (_, capture) { return ' \n ' } );
+ });
+ }
+ return options.stream.write(args.join('\n') + options.tail);
+ };
+};
+
+this.result = function (event) {
+ var result = [], buffer = [], time = '', header;
+ var complete = event.honored + event.pending + event.errored + event.broken;
+ var status = (event.errored && 'errored') || (event.broken && 'broken') ||
+ (event.honored && 'honored') || (event.pending && 'pending');
+
+ if (event.total === 0) {
+ return [$("Could not find any tests to run.").bold.red];
+ }
+
+ event.honored && result.push($(event.honored).bold + " honored");
+ event.broken && result.push($(event.broken).bold + " broken");
+ event.errored && result.push($(event.errored).bold + " errored");
+ event.pending && result.push($(event.pending).bold + " pending");
+
+ if (complete < event.total) {
+ result.push($(event.total - complete).bold + " dropped");
+ }
+
+ result = result.join(' ∙ ');
+
+ header = {
+ honored: '✓ ' + $('OK').bold.green,
+ broken: '✗ ' + $('Broken').bold.yellow,
+ errored: '✗ ' + $('Errored').bold.red,
+ pending: '- ' + $('Pending').bold.cyan
+ }[status] + ' » ';
+
+ if (typeof(event.time) === 'number') {
+ time = ' (' + event.time.toFixed(3) + 's)';
+ time = this.stylize(time, 'grey');
+ }
+ buffer.push(header + result + time + '\n');
+
+ return buffer;
+};
+
+this.inspect = function inspect(val) {
+ if (module.exports.nocolor) {
+ return eyes(val);
+ }
+
+ return '\033[1m' + eyes(val) + '\033[22m';
+};
+
+this.error = function (obj) {
+ var string = '✗ ' + $('Errored ').red + '» ';
+ string += $(obj.error).red.bold + '\n';
+ string += (obj.context ? ' in ' + $(obj.context).red + '\n': '');
+ string += ' in ' + $(obj.suite.subject).red + '\n';
+ string += ' in ' + $(obj.suite._filename).red;
+
+ return string;
+};
+
+this.contextText = function (event) {
+ return ' ' + event;
+};
+
+this.vowText = function (event) {
+ var buffer = [];
+
+ buffer.push(' ' + {
+ honored: ' ✓ ',
+ broken: ' ✗ ',
+ errored: ' ✗ ',
+ pending: ' - '
+ }[event.status] + this.stylize(event.title, ({
+ honored: 'green',
+ broken: 'yellow',
+ errored: 'red',
+ pending: 'cyan'
+ })[event.status]));
+
+ if (event.status === 'broken') {
+ buffer.push(' » ' + event.exception);
+ } else if (event.status === 'errored') {
+ if (event.exception.type === 'promise') {
+ buffer.push(' » ' + this.stylize("An unexpected error was caught: " +
+ this.stylize(event.exception.error, 'bold'), 'red'));
+ } else {
+ buffer.push(' ' + this.stylize(event.exception, 'red'));
+ }
+ }
+ return buffer.join('\n');
+};
diff --git a/lib/vows/context.js b/lib/vows/context.js
new file mode 100644
index 00000000..b11d6762
--- /dev/null
+++ b/lib/vows/context.js
@@ -0,0 +1,76 @@
+
+this.Context = function (vow, ctx, env) {
+ var that = this;
+
+ this.tests = vow.callback;
+ this.topics = (ctx.topics || []).slice(0);
+ this.emitter = null;
+ this.env = env || {};
+ this.env.context = this;
+
+ this.env.callback = function (/* arguments */) {
+ var ctx = this;
+ var args = Array.prototype.slice.call(arguments);
+
+ var emit = (function (args) {
+ //
+ // Convert callback-style results into events.
+ //
+ if (vow.batch.suite.options.error) {
+ return function () {
+ var e = args.shift();
+ that.emitter.ctx = ctx;
+ // We handle a special case, where the first argument is a
+ // boolean, in which case we treat it as a result, and not
+ // an error. This is useful for `path.exists` and other
+ // functions like it, which only pass a single boolean
+ // parameter instead of the more common (error, result) pair.
+ if (typeof(e) === 'boolean' && args.length === 0) {
+ that.emitter.emit.call(that.emitter, 'success', e);
+ } else {
+ if (e) { that.emitter.emit.apply(that.emitter, ['error', e].concat(args)) }
+ else { that.emitter.emit.apply(that.emitter, ['success'].concat(args)) }
+ }
+ };
+ } else {
+ return function () {
+ that.emitter.ctx = ctx;
+ that.emitter.emit.apply(that.emitter, ['success'].concat(args));
+ };
+ }
+ })(args.slice(0));
+ // If `this.callback` is called synchronously,
+ // the emitter will not have been set yet,
+ // so we defer the emition, that way it'll behave
+ // asynchronously.
+ if (that.emitter) { emit() }
+ else { process.nextTick(emit) }
+ };
+ this.name = vow.description;
+ // events is an alias for on
+ if (this.name === 'events') {
+ this.name = vow.description = 'on';
+ }
+
+ // if this is a sub-event context AND it's context was an event,
+ // then I must enforce event order.
+ // this will not do a good job of handling pin-pong events
+ if (this.name === 'on' && ctx.isEvent) {
+ this.after = ctx.name;
+ }
+
+ if (ctx.name === 'on') {
+ this.isEvent = true;
+ this.event = this.name;
+ this.after = ctx.after;
+ } else {
+ this.isEvent = false;
+ this.event = 'success';
+ }
+
+ this.title = [
+ ctx.title || '',
+ vow.description || ''
+ ].join(/^[#.:]/.test(vow.description) ? '' : ' ').trim();
+};
+
diff --git a/lib/vows/coverage/file.js b/lib/vows/coverage/file.js
new file mode 100644
index 00000000..5bdef903
--- /dev/null
+++ b/lib/vows/coverage/file.js
@@ -0,0 +1,29 @@
+
+exports.coverage = function (filename, data) {
+ var ret = {
+ filename: filename,
+ coverage: 0,
+ hits: 0,
+ misses: 0,
+ sloc : 0
+ };
+
+ var source = data.source;
+ ret.source = source.map(function (line, num) {
+ num++;
+
+ if (data[num] === 0) {
+ ret.misses++;
+ ret.sloc++;
+ } else if (data[num] !== undefined) {
+ ret.hits++;
+ ret.sloc++;
+ }
+
+ return { line: line, coverage: (data[num] === undefined ? '' : data[num]) };
+ });
+
+ ret.coverage = (ret.hits / ret.sloc) * 100;
+
+ return ret;
+};
\ No newline at end of file
diff --git a/lib/vows/coverage/fragments/coverage-foot.html b/lib/vows/coverage/fragments/coverage-foot.html
new file mode 100644
index 00000000..691287b6
--- /dev/null
+++ b/lib/vows/coverage/fragments/coverage-foot.html
@@ -0,0 +1,2 @@
+