Selenium Grid Testing

Using Selenium Grid and Pytest to automate distributed integrated testing

Prerequisites

• Git
• Java
• Python 2.7 (on hub machine)

On Windows: remember to add environment variables python (C:\Python2.7\python.exe) and JVA_HOME (C:\Program Files\Java\jre-1.X.X\bin)

Installing on the Hub

Clone this repository

source scripts/install.sh

Alternatively, you can manually install using the following steps:

Install Python 2.7 and pip

This developer is too lazy to compile SeleniumBase with Python3 - will use 2.7 until someone else updates

Install poetry

curl -sSL https://raw.githubusercontent.com/sdispater/poetry/master/get-poetry.py | python

Add Poetry to your PATH in shell config (~/.bashrc, ~/.zshrc)

export PATH=$PATH:$HOME/.poetry/bin

You may need to source the file for changes to take effect.

Install dependencies with Poetry

In the root directory of this project, run:

poetry install

Install resources

The selenium standalone driver and webdrivers are included in the resources directory.

Copy the webdrivers into a $PATH directory.

• Mac:

  sudo cp resources/mac/chromedriver /usr/local/bin/chromedriver
  

• Windows:

  Copy the drivers under resources/windows into C:\Windows

Installing on a Node

Clone this repository. Have Java ()

Start a hub or node

To start a hub, execute

java -jar resources/selenium-server-standalone-3.141.59.jar -role hub -hubConfig scripts/config/hubconfig.json

To start a node, edit scripts/config/node1config.json, and replace "hub": "http://localhost:4444", with your hub IP address. Edit capabilities if necessary. Execute

java -jar resources/selenium-server-standalone-3.141.59.jar -role node -nodeConfig scripts/config/node1config.json

Running the tests

Run tests on the hub machine in another terminal window. DO NOT run this on node machines.

The script below runs all tests and cleans up python cache code

source scripts/run-test.sh

You can also run tests from the command line. To enter a virtualenv:

poetry shell

Run tests:

pytest

Where it runs all tests on Chrome and Firefox. --addconfig is a required argument that accepts a string with the format platformName:browserName1,browserName2,browserName3 with no spaces in between.

It is set automatically in pytest.ini but can be subject to change.

pytest-xdist is also installed and can be run or configured. To run tests concurrently on 4 cores:

pytest -n 4

Node Configuration

See Selenium - Desired Capabilities

TODO

• Run tests concurrently
• Optimize configuration files and add scripts
• Dockerfile for scaling, see docker-selenium