Skip to content

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

Notifications You must be signed in to change notification settings

broccolijs/broccoli-test-helper

Repository files navigation

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 Build Status

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.

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

Example works in Node 8+ by using async/await.

const { createBuilder, createTempDir } = require('broccoli-test-helper');
const { expect } = require('chai');
const Herp2Derp = require('../index');

describe('Herp2Derp', function () {
  it('should build', async function () {
    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();

        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
        });
        await 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
        await output.build();

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

About

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

Resources

Stars

Watchers

Forks

Packages

No packages published