qavalry v1.0.0

Qavalry

Qavalry (Qavalry) is a framework combining Cucumber(.js), WebdriverIO and Selenium for setting up a quick and easy testing environment.

Installation

You can install Qavalry using NPM:

npm install valtech-testing-framework

Using a commandline tool you first need to setup the required output folders. You can simply do this by running the following command:

npx vtf setup

After the setup is completed you can run Qavalry using the command below.

npx vtf run [--options options.js] [--config config.js]

Configuration

When running the vtf run command it is mandatory to specify an options file. The following code shows an example of what your options.js could look like:

// options.js
module.exports.config = {
    baseUrl: 'https://github.com',
    specs: ['./features/**/*.feature'],
    cucumberOpts: {
        tagExpression: '@tag1'
    }
}

Optionally you can also specify an config file, which will be used to override the default config file from WebdriverIO. The following code shows an example of what the config.js would look like if you wanted to run the tests in Firefox:

// config.js
module.exports.config = {
    capabilities: [{
        browserName: 'firefox'
    }]
}

More about the WebdriverIO configuration can be found here.

Options.js

baseUrl

Base URL used for the tests being started.

Type: String Default: null Example: https://github.com/

specs

A list of path queries of the Cucumber tests which should be run.

Type: String[] Default: [] Example: ['./features/**/*.feature']

logOutput

A list of path queries of the Cucumber tests which should be run.

Type: String[] Default: [] Example: ['./features/**/*.feature']

Local Development

Build

Run the following command in the source repository:

npm link

This flow is still not optimal. Go to an empty folder and run the following commands:

npx vtf setup
npm install semver
npm install babel-preset-env

Lastly, copy the \dist\jsonReport.js file to <empty folder>\node_modules\valtech-testing-framework\dist\jsonReport.js

Publish

Run the following command in the source repository:

npm run build
npm run prepublish
npm login
npm publish