ecc11af6fe
Brief overview how actually siblings are installed helps proper usage of 'tox' role. Change-Id: Id27c9c60a40e43c0e351849470ccb4d0d11739a3
1.9 KiB
1.9 KiB
Runs tox for a project
This role overrides Python packages installed into tox environments with corresponding Zuul sibling projects and runs tox tests as follows:
- Create tox environments.
- Get Python sibling package names for sibling projects created by
Zuul (using
required-projects
job variable). Package names are searched in following sources:setup.cfg
of pbr projects,setup.py
,tox_package_name
role variable.
- Remove sibling packages from tox environments.
- Create temporary constraints file, lines for sibling packages are removed.
- Install sibling packages from Zuul projects into tox environments with temporary constraints file.
- Run tox tests.
Role Variables
Comma separated string with test environments tox should run.
ALL
runs all test environments while an empty string runs all test environments configured withenvlist
in tox.
Path to a pip constraints file. Will be provided to tox via
TOX_CONSTRAINTS_FILE
(deprecated but currently still supported name isUPPER_CONSTRAINTS_FILE
) environment variable if it exists.
Allows a user to setup the package name to be used by tox, over reading a setup.cfg file in the project.