Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
87 lines (56 sloc) 2.95 KB


Automated tests for the <PROJECT_NAME> web application.

Running Tests


You will need a version of the Java Runtime Environment installed


Before you will be able to run these tests, you'll need to have Python 2.6 installed.


The below instructions will install the required Python libraries into your global Python installation. If you work on multiple Python projects that might end up needing different versions of the same libraries, you might want to follow sudo easy_install pip with sudo pip install virtualenv, and then create and activate a virtualenv (e.g. virtualenv <PROJECT_NAME>-tests-env; source <PROJECT_NAME>-tests-env/bin/activate) to create a clean "virtual environment" for just this project. Then you can pip install -r requiremenst/requirements.txt in your virtual environment without needing to use sudo.

If you don't mind installing globally, just run:

sudo easy_install pip

followed by:



if you are running on Debian or Ubuntu, you may need to do:

sudo apt-get install python-setuptools

to install the required Python libraries.


Once this is all set up you will need to download and start a Selenium server. You can download the latest Selenium server from here. The filename will be something like 'selenium-server-standalone-x.x.jar (where x.x is current shipping version)'

To start the Selenium server run the following command:

java -jar ~/Downloads/selenium-server-standalone-x.x.jar (where x.x is current shipping version)

Change the path/name to the downloaded Selenium server file.

Once the above prerequisites have been met, you can run the tests using the following command:

py.test --api=<SELENIUM_API> --baseurl=<BASE_URL> --browser=*firefox

For other possible options, type py.test --help.

Writing Tests

If you want to get involved and add more tests, then there's just a few things we'd like to ask you to do:

  1. Use the template files for all new tests and page objects
  2. Follow our simple style guide
  3. Fork this project with your own GitHub account
  4. Make sure all tests are passing, and submit a pull request with your changes


This software is licensed under the MPL 2.0:

This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at