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.

# NOTE: if you use conda for environments and  an error like this:
# "ERROR: InterpreterNotFound: python3.8"
# then run `pip install tox-conda` to use conda to build environments

[tox]
# this is the list of tox "environments" that will run *by default*
# when you just run "tox" alone on the command line
# non-platform appropriate tests will be skipped
# to run a specific test, use the "tox -e" option, for instance:
# "tox -e py38-macos-pyqt" will test python3.8 with pyqt on macos
# (even if a combination of factors is not in the default envlist
# you can run it manually... like py39-linux-pyside2)
envlist = py{310,311,312,313}-{linux,macos,windows}-{pyqt5,pyside2,pyqt6,pyside6,headless,pyqt6_no_numba}-{cov,no_cov},mypy
isolated_build = true
toxworkdir={env:TOX_WORK_DIR:/tmp/.tox}

[gh-actions]
python =
    3.10: py310
    3.11: py311
    3.12: py312
    3.13: py313
fail_on_no_env = True

# This section turns environment variables from github actions
# into tox environment factors. This, combined with the [gh-actions]
# section above would mean that a test running python 3.9 on ubuntu-latest
# with an environment variable of BACKEND=pyqt would be converted to a
# tox env of `py39-linux-pyqt5`
[gh-actions:env]
RUNNER_OS =
    Linux: linux
    Windows: windows
    macOS: macos
BACKEND =
    pyqt5: pyqt5
    pyqt6: pyqt6
    pyside2: pyside2
    pyside6: pyside6
    pyqt6_no_numba: pyqt6_no_numba
    headless: headless
COVERAGE =
    cov: cov
    no_cov: no_cov

# Settings defined in the top-level testenv section are automatically
# inherited by individual environments unless overridden.
[testenv]
platform =
    macos: darwin
    linux: linux
    windows: win32
# These environment variables will be passed from the calling environment
# to the tox environment
passenv =
    CI
    GITHUB_ACTIONS
    DISPLAY
    XAUTHORITY
    NUMPY_EXPERIMENTAL_ARRAY_FUNCTION
    PYVISTA_OFF_SCREEN
    MIN_REQ
    CONDA_EXE
    CONDA
    FORCE_COLOR
    QT_QPA_PLATFORM
    NAPARI_TEST_SUBSET
    COVERAGE_*
    COVERAGE
# Set various environment variables, depending on the factors in
# the tox environment being run
setenv =
    PYTHONPATH = {toxinidir}
# Avoid pyside6 6.4.3 due to issue described in:
# https://github.com/napari/napari/issues/5657
deps =
    pytest-json-report
    pytest-pystack ; sys_platform == 'linux'
    objgraph
    lxml_html_clean
# use extras specified in pyproject.toml for certain test envs
extras =
    testing
    {env:TOX_EXTRAS}
    pyqt5: pyqt5
    pyside2: pyside2
    pyqt6: pyqt6
    pyqt6_no_numba: pyqt6
    pyside6: pyside6_experimental
allowlist_externals =
    echo
    mypy
    dot
indexserver =
    # we use Spec 4 index server that contain nightly wheel.
    # this will be used only when using --pre with tox/pip as it only contains nightly.
    extra = https://pypi.anaconda.org/scientific-python-nightly-wheels/simple
commands =
    echo "COVERAGE: {env:COVERAGE:}"
    cov: coverage run --parallel-mode \
    !cov: python \
        -m pytest {env:PYTEST_PATH:} --color=yes --basetemp={envtmpdir} \
        --ignore tools --maxfail=5 --json-report \
    linux: --pystack-threshold=60 --pystack-args="--native-all" \
        --json-report-file={toxinidir}/report-{envname}.json {posargs} \
        --save-leaked-object-graph


[testenv:py{310,311,312,313}-{linux,macos,windows}-{pyqt5,pyside2,pyqt6,pyside6}-{cov,no_cov}]
extras =
    {[testenv]extras}
    optional-numba

[testenv:py{310,311,312,313}-{linux,macos,windows}-headless-{cov,no_cov}]
commands_pre =
    pip uninstall -y pyautogui pytest-qt pyqt5 pyside2 pyside6 pyqt6
extras =
    {[testenv]extras}
    optional-numba
commands =
    cov: coverage run --parallel-mode \
    !cov: python \
        -m pytest -v --color=yes --basetemp={envtmpdir} --ignore napari/_vispy \
        --ignore napari/_qt --ignore napari/_tests --ignore tools \
        --json-report --json-report-file={toxinidir}/report-{envname}.json {posargs} \
        --save-leaked-object-graph

[testenv:py{310,311,312,313}-{linux,macos,windows}-{pyqt5,pyside2,pyqt6,pyside6}-examples-{cov,no_cov}]
deps =
    # For surface_timeseries_.py example
    nilearn
    # Due to nilearn incompatibility with numpy >=1.24 constraint numpy and add packaging for version check
    packaging
commands =
    cov: coverage run --parallel-mode \
    !cov: python \
        -m pytest napari/_tests/test_examples.py -v --color=yes --basetemp={envtmpdir} {posargs}

[testenv:ruff]
skip_install = True
deps = pre-commit
commands = pre-commit run ruff --all-files

[testenv:ruff-format]
skip_install = True
deps = pre-commit
commands = pre-commit run ruff-format --all-files

[testenv:import-lint]
skip_install = True
deps = pre-commit
commands = pre-commit run --hook-stage manual import-linter --all-files


[testenv:package]
isolated_build = true
skip_install = true
deps =
    check_manifest
    wheel
    twine
    build
commands =
    check-manifest
    python -m build
    python -m twine check dist/*


[testenv:mypy]
deps =
    -r resources/requirements_mypy.txt
commands =
    mypy --config-file pyproject.toml  --pretty --show-error-codes napari
skip_install = true