ember-cli-blueprint-test-helpers

test helpers for ember-cli blueprints

Installation

ember install ember-cli-blueprint-test-helpers

It should be noted that ember-cli-blueprint-test-helpers currently only works for testing blueprints inside addon projects.

Usage

Running Tests

The blueprint tests can be run by:

node_modules/.bin/mocha node-tests --recursive

For convenience you should add the following to your package.json:

1"scripts": {
2  "nodetest": "mocha node-tests --recursive"
3}

to be able to use npm run nodetest to run the tests.

Generating Tests

Generate a blueprint test scaffold using the blueprint-test generator:

ember generate blueprint-test my-blueprint

which will generate a test file at node-tests/blueprints/my-blueprint-test.js.

Example Usage

1describe('Acceptance: ember generate and destroy my-blueprint', function() {
2  // create and destroy temporary working directories
3  setupTestHooks(this);
4
5  it('my-blueprint foo', function() {
6    const args = ['my-blueprint', 'foo'];
7
8    // create a new Ember.js app in the working directory
9    return emberNew()
10
11      // then generate and destroy the `my-blueprint` blueprint called `foo`
12      .then(() => emberGenerateDestroy(args, (file) => {
13
14        // and run some assertions in between
15        expect(file('path/to/file.js'))
16          .to.contain('file contents to match')
17          .to.contain('more file contents\n');
18      }));
19
20     // magically done for you: assert that the generated files are destroyed again
21  });
22});

or more explicitly:

1describe('Acceptance: ember generate and destroy my-blueprint', function() {
2  // create and destroy temporary working directories
3  setupTestHooks(this);
4
5  it('my-blueprint foo', function() {
6    const args = ['my-blueprint', 'foo'];
7
8    // create a new Ember.js app in the working directory
9    return emberNew()
10
11      // then generate the `my-blueprint` blueprint called `foo`
12      .then(() => emberGenerate(args))
13
14      // then assert that the files were generated correctly
15      .then(() => expect(file('path/to/file.js'))
16        .to.contain('file contents to match')
17        .to.contain('more file contents\n'))
18
19      // then destroy the `my-blueprint` blueprint called `foo`
20      .then(() => emberDestroy(args))
21
22      // then assert that the files were destroyed correctly
23      .then(() => expect(file('path/to/file.js')).to.not.exist);
24  });
25});

if your blueprints support the new MU file structure, you can test them using this option: { ìsModuleUnification: true }

1describe('Acceptance: ember generate and destroy my-blueprint', function() {
2  // create and destroy temporary working directories
3  setupTestHooks(this);
4
5  it('my-blueprint foo', function() {
6    const args = ['my-blueprint', 'foo'];
7
8    // create a new Ember.js app in the working directory
9    // this app will have MU file structure, namely a `src` directory
10    return emberNew({ isModuleUnification: true })
11
12      // then generate the `my-blueprint` blueprint called `foo`
13      .then(() => emberGenerate(args, { isModuleUnification: true }))
14
15      // then assert that the files were generated correctly
16      .then(() => expect(file('path/to/file.js'))
17        .to.contain('file contents to match')
18        .to.contain('more file contents\n'))
19
20      // then destroy the `my-blueprint` blueprint called `foo`
21      .then(() => emberDestroy(args, { isModuleUnification: true }))
22
23      // then assert that the files were destroyed correctly
24      .then(() => expect(file('path/to/file.js')).to.not.exist);
25  });
26});

API Reference

This project exports two major API endpoints for you to use:

• require('ember-cli-blueprint-test-helpers/chai')

  This endpoint exports the Chai assertion library including the chai-as-promised and chai-files plugins

• require('ember-cli-blueprint-test-helpers/helpers')

  This endpoint exports the functions mentioned in the following API reference

---

setupTestHooks(scope, options)

Prepare the test context for the blueprint tests.

Parameters:

• {Object} scope the test context (i.e. this)
• {Object} [options] optional parameters
• {Number} [options.timeout=20000] the test timeout in milliseconds
• {Object} [options.tmpenv] object containing info about the temporary directory for the test.
• {String} [options.cliPath='ember-cli'] path to the ember-cli dependency
• {Boolean} [options.disabledTasks=['addon-install', 'bower-install', 'npm-install']] override the mocked installs Defaults to lib/helpers/tmp-env.js

Returns: {Promise}

---

emberNew(options)

Create a new Ember.js app or addon in the current working directory.

Parameters:

• {Object} [options] optional parameters
• {String} [options.target='app'] the type of project to create (app, addon or in-repo-addon)
• {Boolean} [options.isModuleUnification=true] a toggle to use MU file structure

Returns: {Promise}

---

emberGenerate(args, options)

Run a blueprint generator.

Parameters:

• {Array.<String>} args arguments to pass to ember generate (e.g. ['my-blueprint', 'foo'])
• {Object} [options] optional parameters
• {Boolean} [options.isModuleUnification=true] a toggle to use MU file structure

Returns: {Promise}

---

emberDestroy(args, options)

Run a blueprint destructor.

Parameters:

• {Array.<String>} args arguments to pass to ember destroy (e.g. ['my-blueprint', 'foo'])
• {Object} [options] optional parameters
• {Boolean} [options.isModuleUnification=true] a toggle to use MU file structure

Returns: {Promise}

---

emberGenerateDestroy(args, assertionCallback, options)

Run a blueprint generator and the corresponding blueprint destructor while checking assertions in between.

Parameters:

• {Array.<String>} args arguments to pass to ember generate (e.g. ['my-blueprint', 'foo'])
• {Function} assertionCallback the callback function in which the assertions should happen
• {Object} [options] optional parameters
• {Boolean} [options.isModuleUnification=true] a toggle to use MU file structure

Returns: {Promise}

---

modifyPackages(packages)

Modify the dependencies in the package.json file of the test project.

Parameters:

• {Array.<Object>} packages the list of packages that should be added, changed or removed

---

setupPodConfig(options)

Setup usePods in .ember-cli and/or podModulePrefix in environment.js.

Parameters:

• {Object} [options] optional parameters
• {Boolean} [options.usePods] add usePods in .ember-cli
• {Boolean} [options.podModulePrefix] set npodModulePrefix to app/pods in config/environment.js

Used by

• https://github.com/emberjs/ember.js
• https://github.com/emberjs/data
• https://github.com/ember-cli/ember-cli-legacy-blueprints
• https://github.com/simplabs/ember-simple-auth
• https://github.com/DockYard/ember-suave

License

This project is licensed under the MIT License.