cheesecake-ui-tests's Introduction

cheescake-ui-tests

UI tests for Pantheon v2 using Selenium + Python.

Pre-requisites

python3
google chrome (not chromium)

Setup

Install and create virtualenv (This step should be executed only when setting up the project for the first time)

Install virtualenv

python3 -m pip install --user virtualenv

Create virtualenv

python3 -m venv env

Activate the virtual environment:

$ source env/bin/activate

Install dependencies for setting up tests:

$ pip install -r requirements.txt

Set Python Path to the current directory:

export PYTHONPATH = "<path to your current directory>"

To Check if PYTHONPATH is set correctly to the current directory:

echo $PYTHONPATH

PYTHONPATH should not be blank and should be your current directory.

Execute tests:

Make the changes in the config file for actual values.

cp config.ini.sample config.ini

Make the appropriate changes to base URL,username and password fields in config.ini file. You can reach out to any of the contributors for the actual values to be used. By default, the tests will run in headless mode. If you choose to run otherwise, change the value to "no".

To run the test against QA env, set the environment variable appropriately. export PANTHEON_ENV=qa Acceptable values for PANTHEON_ENV variable are dev/qa/stage.
To execute the tests: lcc run
To view the reports on console after you ran the tests: lcc report
To view the report in browser: firefox report/report.html
User can choose to run the tests for different environments listed in config.ini file by passing the 'env' and 'base_url' parameter in 'base.config_reader(, <base_url>)' method present inside browser_util.py file
To run a single test: lcc run <test_file_name> e.g. lcc run login_test