Tests for Mozilla's Treeherder
This repository contains tests for Mozilla's Treeherder.
Getting involved
We love working with contributors to fill out the test coverage for Treeherder, but it does require a few skills. By contributing to our test suite you will have an opportunity to learn and/or improve your skills with Python, Selenium WebDriver, GitHub, virtual environments, the Page Object Model, and more.
For some resources for learning about these technologies, take a look at our documentation on running Web QA automated tests.
All of these awesome contributors have opened pull requests against this repository.
Questions are always welcome
While we take pains to keep our documentation updated, the best source of information is those of us who work on the project. Don't be afraid to join us in irc.mozilla.org #fx-test to ask questions about our tests. We also have a mailing list available that you are welcome to join and post to.
How to run the tests locally
Clone the repository
If you have cloned this project already then you can skip this, otherwise you'll need to clone this repo using Git. If you do not know how to clone a GitHub repository, check out this help page from GitHub.
If you think you would like to contribute to the tests by writing or maintaining them in the future, it would be a good idea to create a fork of this repository first, and then clone that. GitHub also has great documentation for forking a repository.
Run the tests
- Install the Python packages that are needed to run our tests.
- Install Tox.
Tests are run using the command line. Type tox
.
To run against a different environment, pass in a value for --base-url
, like
so:
$ tox -e tests -- --base-url https://treeherder.mozilla.org
The pytest plugin that we use for running tests has a number of advanced command line options available. The full documentation for the plugin can be found here.