README.md

Tests for addons.mozilla.org (AMO)

Thank you for checking out Mozilla's Addon-Tests test suite. This repository contains Selenium tests used to test the website addons.mozilla.org.

Getting involved

We love working with contributors to fill out the Selenium test coverage for Addon-Tests, 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, Virtualenv, 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][fx-test] to ask questions about our Selenium tests. We also have a [mailing list][mailing_list] available that you are welcome to join and post to.

How to run the tests locally

We maintain a detailed guide to running our automated tests which can be found on the MDN website. If you want to get started quickly, you can try following the steps in our quick-start instructions below:

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 instructions for forking a repository.

Create test variables files

API

Some tests use the Add-ons Server API to create necessary test data in the application. For this to work you will need to obtain a key and a secret from the API Credentials Management Page and place then in a JSON file with the following format:

{
  "api": {
    "addons.allizom.org": {
      "jwt_issuer": "",
      "jwt_secret": ""
    },
    "addons-dev.allizom.org": {
      "jwt_issuer": "",
      "jwt_secret": ""
    }
  }
}

You will need an entry in this file for each environment you intend to use the API for. This file will then need to be referenced on the command line using the --variables option.

Tests that use the super-create endpoint require a user in the Accounts:SuperCreate group. Speak to a member of the add-ons or Web QA team to be added to this group.

#### PayPal Some of the tests in this repo need to log into PayPal. If you want to be able to run any of these tests, you will need to place your PayPal credentials in a JSON file with the following format:

{
  "paypal": {
    "email": "",
    "password": ""
  }
}

This file will then need to be referenced on the command line using the --variables option.

Run the tests

• Install Tox
• Run PYTEST_ADDOPTS="--variables=/path/to/variables.json" tox