# gulp-ava

> Run AVA tests

Latest version **3.0.0** (published 2019-10-14) · MIT license · 0 weekly downloads

## Install

```sh
npm install gulp-ava
pnpm add gulp-ava
yarn add gulp-ava
bun add gulp-ava
```

## Health

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

Positive: no vulnerabilities.

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

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 3.0.0 |
| Published | 2019-10-14 |
| First published | 2015-09-07 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=8 |
| Dependencies | 7 |
| Unpacked size | 4.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 55 |
| Author | Sindre Sorhus |
| Maintainers | novemberborn, sindresorhus, vdemedes |
| Keywords | gulpplugin, ava, test, runner, concurrent, parallel, fast, tape, tap, mocha, qunit, jasmine |

## Links

- npm: https://www.npmjs.com/package/gulp-ava
- Repository: https://github.com/avajs/gulp-ava
- Homepage: https://github.com/avajs/gulp-ava#readme
- Issues: https://github.com/avajs/gulp-ava/issues
- npm.io page: https://npm.io/package/gulp-ava

## Dependencies (7)

- [ava](https://npm.io/package/ava.md) ^2.4.0
- [dargs](https://npm.io/package/dargs.md) ^7.0.0
- [execa](https://npm.io/package/execa.md) ^3.0.0
- [through2](https://npm.io/package/through2.md) ^3.0.0
- [fancy-log](https://npm.io/package/fancy-log.md) ^1.3.3
- [resolve-cwd](https://npm.io/package/resolve-cwd.md) ^3.0.0
- [plugin-error](https://npm.io/package/plugin-error.md) ^1.0.1

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

- 3.0.0 (latest) — 2019-10-14
- 2.0.0 — 2019-07-06
- 1.0.0 — 2018-12-15
- 0.19.0 — 2018-03-25
- 0.18.0 — 2017-06-28
- 0.17.1 — 2017-04-20
- 0.17.0 — 2017-04-17
- 0.16.0 — 2017-02-02
- 0.15.0 — 2016-11-17
- 0.14.1 — 2016-08-30
- 0.14.0 — 2016-08-18
- 0.13.0 — 2016-08-06
- 0.12.1 — 2016-06-17
- 0.12.0 — 2016-05-26
- 0.11.0 — 2016-04-07
- … 13 more at https://npm.io/package/gulp-ava/versions

## README

# gulp-ava [![Build Status](https://travis-ci.org/avajs/gulp-ava.svg?branch=master)](https://travis-ci.org/avajs/gulp-ava)

> Run [AVA](https://ava.li) tests


## Install

```
$ npm install --save-dev gulp-ava
```


## Usage

```js
const gulp = require('gulp');
const ava = require('gulp-ava');

exports.default = () => (
	gulp.src('test.js')
		// `gulp-ava` needs file paths, so you can't have any plugins before it
		.pipe(ava({verbose: true}))
);
```


## API

### ava(options?)

This plugin adheres to AVA [options](https://github.com/avajs/ava#configuration) in package.json. You can also specify options in the plugin, as seen above, but prefer the package.json approach whenever possible.

`gulp-ava` specific options:

#### silent

Type: `boolean`<br>
Default: `false`

Only print output on failure.

#### nyc

Type: `boolean`<br>
Default: `false`

Run AVA with [`nyc`](https://github.com/istanbuljs/nyc). You must have `nyc` as a devDependency. `nyc` [options](https://github.com/istanbuljs/nyc#configuring-nyc) can be defined in package.json.

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