Nightwatch-cucumber GUI

A simple, browser based, GUI (Graphical User Interface) to run test cases written in Gherkin to be run with Nightwatch.js thanks to nightwatch-cucumber.

Usage

Install the module from the npm registry either globally:

npm install -g nightwatch-gui

or as a dependecy of your project:

npm install --save-dev nightwatch-gui

Then in the main folder of your nightwatch-cucumber project run:

nightwatch-gui

The module assumes the standard nightwatch-cucumber foldering, where the main project folder contains both the nightwatch.conf.js file and the features folder containing the test cases written in Gherkin.

If your setup is different, you can customise all the paths in the config key in the package.json file:

"config": {
    "featuresParentFolder": "", //default current folder
    "featuresFolderName": "", //features 'features'
    "nightwatchConfigJsFolder": "", //default current folder
    "excludeFolders": "['step_definitions']",
  }

or, if you don't want to mess up with the package.json file (for instance because you have installed the module globally), or if you want to manage these settings on a per project basis you can create the file nightwatch-gui-config.json with the same content of the config key seen above:

{
    "featuresParentFolder": "", //default current folder
    "featuresFolderName": "", //features 'features'
    "nightwatchConfigJsFolder": "", //default current folder
    "excludeFolders": "['step_definitions']"
}

How it works

It reads the nightwatch.config.js to get the enviroments defined, and it scrapes the "features" folder to get the features definitions. Then it displays both the environments and the features available on a web page where is possible to select the features to run by a combination of tags, folders and files. Finally it runs nightwatch-cucumber with the selected options.

Issues

For any issues: https://github.com/fbedussi/nightwatchGui/issues