tox.ini

[tox]
envlist =
    py{37,38}-test
    build_docs
isolated_build = true

[testenv]
# Pass through the following environemnt variables which may be needed for the CI
passenv = WINDIR LC_ALL LC_CTYPE CC CI TRAVIS
setenv =
    HOME = {envtmpdir}

# Run the tests in a temporary directory to make sure that we don't import
# the package from the source tree
changedir = .tmp/{envname}

# tox environments are constructued with so-called 'factors' (or terms)
# separated by hyphens, e.g. test-devdeps-cov. Lines below starting with factor:
# will only take effect if that factor is included in the environment name. To
# see a list of example environments that can be run, along with a description,
# run:
#
#     tox -l -v
#
description =
    run tests

deps =
# The following indicates which extras_require from setup.cfg will be installed
extras =
    test

commands =
    pip freeze
    pytest --pyargs baldrick {toxinidir}/docs --cov baldrick --cov-config={toxinidir}/setup.cfg {posargs}

[testenv:build_docs]
changedir = docs
description = invoke sphinx-build to build the HTML docs
extras = docs
commands =
    pip freeze
    sphinx-build -W -b html . _build/html {posargs}