Automated tests for the MozTrap web application. The following contributors have submitted pull requests to moztrap-tests:
https://github.com/mozilla/moztrap-tests/contributors
You will need a version of the Java Runtime Environment installed
Before you will be able to run these tests you will need to have Python 2.6 installed.
note
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 moztrap-tests-env; source moztrap-tests-env/bin/activate) to
create a clean "virtual environment" for just this project. Then you can pip install -r requiremenst/mozwebqa.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
sudo pip install -r requirements/mozwebqa.txt
note
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.5.0.jar'
To start the Selenium server run the following command:
java -jar ~/Downloads/selenium-server-standalone-2.5.0.jar
Change the path/name to the downloaded Selenium server file.
To run tests locally it's a simple case of calling py.test from the moztrap-tests directory. You should specify the following argument for Selenium RC: --api=rc
The base URL should be a valid instance of MozTrap: the staging env is currently https://moztrap.allizom.org
py.test --api=rc --baseurl=https://moztrap.allizom.org
For other possible options, type py.test --help .
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:
- 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/.