mozilla-taskcluster-devicepool

This project enables the execution of Mozilla's Taskcluster tests on Android hardware devices via API integrations with various vendors.

Currently supported vendors are Bitbar and Lambdatest.

Installation

# Clone the repository
git clone https://github.com/bclary/mozilla-bitbar-devicepool.git
cd mozilla-bitbar-devicepool

# if needed, install poetry
#   - see https://python-poetry.org/docs/ for more options and info
curl -sSL https://install.python-poetry.org | python3 -

# install poetry shell plugin
poetry self add poetry-plugin-shell

# ensure poetry and plugins are up to date
poetry self update

# activate the virtual environment
poetry shell

# install dependencies (with dev deps)
poetry install --with=dev

Updates

# Update the repository
cd mozilla-bitbar-devicepool
git pull --rebase

# ensure poetry and plugins are up to date
poetry self update

# activate the virtual environment
poetry shell

# install any updated dependencies
poetry install

# Restart the service

Development

poetry shell  # activate venv
pre-commit install  # install the pre-commit hook
# make changes
# commit
# test
# make a PR

Testing (Unit Tests)

You must install the development requirements first. See the "Development" section above.

# activate venv
poetry shell

# run once
pytest
#
# pytest with coverage (html and terminal)
pytest --cov --cov-report=html --cov-report=term

 # monitors files for changes and reruns
pytest-watch

# pytest-watch with coverage and double verbose
pytest-watch -- -v --cov --cov-report=html --cov-report=term

Running and More Documentation

For Bitbar, see README.bb.md.

For Lamdatest, see README.lt.md.