Rfc | Ember.js RFCs
Open on Github

Deprecate Support for ember-cli-qunit and ember-cli-mocha When Generating Test Blueprints

Summary

This RFC proposes to deprecate support for ember-cli-qunit and ember-cli-mocha when generating test blueprints.

Motivation

Both ember-cli-qunit and ember-cli-mocha were deprecated a long time ago in favor of ember-qunit and ember-mocha respectively.

Deprecating (and later on, removing) support for both addons would greatly reduce the amount of test blueprints we have in ember-source and ember-data.

Transition Path

The test-framework-detector.js files in ember-source and in ember-data will be updated to display a deprecation message whenever ember-cli-qunit or ember-cli-mocha is detected when generating test blueprints:

Support for `ember-cli-qunit` when generating test blueprints has been deprecated.
Please migrate to using `ember-qunit` instead.

Deprecation details:

Key Value
for 'ember-source'
id 'ember-source.ember-cli-qunit-test-blueprints'
since { available: '4.X.X', enabled: '4.X.X' }
until '5.0.0'

NOTE: ember-cli-qunit and ember-source in the deprecation message and details above should be replaced with ember-cli-mocha and ember-data appropriately.

Deprecation Guide

ember-cli-qunit Test Blueprints

Support for ember-cli-qunit when generating test blueprints has been deprecated. Please migrate to using ember-qunit instead:

Using Yarn:

  • Run yarn remove ember-cli-qunit
  • Run yarn add ember-qunit --dev
  • Update tests/test-helper.js to replace any imports from ember-cli-qunit with imports from ember-qunit

Using npm:

  • Run npm uninstall ember-cli-qunit
  • Run npm install ember-qunit --save-dev
  • Update tests/test-helper.js to replace any imports from ember-cli-qunit with imports from ember-qunit

NOTE: This guide has been taken from ember-cli-qunit's README.md file.

ember-cli-mocha Test Blueprints

Support for ember-cli-mocha when generating test blueprints has been deprecated. Please migrate to using ember-mocha instead:

Using Yarn:

  • Run yarn remove ember-cli-mocha
  • Run yarn add ember-mocha --dev
  • Update tests/test-helper.js to replace any imports from ember-cli-mocha with imports from ember-mocha

Using npm:

  • Run npm uninstall ember-cli-mocha
  • Run npm install ember-mocha --save-dev
  • Update tests/test-helper.js to replace any imports from ember-cli-mocha with imports from ember-mocha

NOTE: This guide has been taken from ember-cli-mocha's README.md file.

How We Teach This

I don't think we need to update any learning material to reflect this deprecation.

Drawbacks

I don't think there are any real drawbacks, aside from the usual churn that deprecations introduce.

Alternatives

I don't think there are any meaningful alternatives.

Unresolved questions

None at the moment.