The testingbot-cypress-cli is command-line interface (CLI) which
allows you to run Cypress tests on TestingBot. TestingBot provides a
large grid of browsers and devices to run both manual and automated tests.
To get started, simply install the CLI and configure it to use your Cypress project:
You can easily install the CLI via npm or yarn:
$ npm install -g testingbot-cypress-cli
To use the CLI in combination with TestingBot Tunnel, you will need to have JDK8 (or higher) installed. TestingBot Tunnel is used to connect TestingBot's browser grid with your local computer or network.
Once the CLI is installed, you'll need to point it to a configuration file. The configuration file will point the CLI to the Cypress project and will supply the TestingBot credentials.
To set up a new configuration file (testingbot.json), simply run this command:
$ testingbot-cypress init
This will create a testingbot.json file. Please add the key and secret you obtained from the TestingBot member dashboard in this file.
Next, please supply cypress_proj_dir with is the path to the folder that contains the Cypress configuration file.
As an example, you can use the Cypress Kitchen Sink Example.
Now you're ready to start running your Cypress tests on TestingBot. To start the tests, please run:
$ testingbot-cypress run
Once you've started this command, the tests will start to appear in the TestingBot Dashboard.
Please see the TestingBot Cypress Documentation for more documentation on how to use this CLI.
If you prefer to keep your TestingBot credentials in environment variables, you can use TESTINGBOT_KEY and TESTINGBOT_SECRET environment variables.
If you are running this CLI in a CI/CD like Jenkins or TeamCity, you can set the
environment variable TESTINGBOT_CI=1. The CLI will output the TestingBotSessionID, in combination
with a TestingBot CI plugin you will be able to view the test's details from inside your CI.
If you need help, please reach out to us via [email protected] or the public TestingBot Slack: https://testingbot.com/support
This project is released under MIT License. Please see the LICENSE.md for more details.