README_Robot.md

Back to main README

Running tests with Robot framework

This is the example project for the Robot Framework tutorial. It shows how to start automating visual tests with Applitools Eyes and Robot Framework.

It uses:

• Robot Framework as the core test framework
• Python as the programming platform underneath Robot Framework
• Selenium WebDriver for browser automation underneath Robot Framework
• Google Chrome as the local browser for testing
• pip for dependency management
• Applitools Eyes for visual testing

It can also run tests with:

• Applitools Ultrafast Grid for cross-browser execution

To run this example project, you'll need:

1. An Applitools account, which you can register for free
2. Python 3 version 3.6 or higher
3. A good editor with Robot Framework support like Visual Studio Code
4. An up-to-date version of Google Chrome
5. A corresponding version of ChromeDriver

Install dependencies

python3 -m pip install -r src/test/robot/requirements.txt

The main test case spec is acme_bank.robot. By default, the project will run tests with Ultrafast Grid. You can control how Applitools runs by changing the EyesLibrary runner setting.

To execute tests, set the APPLITOOLS_API_KEY environment variable to your account's API key, and then run:

Run tests in local browser

APPLITOOLS_LOG_DIR=reports/robot/applitools-logs robot --outputdir reports/robot src/test/robot/acme_bank_web.robot

Run tests in local browser with Applitools Ultrafast Grid

APPLITOOLS_LOG_DIR=reports/robot/applitools-logs robot --outputdir reports/robot src/test/robot/acme_bank_ufg.robot

Run tests in Applitools Execution Cloud with Self Healing

APPLITOOLS_LOG_DIR=reports/robot-self-healing/applitools-logs robot --outputdir reports/robot-self-healing src/test/robot/acme_bank_execution_cloud_self_healing.robot

For full instructions on running this project, take our Robot Framework tutorial!

Back to main README