# vows

> Asynchronous BDD & continuous integration for node.js

Latest version **0.8.3** (published 2019-10-15) · MIT license · 0 weekly downloads

## Install

```sh
npm install vows
pnpm add vows
yarn add vows
bun add vows
```

Provides the command `vows`.

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 0.8.3 |
| Published | 2019-10-15 |
| First published | 2010-12-29 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 183.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1556 |
| Author | Alexis Sellier |
| Maintainers | cloudhead, evanp, indexzero, jerrysievert, mmalecki, strugee |
| Keywords | testing, spec, test, BDD |

## Links

- npm: https://www.npmjs.com/package/vows
- Repository: https://github.com/cloudhead/vows
- Issues: https://github.com/cloudhead/vows/issues
- npm.io page: https://npm.io/package/vows

## Dependencies (3)

- [diff](https://npm.io/package/diff.md) ^4.0.1
- [eyes](https://npm.io/package/eyes.md) ~0.1.6
- [glob](https://npm.io/package/glob.md) ^7.1.2

## Alternatives

- [duck](https://npm.io/package/duck.md) — 4.2M weekly downloads
- [ava](https://npm.io/package/ava.md) — 560.2K weekly downloads
- [storybook-addon-module-mock](https://npm.io/package/storybook-addon-module-mock.md) — 71.7K weekly downloads
- [vest](https://npm.io/package/vest.md) — 50.1K weekly downloads
- [@ethereum-waffle/mock-contract](https://npm.io/package/@ethereum-waffle/mock-contract.md) — 40.0K weekly downloads

## Recent versions

- 0.8.3 (latest) — 2019-10-15
- 1.0.0-alpha.1 (next) — 2018-04-27
- 0.8.2 — 2018-05-15
- 0.9.0-rc3 — 2015-09-22
- 0.9.0-rc2 — 2014-12-31
- 0.9.0-rc1 — 2014-12-03
- 0.8.1 — 2014-11-22
- 0.8.0 — 2014-11-04
- 0.7.0 — 2012-11-16
- 0.6.4 — 2012-08-23
- 0.6.3 — 2012-06-26
- 0.6.2 — 2012-02-24
- 0.6.1 — 2011-12-26
- 0.6.0 — 2011-11-25
- 0.5.13 — 2011-11-02
- … 22 more at https://npm.io/package/vows/versions

## README

# vows [![Build Status](https://api.travis-ci.org/flatiron/vows.svg)](http://travis-ci.org/flatiron/vows)

> Asynchronous BDD & continuous integration for node.js

#### <http://vowsjs.org> #

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.

_Vows_ is an experiment in making this possible, while adding a minimum of overhead.

synopsis
--------

```js
var vows = require('vows'),
    assert = require('assert');

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);
        }
    }
});
```

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.

### 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:

```sh
$ 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
```

### instrumenting with jscoverage

```sh
$ jscoverage myfile.js myfile-instrumented.js
```

installation
------------

```sh
$ npm install vows
```

documentation
-------------

Head over to <http://vowsjs.org>

run tests
-------------

```sh
$ npm test
```

authors
-------

[Alexis Sellier](https://github.com/cloudhead), [Charlie Robbins](https://github.com/indexzero), [Jerry Sievert](https://github.com/jerrysievert)

*...and many others*

---
_Source: https://npm.io/package/vows · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._