tox.ini

# Tox (http://tox.testrun.org/) is a tool for running tests
# in multiple virtualenvs. This configuration file will run the
# test suite on all supported python versions. To use it, "pip install tox"
# and then run "tox" from this directory.

[tox]
envlist = py38-{cov,lint,mypy}, docs

[_test]
deps = .[test]

[_lint]
deps = .[lint]
files = beets beetsplug beet test setup.py docs

[_mypy]
deps =
    .[mypy]
    .[test]

[testenv]
deps =
    {test,cov}: {[_test]deps}
    lint: {[_lint]deps}
    mypy: {[_mypy]deps}
passenv = INTEGRATION_TEST
commands =
    test: python -bb -m pytest -rs {posargs}
    cov: coverage run -m pytest -rs {posargs}
    lint: python -m flake8 {posargs} {[_lint]files}
    mypy: mypy -p beets -p beetsplug
    mypy: mypy test

[testenv:docs]
basepython = python3.10
deps = sphinx<4.4.0
commands = sphinx-build -W -q -b html docs {envtmpdir}/html {posargs}

# checks all links in the docs
[testenv:links]
deps = sphinx
allowlist_externals = /bin/bash
commands = /bin/bash -c '! sphinx-build -b linkcheck docs {envtmpdir}/linkcheck | grep "broken\s"'

[testenv:int]
deps = {[_test]deps}
setenv = INTEGRATION_TEST = 1
passenv = GITHUB_ACTIONS
commands = python -bb -m pytest {posargs}