tox.ini

[tox]
isolated_build = true
skip_missing_interpreters = True
minversion = 3.24.4

[tox:.package]
# N.B.: tox will use the same python version as under what tox is installed to package, so unless
# this is python 3 you can require a given python version for the packaging environment via the
# basepython key. We need this for flit which only runs under python3 but works for python2
# projects.
basepython = python3

[testenv]
commands =
    pytest --ignore=tests/integration {posargs:-vvs}

    # Ensure pex's main entrypoint can be run externally.
    pex --disable-cache . -e pex.bin.pex:main --version
deps =
    ansicolors==1.1.8
    # The more-itertools project is an indirect requirement of pytest and its broken for
    # Python < 3.6 in newer releases so we force low here.
    more-itertools<=8.10.0; python_version < "3.6"
    pytest==4.6.11; python_version < "3.6"
    pytest==6.2.5; python_version >= "3.6"
    pkginfo==1.7.0
    toml==0.10.2
    py{27,py27}: mock==3.0.5
    subprocess: subprocess32
passenv =
    # This allows working around broken xcode Python SDKs.
    ARCHFLAGS
    # This allows re-locating the pyenv interpreter test cache for CI.
    _PEX_TEST_PYENV_ROOT
    # These are to support directing test environments to the correct headers on OSX.
    CPATH
    CPPFLAGS
    LDFLAGS
    PEX_VERBOSE
setenv =
    # Python 3 (until a fix here in 3.9: https://bugs.python.org/issue13601) switched from stderr
    # being unbuffered to stderr being buffered by default. This can lead to tests checking stderr
    # failing to see what they expect if the stderr buffer block has not been flushed. Force stderr
    # line buffering (which is what setting PYTHONUNBUFFERED nets you) so that tests can rely on
    # stderr lines being observable.
    py{py35,py36,py37,py38,py39,35,36,37,38}: PYTHONUNBUFFERED=1
whitelist_externals =
    open
    bash
    git

[testenv:py{py27-subprocess,py27,py35,py36,py37,py38,py39,27,35,36,37,38,39,310,311}-integration]
deps =
    pytest-xdist==1.34.0
    {[testenv]deps}
commands =
    pytest -n auto tests/integration {posargs:-vvs}
setenv =
    # Python 3 (until a fix here in 3.9: https://bugs.python.org/issue13601) switched from stderr
    # being unbuffered to stderr being buffered by default. This can lead to tests checking stderr
    # failing to see what they expect if the stderr buffer block has not been flushed. Force stderr
    # line buffering (which is what setting PYTHONUNBUFFERED nets you) so that tests can rely on
    # stderr lines being observable.
    py{py35,py36,py37,py38,py39,35,36,37,38}-integration: PYTHONUNBUFFERED=1

[testenv:format-run]
skip_install = true
deps =
    black==21.12b0
    # The 8.1.0 release of click breaks black; so we pin.
    click==8.0.1
    isort==5.10.1
commands =
    bash scripts/format.sh

[testenv:format-check]
skip_install = true
deps =
    {[testenv:format-run]deps}
commands =
    bash scripts/format.sh --check

[testenv:typecheck]
deps =
    # This version should track the version in pex/vendor/__init__.py.
    attrs @ git+https://github.com/python-attrs/attrs@947bfb542104209a587280701d8cb389c813459d
    packaging==20.9  # This version should track the version in pex/vendor/__init__.py.
    pip==20.3.4  # This version should track the version in pex/vendor/__init__.py.
    setuptools==44.0.0  # This version should track the version in pex/vendor/__init__.py.
    mypy[python2]==0.931
    typing-extensions
    types-mock
    types-toml==0.10.5
commands =
    bash scripts/typecheck.sh

[testenv:vendor]
# The vendored dist may contain references to the python version it was built on
# (e.g., pex/vendor/_vendored/pip/pip-20.0.dev0.dist-info/entry_points.txt).
# So this test restricts the python version, to prevent spurious diffs that will cause it to fail.
basepython = python3.8
skip_install = true
deps =
    ansicolors==1.1.8
    pip==20.2.4
    redbaron==0.9.2
    setuptools==50.3.2
    wheel==0.35.1
    {[testenv:format-run]deps}
commands =
    python -m pex.vendor {posargs}
    {[testenv:format-run]commands}

[testenv:vendor-check]
basepython = {[testenv:vendor]basepython}
skip_install = true
deps =
    tox
commands =
    tox -e vendor -- --no-update
    bash scripts/embed_virtualenv.sh
    git diff --exit-code

[testenv:docs]
changedir = docs
deps =
    sphinx
    sphinx-rtd-theme
commands =
    sphinx-build -b html -d {envtmpdir}/doctrees . _build/html
    open _build/html/index.html

[_flit]
basepython = python3
deps =
    flit
    # This is only here to pin the transitive dependency low to work around
    # https://github.com/pypa/flit/issues/530
    flit_core<3.7.0
    pygments

[_package]
basepython = {[_flit]basepython}
deps =
    {[_flit]deps}
    toml

[testenv:package]
skip_install = true
basepython = {[_package]basepython}
deps =
    {[_package]deps}
commands =
    python scripts/package.py {posargs}

[testenv:serve]
skip_install = true
basepython = {[_package]basepython}
deps =
    {[_package]deps}
commands =
    python scripts/package.py --additional-format wheel --local --serve {posargs}

[testenv:publish]
skip_install = true
basepython = {[_flit]basepython}
passenv =
    # These are used in CI.
    FLIT_USERNAME
    FLIT_PASSWORD
deps =
    {[_flit]deps}
commands =
    flit publish

[testenv:pip]
description = Run Pex's vendored pip.
skip_install = true
setenv   =
    __PEX_UNVENDORED__ = 1
    PYTHONPATH = {env:PYTHONPATH:}{:}{toxinidir}/pex/vendor/_vendored/pip
    PYTHONPATH = {env:PYTHONPATH:}{:}{toxinidir}/pex/vendor/_vendored/setuptools
    PYTHONPATH = {env:PYTHONPATH:}{:}{toxinidir}/pex/vendor/_vendored/wheel
    SETUPTOOLS_USE_DISTUTILS = stdlib
commands =
    python -s -mpip {posargs}

[testenv:setuptools]
description = Run Python with Pex's vendored setuptools on the sys.path.
skip_install = true
setenv   =
  __PEX_UNVENDORED__ = 1
  PYTHONPATH = {env:PYTHONPATH:}{:}{toxinidir}/pex/vendor/_vendored/setuptools
  SETUPTOOLS_USE_DISTUTILS = stdlib
commands =
  python {posargs}

[testenv:wheel]
description = Run Pex's vendored wheel
skip_install = true
setenv   =
  PYTHONPATH = {env:PYTHONPATH:}{:}{toxinidir}/pex/vendor/_vendored/wheel
commands =
  python -s -mwheel {posargs}