webdriver-test-tools 0.15.0

Tools for using Selenium WebDriver with Python unit testing

Utilities for writing front-end test suites using Selenium WebDriver and python unit tests.

Contents

• Overview

• Prerequisites

  • Python

  • Drivers

    • Required

    • Platform-Specific (Optional)

  • Libraries

• Installation

• Command Line Usage

Overview

This project aims to reduce the amount of time and additional code required to automate front-end functional testing by providing utilities and conventions for building test suites.

This project uses Selenium WebDriver for automated browser actions and the python unittest library for the test framework.

Prerequisites

Python

• python 3+

• pip

Drivers

Required

The following web drivers are required:

• geckodriver (FireFox)

• chromedriver (Google Chrome)

On MacOS, both drivers can be installed using Homebrew:

brew install geckodriver chromedriver

Platform-Specific (Optional)

The project currently supports the following platform-specific drivers as well. These are not required, but can be useful for adding tests for platform-specific drivers:

• Safari

• Internet Explorer

• Edge

These need to be enabled in <test_package>/config/browser.py by uncommenting the corresponding line in BrowserConfig.BROWSER_TEST_CLASSES.

For information on usage and considerations, see the additional browsers documentation.

Libraries

The framework uses Selenium WebDriver and python unittest libraries, documentation for which can be found below:

• Selenium with Python

• Python unit testing framework

Installation

After installing the above prerequisites, run:

pip install webdriver-test-tools

Note: Command may be pip3 instead of pip depending on the system

Command Line Usage

For info on command line arguments:

webdriver_test_tools --help

To initialize a new test project in the current directory:

webdriver_test_tools --init

This will generate a new test package with template files and project directories. For information and examples, see the test project documentation.