# broccoli-test-helper

> Test helpers for BroccoliPlugins that make testing build and rebuild behavior dead simple and expect diff friendly.

Latest version **2.0.0** (published 2018-10-25) · MIT license · 0 weekly downloads

## Install

```sh
npm install broccoli-test-helper
pnpm add broccoli-test-helper
yarn add broccoli-test-helper
bun add broccoli-test-helper
```

## Health

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

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.0.0 |
| Published | 2018-10-25 |
| First published | 2017-02-03 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | 6.* \|\| 8.* \|\| >= 10.* |
| Dependencies | 6 |
| Unpacked size | 51.3 KB |
| Known vulnerabilities | 0 (+2 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 12 |
| Author | Kris Selden |
| Maintainers | krisselden, rwjblue, stefanpenner |

## Links

- npm: https://www.npmjs.com/package/broccoli-test-helper
- Repository: https://github.com/broccolijs/broccoli-test-helper
- Issues: https://github.com/broccolijs/broccoli-test-helper/issues
- npm.io page: https://npm.io/package/broccoli-test-helper

## Dependencies (6)

- [tmp](https://npm.io/package/tmp.md) ^0.0.33
- [broccoli](https://npm.io/package/broccoli.md) ^2.0.0
- [fixturify](https://npm.io/package/fixturify.md) ^0.3.2
- [walk-sync](https://npm.io/package/walk-sync.md) ^0.3.3
- [@types/tmp](https://npm.io/package/@types/tmp.md) ^0.0.33
- [fs-tree-diff](https://npm.io/package/fs-tree-diff.md) ^0.5.9

## Recent versions

- 2.0.0 (latest) — 2018-10-25
- 1.5.0 — 2018-08-23
- 1.4.0 — 2018-07-27
- 1.3.0 — 2018-06-13
- 1.2.0 — 2017-08-23
- 1.1.0 — 2017-03-13
- 1.0.0 — 2017-02-03

## README

# broccoli-test-helper

Test helpers for BroccoliPlugins that make testing build and rebuild behavior dead simple and diff friendly.

Has TypeScript declarations and supports async/await style testing.

[![Build status](https://ci.appveyor.com/api/projects/status/4oilygqd42yc8wsl/branch/master?svg=true)](https://ci.appveyor.com/project/embercli/broccoli-test-helper/branch/master)
[![Build Status](https://travis-ci.org/broccolijs/broccoli-test-helper.svg?branch=master)](https://travis-ci.org/broccolijs/broccoli-test-helper)

- [Usage Examples](#usage-examples)
  - [QUnit and TypeScript](#qunit-and-typescript)
  - [Mocha and co](#mocha-and-co)
- [API](docs/api/index.md)

# Usage Examples

## QUnit and TypeScript

Example works in Node 4+ by using `tsc -t ES2015 -m commonjs` to compile async/await to generator wrapped in a helper.

```ts
import { createBuilder, createTempDir } from "broccoli-test-helper";
import Herp2Derp = require("../index");

QUnit.module("Herp2Derp", () => {
  QUnit.test("test build", async assert => {
    const input = await createTempDir();
    try {
      const subject = new Herp2Derp(input.path());
      const output = createBuilder(subject);
      try {
        // INITIAL
        input.write({
          "a.herp": "A",
          lib: {
            "b.herp": "B",
            "c.herp": "C",
          },
        });
        await output.build();

        assert.deepEqual(output.read(), {
          "a.derp": "derp A!",
          lib: {
            "b.derp": "derp B!",
            "c.derp": "derp C!",
          },
        });
        assert.deepEqual(output.changes(), {
          "a.derp": "create",
          "lib/": "mkdir",
          "lib/b.derp": "create",
          "lib/c.derp": "create",
        });

        // UPDATE
        input.write({
          "a.herp": "AA", // change
          lib: null, // rmdir
        });
        await output.build();

        assert.deepEqual(output.read(), {
          "a.derp": "derp AA!",
        });
        assert.deepEqual(output.changes(), {
          "lib/c.derp": "unlink",
          "lib/b.derp": "unlink",
          "lib/": "rmdir",
          "a.derp": "change",
        });

        // NOOP
        await output.build();

        assert.deepEqual(output.changes(), {});
      } finally {
        await output.dispose();
      }
    } finally {
      await input.dispose();
    }
  });
});
```

## Mocha and co

Example works in Node 4+ by using `co` for async/await like generator syntax.

```js
"use strict";
const helper = require("broccoli-test-helper");
const co = require("co");
const expect = require("chai").expect;
const createBuilder = helper.createBuilder;
const createTempDir = helper.createTempDir;
const Herp2Derp = require("../index");

describe("Herp2Derp", function() {
  it(
    "should build",
    co.wrap(function*() {
      const input = yield createTempDir();
      try {
        const subject = new Herp2Derp(input.path());
        const output = createBuilder(subject);
        try {
          // INITIAL
          input.write({
            "a.herp": "A",
            lib: {
              "b.herp": "B",
              "c.herp": "C",
            },
          });
          yield output.build();

          expect(output.read()).to.deep.equal({
            "a.derp": "derp A!",
            lib: {
              "b.derp": "derp B!",
              "c.derp": "derp C!",
            },
          });
          expect(output.changes()).to.deep.equal({
            "a.derp": "create",
            "lib/": "mkdir",
            "lib/b.derp": "create",
            "lib/c.derp": "create",
          });

          // UPDATE
          input.write({
            "a.herp": "AA", // change
            lib: null, // rmdir
          });
          yield output.build();

          expect(output.read()).to.deep.equal({
            "a.derp": "derp AA!",
          });
          expect(output.changes()).to.deep.equal({
            "lib/c.derp": "unlink",
            "lib/b.derp": "unlink",
            "lib/": "rmdir",
            "a.derp": "change",
          });

          // NOOP
          yield output.build();

          expect(output.changes()).to.deep.equal({});
        } finally {
          yield output.dispose();
        }
      } finally {
        yield input.dispose();
      }
    })
  );
});
```

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