pip install test dependencies for tox from setup.py
I've achieved this by committing a slight abuse of extra requirements. You were almost there trying the extras syntax, just that tests_require
deps aren't automatically available that way.
With a setup.py
like this:
from setuptools import setuptest_deps = [ 'coverage', 'pytest',]extras = { 'test': test_deps,}setup( # Other metadata... tests_require=test_deps, extras_require=extras,)
You can then get the test dependencies installed with the extras syntax, e.g. from the project root directory:
$ pip install .[test]
Give that same syntax to Tox in tox.ini
, no need to adjust the default install_command
:
[testenv]commands = {posargs:pytest}deps = .[test]
Now you don't need to maintain the dependency list in two places, and they're expressed where they should be for a published package: in the packaging metadata instead of requirements.txt
files.
It seems this little extras hack is not all that uncommon.
Solution
Tox 2.6 introduced extras
option. This will install extras
from the sdist it just built, only for that sdist and at the time it was doing the normal sdist install.
setup.py should look like:
setuptools.setup( ... extras_require={ 'tests': ['pytest>=3.7.0', 'more_packages'], }, ... )
tox.ini should look like:
[testenv]...extras = tests...
Concerns
Other approaches may get similar results but introduce unnecessary risk and limits the usefulness of other features:
deps =.[tests]
is a bit of a hack. The field is for packages the environment needs. If setup.py install_requires references another package you develop, you could use it to pull in a pre-release version of it. As shown, it will install your whole package from your working directory (whatever state that is in!) just to get at the list of packages in tests
. install_command
will run next, installing your newly minted sdist. In short, issues with the sdist may be masked since you already have installed from your working copy.
Editing install_command
is overkill. It'll overwrite items installed via deps
. (again maybe you used it to install a specific version of a package).
tests_require
is used when python setup.py test
is run. Tox recommends avoiding python setup.py test
so you can ignore tests_require
all together.
What you can do is have a single file (called test_requirements.txt
) and list out the test dependencies like so:
dnspython==1.12.0easydev==0.8.3enum34==1.0.4fabric==1.10.1...
Then, in setup.py
, parse and store the file contents in a list and pass that list to setup
:
tests_require = [line.strip() for line in open('test_requirements.txt') if line.strip() and not line.strip().startswith('--')]setuptools.setup( ... tests_require=tests_require, ...)