ember-exam 9.0.0 → 10.0.0

package/.release-plan.json

@@ -0,0 +1,30 @@
+{
+  "solution": {
+    "ember-exam": {
+      "impact": "major",
+      "oldVersion": "9.1.0",
+      "newVersion": "10.0.0",
+      "tagName": "latest",
+      "constraints": [
+        {
+          "impact": "major",
+          "reason": "Appears in changelog section :boom: Breaking Change"
+        },
+        {
+          "impact": "patch",
+          "reason": "Appears in changelog section :bug: Bug Fix"
+        },
+        {
+          "impact": "patch",
+          "reason": "Appears in changelog section :memo: Documentation"
+        },
+        {
+          "impact": "patch",
+          "reason": "Appears in changelog section :house: Internal"
+        }
+      ],
+      "pkgJSONPath": "./package.json"
+    }
+  },
+  "description": "## Release (2025-08-26)\n\n* ember-exam 10.0.0 (major)\n\n#### :boom: Breaking Change\n* `ember-exam`\n  * [#1430](https://github.com/ember-cli/ember-exam/pull/1430) Support vite ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n\n#### :bug: Bug Fix\n* `ember-exam`\n  * [#1450](https://github.com/ember-cli/ember-exam/pull/1450) Support cjs testem configs ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n\n#### :memo: Documentation\n* `ember-exam`\n  * [#1347](https://github.com/ember-cli/ember-exam/pull/1347) Update setup example for new qunit requirements ([@elwayman02](https://github.com/elwayman02))\n\n#### :house: Internal\n* `ember-exam`\n  * [#1449](https://github.com/ember-cli/ember-exam/pull/1449) Spit node-tests in to parallel jobs for easier retries (we have a very short testem timeout) ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n  * [#1451](https://github.com/ember-cli/ember-exam/pull/1451) Delete test duplication and use symlinks instead ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n  * [#1452](https://github.com/ember-cli/ember-exam/pull/1452) Remove extraneous command in CI workflow ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n  * [#1448](https://github.com/ember-cli/ember-exam/pull/1448) Split out try scenarios in to real apps for easier debugging ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n  * [#1443](https://github.com/ember-cli/ember-exam/pull/1443) Remove unused deps ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n  * [#1442](https://github.com/ember-cli/ember-exam/pull/1442) Get rid of custom resolver form an older era of the blueprint ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n  * [#1439](https://github.com/ember-cli/ember-exam/pull/1439) Update renovate-config (move to weekly) ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n  * [#1441](https://github.com/ember-cli/ember-exam/pull/1441) Set base for pages deployment ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n  * [#1440](https://github.com/ember-cli/ember-exam/pull/1440) Fix static files path for gh-pages deploy ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n  * [#1435](https://github.com/ember-cli/ember-exam/pull/1435) Strict dep management settings + re-roll lockfile, remove addon-docs, add vitepress ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n  * [#1434](https://github.com/ember-cli/ember-exam/pull/1434) Add prettier to lint, don't run lint with tests ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n  * [#1431](https://github.com/ember-cli/ember-exam/pull/1431) Upgrade eslint / prettier ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n\n#### Committers: 2\n- Jordan Hawker ([@elwayman02](https://github.com/elwayman02))\n- [@NullVoxPopuli](https://github.com/NullVoxPopuli)\n"
+}

package/README.md

@@ -39,7 +39,7 @@ The [documentation website](https://ember-cli.github.io/ember-exam/) contains ex
 Installation is as easy as running:
 
 ```bash
-$ ember install ember-exam
+$ npm install --save-dev ember-exam
 ```
 
 ## How To Use
@@ -72,12 +72,75 @@ To get the unique features of Ember Exam (described in-depth below), you will ne
 
 ```js
 // test-helper.js
-import start from 'ember-exam/test-support/start';
+- import { start, setupEmberOnerrorValidation } from 'ember-qunit';
++ import { setupEmberOnerrorValidation } from 'ember-qunit';
++ import { start } from 'ember-exam/test-support';
 
 // Options passed to `start` will be passed-through to ember-qunit
 start();
 ```
 
+## How to use with Vite
+
+All of the above applies, but we need to tell vite to build the app before telling ember/exam to run tests on that output.
+
+Update your test-helper.js or test-helper.ts, to have add the ember-exam `start` function:
+```diff
+  // ...
+  import { setApplication } from '@ember/test-helpers';
+  import { setup } from 'qunit-dom';
+- import { start as qunitStart, setupEmberOnerrorValidation } from 'ember-qunit';
++ import { setupEmberOnerrorValidation } from 'ember-qunit';
++ import { start as startEmberExam } from 'ember-exam/test-support';
+
+- export function start() {
++ export async function start({ availableModules }) {
+    setApplication(Application.create(config.APP));
+
+    setup(QUnit.assert);
+    setupEmberOnerrorValidation();
+
+-   qunitStart();
++   // Options passed to `start` will be passed-through to ember-qunit
++   await startEmberExam({ availableModules });
+  }
+```
+
+Then, update your tests/index.html to pass availableModules to start:
+```html
+<script type="module">
+  import { start } from './test-helper.js';
+
+  const availableModules = {
+    ...import.meta.glob('./application/**/*-test.{js,ts,gjs,gts}'),
+    ...import.meta.glob('./rendering/**/*-test.{js,ts,gjs,gts}'),
+    ...import.meta.glob('./unit/**/*-test.{js,ts,gjs,gts}'),
+  };
+
+	start({ availableModules });
+</script>
+```
+
+
+Testing development:
+```bash 
+NODE_ENV=development vite build --mode development
+ember exam --path dist --config-file ./testem.cjs
+```
+
+Testing production:
+```bash
+vite build --mode test
+ember exam --path dist --config-file ./testem.cjs
+```
+
+> [!NOTE]
+> Specifying the `--path` is important because otherwise ember-cli will try to build your vite app, and it will error. 
+
+> [!NOTE]
+> Specifying the `--config-path` is important because ember-cli (what backs ember-exam) doesn't know about cjs files. 
+
+
 ### Version < `3.0.0`
 
 

package/addon-test-support/-private/async-iterator.js

@@ -115,7 +115,6 @@ export default class AsyncIterator {
         );
         reject(err);
       } else {
-        // eslint-disable-next-line no-console
         console.error(
           `EmberExam: Promise timed out after ${this._timeout} s while waiting for response for ${this._request}. Closing browser to exit gracefully.`,
         );

package/addon-test-support/-private/ember-exam-test-loader.js

@@ -1,3 +1,4 @@
+import { assert } from '@ember/debug';
 import getUrlParams from './get-url-params';
 import splitTestModules from './split-test-modules';
 import weightTestModules from './weight-test-modules';
@@ -59,7 +60,7 @@ export default class EmberExamTestLoader extends TestLoader {
    *
    * @method loadModules
    */
-  loadModules() {
+  async loadModules({ availableModules } = {}) {
     const loadBalance = this._urlParams.get('loadBalance');
     const browserId = this._urlParams.get('browser');
     const modulePath = this._urlParams.get('modulePath');
@@ -75,7 +76,18 @@ export default class EmberExamTestLoader extends TestLoader {
       partitions = [partitions];
     }
 
-    super.loadModules();
+    if (!availableModules) {
+      super.loadModules();
+    } else {
+      assert(
+        `Available modules must be an object.`,
+        typeof availableModules === 'object',
+      );
+
+      this._availableModules = availableModules;
+      this._testModules = Object.keys(availableModules);
+    }
+
     this.setupModuleMetadataHandler();
 
     if (modulePath || filePath) {
@@ -93,6 +105,7 @@ export default class EmberExamTestLoader extends TestLoader {
         split,
         partitions,
       );
+
       this._testem.emit(
         'testem:set-modules-queue',
         this._testModules,
@@ -104,6 +117,15 @@ export default class EmberExamTestLoader extends TestLoader {
         split,
         partitions,
       );
+
+      if (this._availableModules) {
+        await this.loadAvailableModules();
+        return;
+      }
+
+      /**
+       * Legacy support
+       */
       this._testModules.forEach((moduleName) => {
         super.require(moduleName);
         super.unsee(moduleName);
@@ -111,18 +133,54 @@ export default class EmberExamTestLoader extends TestLoader {
     }
   }
 
+  /**
+   * availableModules are passed in from loadModules
+   * from loadEmberExam
+   * from start
+   */
+  async loadAvailableModules() {
+    if (this._availableModules) {
+      await Promise.all(
+        this._testModules.map(async (moduleName) => {
+          let loader = this._availableModules[moduleName];
+
+          /**
+           * If it's not a function, it's already loaded
+           */
+          if (typeof loader === 'function') {
+            await loader();
+          }
+        }),
+      );
+    }
+  }
+
   /**
    * Allow loading one module at a time.
    *
    * @method loadIndividualModule
    * @param {string} moduleName
    */
-  loadIndividualModule(moduleName) {
+  async loadIndividualModule(moduleName) {
     if (moduleName === undefined) {
       throw new Error(
         'Failed to load a test module. `moduleName` is undefined in `loadIndividualModule`.',
       );
     }
+
+    if (this._availableModules) {
+      let loader = this._availableModules[moduleName];
+
+      /**
+       * If it's not a function, it's already loaded
+       */
+      if (typeof loader === 'function') {
+        await loader();
+      }
+
+      return;
+    }
+
     super.require(moduleName);
     super.unsee(moduleName);
   }
@@ -168,10 +226,10 @@ export default class EmberExamTestLoader extends TestLoader {
 
       return nextModuleAsyncIterator
         .next()
-        .then((response) => {
+        .then(async (response) => {
           if (!response.done) {
             const moduleName = response.value;
-            this.loadIndividualModule(moduleName);
+            await this.loadIndividualModule(moduleName);
 
             // if no tests were added, request the next module
             if (this._qunit.config.queue.length === 0) {

package/addon-test-support/index.js

@@ -0,0 +1 @@
+export { default as start } from './start';

package/addon-test-support/load.js

@@ -11,7 +11,6 @@ let loaded = false;
  */
 export default function loadEmberExam() {
   if (loaded) {
-    // eslint-disable-next-line no-console
     console.warn('Attempted to load Ember Exam more than once.');
     return;
   }

package/addon-test-support/start.js

@@ -6,15 +6,16 @@ import { start as qunitStart } from 'ember-qunit';
  *
  * @function loadTests
  * @param {*} testLoader
+ * @param {*} loaderOptions
  */
-function loadTests(testLoader) {
+async function loadTests(testLoader, loaderOptions = {}) {
   if (testLoader === undefined) {
     throw new Error(
       'A testLoader instance has not been created. You must call `loadEmberExam()` before calling `loadTest()`.',
     );
   }
 
-  testLoader.loadModules();
+  await testLoader.loadModules(loaderOptions);
 }
 
 /**
@@ -24,11 +25,13 @@ function loadTests(testLoader) {
  * @function start
  * @param {*} qunitOptions
  */
-export default function start(qunitOptions) {
-  const modifiedOptions = qunitOptions || Object.create(null);
+export default async function start(qunitOptions = {}) {
+  const { availableModules, ...modifiedOptions } =
+    qunitOptions || Object.create(null);
+
   modifiedOptions.loadTests = false;
 
   const testLoader = loadEmberExam();
-  loadTests(testLoader);
+  await loadTests(testLoader, { availableModules });
   qunitStart(modifiedOptions);
 }

package/docs-app/.vitepress/config.mts

@@ -0,0 +1,54 @@
+import { defineConfig } from 'vitepress'
+
+// https://vitepress.dev/reference/site-config
+export default defineConfig({
+  title: "ember-exam",
+  description: "Run your tests with randomization, splitting, and parallelization for beautiful tests.",
+  base: '/ember-exam/',
+  markdown: {
+    // theme: {
+    //   ...dark,
+    //   settings: [
+    //     {
+    //       scope: 'comment',
+    //       settings: {
+    //         // 'foreground': 'rgb(200, 200, 200)'
+    //       }
+    //     },
+    //   ]
+    // },
+  },
+  themeConfig: {
+    // https://vitepress.dev/reference/default-theme-config
+    nav: [
+      { text: 'Home', link: '/' },
+      // { text: 'Examples', link: '/markdown-examples' }
+    ],
+
+    sidebar: [
+      {
+        text: 'Options',
+        items: [
+          { text: 'Randomization', link: '/randomization' },
+          { text: 'Randomization Iterator', link: '/randomization-iterator' },
+          { text: 'Generating Module Metadata For Test Execution', link: '/module-metadata' },
+          { text: 'Splitting', link: '/splitting' },
+          { text: 'Split Test Parallelization', link: '/split-parallel' },
+          { text: 'Filtering', link: '/filtering' },
+          { text: 'Test Load Balancing', link: '/load-balancing' },
+        ]
+      },
+      {
+        text: 'Advanced Configuration',
+        items: [
+          { text: 'Ember Try & CI Integration', link: '/ember-try-and-ci' },
+          { text: 'Test Suite Segmentation', link: '/test-suite-segmentation' },
+        ]
+      }
+    ],
+
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/ember-cli/ember-exam' }
+    ]
+  }
+})

package/docs-app/.vitepress/theme/index.ts

@@ -0,0 +1,17 @@
+// https://vitepress.dev/guide/custom-theme
+import { h } from 'vue'
+import type { Theme } from 'vitepress'
+import DefaultTheme from 'vitepress/theme'
+import './style.css'
+
+export default {
+  extends: DefaultTheme,
+  Layout: () => {
+    return h(DefaultTheme.Layout, null, {
+      // https://vitepress.dev/guide/extending-default-theme#layout-slots
+    })
+  },
+  enhanceApp({ app, router, siteData }) {
+    // ...
+  }
+} satisfies Theme

package/docs-app/.vitepress/theme/style.css

@@ -0,0 +1,170 @@
+/**
+ * Customize default theme styling by overriding CSS variables:
+ * https://github.com/vuejs/vitepress/blob/main/src/client/theme-default/styles/vars.css
+ */
+
+/**
+ * Colors
+ *
+ * Each colors have exact same color scale system with 3 levels of solid
+ * colors with different brightness, and 1 soft color.
+ *
+ * - `XXX-1`: The most solid color used mainly for colored text. It must
+ *   satisfy the contrast ratio against when used on top of `XXX-soft`.
+ *
+ * - `XXX-2`: The color used mainly for hover state of the button.
+ *
+ * - `XXX-3`: The color for solid background, such as bg color of the button.
+ *   It must satisfy the contrast ratio with pure white (#ffffff) text on
+ *   top of it.
+ *
+ * - `XXX-soft`: The color used for subtle background such as custom container
+ *   or badges. It must satisfy the contrast ratio when putting `XXX-1` colors
+ *   on top of it.
+ *
+ *   The soft color must be semi transparent alpha channel. This is crucial
+ *   because it allows adding multiple "soft" colors on top of each other
+ *   to create a accent, such as when having inline code block inside
+ *   custom containers.
+ *
+ * - `default`: The color used purely for subtle indication without any
+ *   special meanings attached to it such as bg color for menu hover state.
+ *
+ * - `brand`: Used for primary brand colors, such as link text, button with
+ *   brand theme, etc.
+ *
+ * - `tip`: Used to indicate useful information. The default theme uses the
+ *   brand color for this by default.
+ *
+ * - `warning`: Used to indicate warning to the users. Used in custom
+ *   container, badges, etc.
+ *
+ * - `danger`: Used to show error, or dangerous message to the users. Used
+ *   in custom container, badges, etc.
+ * -------------------------------------------------------------------------- */
+
+:root {
+  --vp-c-default-1: var(--vp-c-gray-1);
+  --vp-c-default-2: var(--vp-c-gray-2);
+  --vp-c-default-3: var(--vp-c-gray-3);
+  --vp-c-default-soft: var(--vp-c-gray-soft);
+
+  --vp-c-brand-1: var(--vp-c-indigo-1);
+  --vp-c-brand-2: var(--vp-c-indigo-2);
+  --vp-c-brand-3: var(--vp-c-indigo-3);
+  --vp-c-brand-soft: var(--vp-c-indigo-soft);
+
+  --vp-c-tip-1: var(--vp-c-brand-1);
+  --vp-c-tip-2: var(--vp-c-brand-2);
+  --vp-c-tip-3: var(--vp-c-brand-3);
+  --vp-c-tip-soft: var(--vp-c-brand-soft);
+
+  --vp-c-warning-1: var(--vp-c-yellow-1);
+  --vp-c-warning-2: var(--vp-c-yellow-2);
+  --vp-c-warning-3: var(--vp-c-yellow-3);
+  --vp-c-warning-soft: var(--vp-c-yellow-soft);
+
+  --vp-c-danger-1: var(--vp-c-red-1);
+  --vp-c-danger-2: var(--vp-c-red-2);
+  --vp-c-danger-3: var(--vp-c-red-3);
+  --vp-c-danger-soft: var(--vp-c-red-soft);
+}
+
+/**
+ * Component: Button
+ * -------------------------------------------------------------------------- */
+
+:root {
+  --vp-button-brand-border: transparent;
+  --vp-button-brand-text: var(--vp-c-white);
+  --vp-button-brand-bg: var(--vp-c-brand-3);
+  --vp-button-brand-hover-border: transparent;
+  --vp-button-brand-hover-text: var(--vp-c-white);
+  --vp-button-brand-hover-bg: var(--vp-c-brand-2);
+  --vp-button-brand-active-border: transparent;
+  --vp-button-brand-active-text: var(--vp-c-white);
+  --vp-button-brand-active-bg: var(--vp-c-brand-1);
+}
+
+/**
+ * Component: Home
+ * -------------------------------------------------------------------------- */
+
+:root {
+  --vp-home-hero-name-color: transparent;
+  --vp-home-hero-name-background: -webkit-linear-gradient(
+    120deg,
+    #bd34fe 30%,
+    #41d1ff
+  );
+
+  --vp-home-hero-image-background-image: linear-gradient(
+    -45deg,
+    #bd34fe 50%,
+    #47caff 50%
+  );
+  --vp-home-hero-image-filter: blur(44px);
+}
+
+@media (min-width: 640px) {
+  :root {
+    --vp-home-hero-image-filter: blur(56px);
+  }
+}
+
+@media (min-width: 960px) {
+  :root {
+    --vp-home-hero-image-filter: blur(68px);
+  }
+}
+
+/**
+ * Component: Custom Block
+ * -------------------------------------------------------------------------- */
+
+:root {
+  --vp-custom-block-tip-border: transparent;
+  --vp-custom-block-tip-text: var(--vp-c-text-1);
+  --vp-custom-block-tip-bg: var(--vp-c-brand-soft);
+  --vp-custom-block-tip-code-bg: var(--vp-c-brand-soft);
+}
+
+/**
+ * Component: Algolia
+ * -------------------------------------------------------------------------- */
+
+.DocSearch {
+  --docsearch-primary-color: var(--vp-c-brand-1) !important;
+}
+
+
+
+.badges {
+  > p {
+    display: flex;
+    gap: 1rem;
+    justify-content: center;
+    align-items: center;
+  }
+  img, a {
+    display: inline-flex;
+  }
+
+}
+
+/**
+* Contrast fixes
+*/
+html {
+  --vp-c-text-2: rgb(40, 40, 40);
+}
+html.dark {
+  --vp-c-text-2: rgb(200, 200, 200);
+}
+
+html [class*='language-'] > span.lang {
+  --vp-code-lang-color: rgb(40,40,40);
+}
+html.dark [class*='language-'] > span.lang {
+  --vp-code-lang-color: rgb(200,200,200);
+}

package/docs-app/ember-try-and-ci.md

@@ -0,0 +1,38 @@
+### Ember Try & CI Integration
+
+Integrating ember-exam with [ember-try](https://github.com/ember-cli/ember-try) is remarkably easy. Define a [`command` in your `ember-try.js` config](https://github.com/ember-cli/ember-try#configuration-files) that leverages the `exam` command:
+
+```js
+// config/ember-try.js
+module.exports = {
+  command: 'ember exam --split 3 --parallel',
+  // ...
+};
+```
+
+Using [environmental variables](https://nodejs.org/api/process.html#process_process_env) gives you flexibility in how you run your tests. For instance, you could distribute your tests across processes instead of parallelizing them by specifying a `PARTITION` variable in your process environment and then consuming it like so:
+
+```js
+module.exports = {
+  command: 'ember exam --split 20 --partition ' + process.env.PARTITION,
+  // ...
+};
+```
+
+If you are working with [Travis CI](https://travis-ci.org/) then you can also easily set up seeded-random runs based on PR numbers. Similar to the following:
+
+```js
+const command = ['ember', 'exam', '--random'];
+const pr = process.env.TRAVIS_PULL_REQUEST;
+
+if (pr) {
+  command.push(pr);
+}
+
+module.exports = {
+  command: command.join(' '),
+  // ...
+};
+```
+
+You can refer to [Travis' default environment variables](https://docs.travis-ci.com/user/environment-variables/#Default-Environment-Variables) to see what else you could possibly leverage for your test setup.

package/docs-app/filtering.md

@@ -0,0 +1,47 @@
+### Filtering
+
+Ember Exam provides options to filter test suites by two types - module path and test file path.
+
+```bash
+$ ember exam --module-path=<module-path>
+```
+
+#### For Vite Apps
+
+The `file-path` option allows you to filter modules by the given relative path that is generated from `import.meta.glob(...)` in your `tests/index.html`.
+
+```bash
+# This will run tests that are defined in `/my-application/tests/unit/my-test.js`
+$ ember exam --file-path='/my-application/tests/unit/my-test.js'
+
+# This will run all test files that are under `/my-application/tests/unit/`
+$ ember exam --file-path='/my-application/tests/unit/*.js'
+```
+
+
+#### For non-Vite Apps
+
+
+The `module-path` option allows you to filter module paths by a given value. Module paths are mapped by test files and they are generated during `ember build`. After the build, `tests.js` file is created and it resides under [build-directory]/assets. 
+
+The file is combined of all tests in an application and it has a form of `define("<module-path>", others..`.
+
+The value for `module-path` can have either string or regular expression, for instance:
+
+```bash
+# When module path value is string. This will run all modules which match with the passed value
+$ ember exam --module-path='dummy/tests/helpers/module-for-acceptance'
+
+# When module path value is regex. This will run all modules which have `dummy` in it
+$ ember exam --module-path='!/dummy/'
+```
+
+The `file-path` option is to filter tests by *test file path*. The test file path is a location of the test file in a file system. You can specify `file-path` to a location of specific test file path or you can use wildcards in paths to target multiple test files.
+
+```bash
+# This will run tests that are defined in `/my-application/tests/unit/my-test.js`
+$ ember exam --file-path='/my-application/tests/unit/my-test.js'
+
+# This will run all test files that are under `/my-application/tests/unit/`
+$ ember exam --file-path='/my-application/tests/unit/*.js'
+```

package/docs-app/index.md

@@ -0,0 +1,46 @@
+---
+# https://vitepress.dev/reference/default-theme-home-page
+layout: home
+
+hero:
+  name: "ember-exam"
+  # text: "Run your tests with randomization, splitting, and parallelization for beautiful tests."
+  tagline: "Run your tests with randomization, splitting, and parallelization for beautiful tests."
+  actions:
+    - theme: brand
+      text: Quickstart 
+      link: /quickstart
+    # - theme: alt
+    #   text: API Examples
+    #   link: /api-examples
+
+features:
+  - title: Partitioning 
+    details: Specify the number of parallel browser instances to use to speed up your test suite. 
+  - title: Load Balancing 
+    details: Balance tests to maximize the effectivess of parallel browsers that would otherwise completely quickly due to happenstance of being given quickly running tests.
+  - title: Randomization 
+    details: Find and eliminate brittle tests by changing the order of tests within the test suite. 
+  - title: Replay 
+    details: Record and replay test execution order for reliably reproducing potentially flaky behaviors. 
+---
+
+
+<span class="badges">
+
+![Build Status](https://github.com/ember-cli/ember-exam/actions/workflows/ci.yml/badge.svg?event=push)
+[![NPM Version](https://badge.fury.io/js/ember-exam.svg)][npm]
+[![Ember Observer Score](https://emberobserver.com/badges/ember-exam.svg)][score]
+
+</span>
+
+[npm]: https://npmjs.com/package/ember-exam
+[score]: https://emberobserver.com/addons/ember-exam
+
+Ember Exam is an addon to allow you more control over how you run your tests when used in conjunction with [ember-qunit](https://github.com/emberjs/ember-qunit). It provides the ability to randomize, split, parallelize, and load-balance your test suite by adding a more robust CLI command.
+
+It started as a way to help reduce flaky tests and encourage healthy test driven development. 
+
+[![Introduction to Ember Exam](https://cloud.githubusercontent.com/assets/2922250/22800360/157ad67c-eed7-11e6-8d33-d2c59238c7f1.png)](https://embermap.com/video/ember-exam)
+
+