This is a tox plugin that preinstalls a specific version of setuptools in each tox environment.
pip install tox-setuptools-versionThis works around the default behavior of tox/virtualenv that always installs
the latest version setuptools. It is an improvement over the VIRTUALENV_NO_DOWNLOAD=1
option that does not install the latest version, but could result in usage of
an outdated version of setuptools.
Note: This relies on an unstable tox plugin interface. You may experience breakage with new tox versions. If you do, please feel free to report the issue on Github.
This repository is based on a fork from the plugin tox-pip-version, you should probably go to see his job too.
Install the package and include setuptools_version in your tox.ini
[testenv]
setuptools_version = setuptools<58
Or, set the TOX_SETUPTOOLS_VERSION environment variable,
export TOX_SETUPTOOLS_VERSION=57.2.4
toxThe plugin will install that version of setuptools into the tox-created virtualenv, just after tox creates the virtualenv, but before dependencies are installed.
The setuptools_version within tox.ini, if present, is always used over the
environment variable.
If neither setuptools_version or TOX_SETUPTOLLS_VERSION is present, the plugin does
nothing.
Version sets/ranges are supported, enabling installation of a version of pip matching a set of specifiers. There are two basic formats: a plain version number, or the package name with optional PEP440-compatible version specifiers.
| tox.ini | effective pip command |
|---|---|
setuptools_version = 58.0 |
pip install -U setuptools==19.0 |
setuptools_version = setuptools==58.0 |
pip install -U setuptools==58.0 |
setuptools_version = setuptools>=58.0 |
pip install -U setuptools>=58.0 |
setuptools_version = setuptools!=58.0,>57 |
pip install -U setuptools!=58.0,>57 |
setuptools_version = setuptools |
pip install -U setuptools |
setuptools_version = setuptools@git+https://github.com/pypa/setuptools@0168ac6 |
setuptools@git+https://github.com/pypa/setuptools@0168ac6 |