testarmada-magellan-nightwatch-plugin/README.md

# magellan-nightwatch-plugin

A magellan plugin that connects [magellan](https://github.com/TestArmada/magellan) and [nightwatch](http://nightwatchjs.org/). 

## Usage

 1. Add following code to your `package.json`. 

    ```
    "testarmada-magellan-nightwatch-plugin": "^5.0.0"
    ```

 2. Add following code to your `magellan.json` (optional)

    ```
    "framework": "testarmada-magellan-nightwatch-plugin"
    ```

Please notice that the step 2 is optional, magellan will try to load this plugin by default. It won't hurt if the plugin is out found. However, it is still recommended to add it to your `magellan.json`

## What does it do

This plugin connects magellan and nightwatch by

```
1. passing down magellan test filters (by tags, groups and/or tests) to nightwatch for test case selection.
2. modifying necessary ports so that magellan can run test in parallel (multi-worker) mode.
3. fixing some easy-to-forget configurations in `nightwatch.json` if there is any, to run test in parallel (multi-worker) mode.
4. passing down node env/configurations for child process spawn purpose.
```