[tox]
minversion = 3.4.0
envlist =
    docs, packaging, lint-py2, lint-py3, mypy,
    py27, py35, py36, py37, py38, pypy, pypy3

[helpers]
# Wrapper for calls to pip that make sure the version being used is the
# original virtualenv (stable) version, and not the code being tested.
pip = python {toxinidir}/tools/tox_pip.py

[testenv]
passenv = CI GIT_SSL_CAINFO
setenv =
    # This is required in order to get UTF-8 output inside of the subprocesses
    # that our tests use.
    LC_CTYPE = en_US.UTF-8
deps = -r{toxinidir}/tools/tests-requirements.txt
commands_pre =
	python -c 'import shutil, sys; shutil.rmtree(sys.argv[1], ignore_errors=True)' {toxinidir}/tests/data/common_wheels
	{[helpers]pip} wheel -w {toxinidir}/tests/data/common_wheels -r {toxinidir}/tools/tests-common_wheels-requirements.txt
commands = pytest --timeout 300 []
install_command = {[helpers]pip} install {opts} {packages}
list_dependencies_command = {[helpers]pip} freeze --all

[testenv:coverage-py3]
basepython = python3
commands = pytest --timeout 300 --cov=pip --cov-report=term-missing --cov-report=xml --cov-report=html tests/unit {posargs}

[testenv:docs]
# Don't skip install here since pip_sphinxext uses pip's internals.
deps = -r{toxinidir}/tools/docs-requirements.txt
basepython = python3.6
commands =
    sphinx-build -W -d {envtmpdir}/doctrees/html -b html docs/html docs/build/html
    # Having the conf.py in the docs/html is weird but needed because we
    # can not use a different configuration directory vs source directory on RTD
    # currently -- https://github.com/rtfd/readthedocs.org/issues/1543.
    # That is why we have a "-c docs/html" in the next line.
    sphinx-build -W -d {envtmpdir}/doctrees/man -b man docs/man docs/build/man -c docs/html

[testenv:packaging]
skip_install = True
deps =
    check-manifest
    readme_renderer
commands_pre =
commands =
    check-manifest
    python setup.py check -m -r -s

[lint]
deps = -r{toxinidir}/tools/lint-requirements.txt

[testenv:lint-py2]
skip_install = True
basepython = python2
deps = {[lint]deps}
commands_pre =
# No need to flake8 docs, tools & tasks in py2
commands =
    flake8 src tests
    isort --check-only --diff

[testenv:lint-py3]
skip_install = True
basepython = python3
deps = {[lint]deps}
commands_pre =
commands =
    flake8
    isort --check-only --diff

[testenv:mypy]
skip_install = True
basepython = python3
deps = -r{toxinidir}/tools/mypy-requirements.txt
commands_pre =
commands =
    mypy src
    mypy src -2