Skip to main content

Test Runner

Local​

Tests can be run at no cost using the local test runner. This is available as an NPM package. See the installation guide for full details. The distribution can be found on (Github)[https://github.com/testabulous/testabulous-runner].

The test runner can also be run as a Docker image. The image can also be customised and built using the Dockerfile.

Test scripts need to be converted to test pseudo-code. Tests are automatically converted on execution. Running testabulous cache will initiate this process without running the tests. Once converted the tests are cached locally. The conversion process incurs a cost (see pricing) however once converted, the results are cached, both locally and on the Testabulous platform, and no further cost is incurred (unless the test file changes). Running testabulous cache with the --force option will force the conversion process and overwrite any previously cached version. This does incur a cost.

See the configuration file reference for more details.

Basic usage​

  _____         _        _           _
 |_   _|__  ___| |_ __ _| |__  _   _| | ___  _   _ ___
   | |/ _ \/ __| __/ _` | '_ \| | | | |/ _ \| | | / __|
   | |  __/\__ \ || (_| | |_) | |_| | | (_) | |_| \__ \
   |_|\___||___/\__\__,_|_.__/ \__,_|_|\___/ \__,_|___/

Usage: index [options] [command]

Testabulous E2E Testing Framework

Options:
  -V, --version              output the version number
  -c, --config-file <value>  Local config file [./testabulous.config.json]
  -e, --env-file <value>     File to load environment variables from
  -p, --project-id <value>   Project ID
  -k, --api-key <value>      API key
  -r, --root-dir <value>     Test root directory [./testabulous]
  -h, --help                 display help for command

Commands:
  init                       Initialise a new testabulous project
  cache [options]            Parse and cache test files
  test [options]             Start testabulous test runner
  help [command]             display help for command

Cache usage​

Usage: index cache [options]

Parse and cache test files

Options:
  -f, --file <value>  Specific test file to cache
  -F, --force         Force re-cache of all test files
  -h, --help          display help for command

Test usage​

Usage: index test [options]

Start testabulous test runner

Options:
  -f, --file <value>  Specific test file to execute
  -t, --test <value>  Specific test to execute
  -h, --help          display help for command

Remote​