Automated tests for the Socorro web application.
You will need a version of the Java Runtime Environment installed
Before you're able to run these tests, you'll need to have Python 2.6 installed.
sudo pip install -r requirements.txt
If you are running on Ubuntu/Debian, you will need to first 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-2.x.x.jar', where "2.x.x" is the latest shipping version #.
To start the Selenium server run the following command:
java -jar ~/Downloads/selenium-server-standalone-2.x.x.jar
Change the path/name to the downloaded Selenium-server file.
Running tests locally
To run tests locally, simply call py.test from the Socorro-tests directory
You should specify the following argument for Selenium RC: --api=rc
The base URL should be a valid instance of crash-stats-dev: --baseurl=http://crash-stats-dev.allizom.org
py.test --api=rc --baseurl=http://example.com
For other instructions, type py.test --help.
If you want to get involved and add more tests, then there are just a few things we'd like to ask that you do:
- Use the template files for all new tests and page objects
- Follow our simple style guide
- Fork this project with your own GitHub account
- 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 http://mozilla.org/MPL/2.0/.