tox.ini

# Tox (https://tox.readthedocs.io) 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]
minversion = 3.18.0
skip_missing_interpreters=True
envlist =
    py310
    py311
    py312
    py313
    py313t
    py314
    py314t
    pypy3.10
    pypy3.11

[env]
passenv =
    CPPFLAGS
    CFLAGS
    CXXFLAGS
    LDFLAGS
    MPI4PY_*
    MPICFG
    MPICC
    MPICXX
    MPILD
    MPIEXEC
    MPIEXEC_*
    HYDRA_*
    MPICH_*
    OMPI_*
    I_MPI_*
    MSMPI_*
    MV2_*

[mpi]
mpicc = {env:MPICC:mpicc}
mpicxx = {env:MPICXX:mpicxx}
mpiexec = {env:MPIEXEC:mpiexec}

[testenv:.pkg]
passenv = {[env]passenv}

[testenv]
labels = test
deps = -r{toxinidir}/conf/requirements-test.txt
allowlist_externals = {[mpi]mpiexec}
passenv = {[env]passenv}
commands =
    {[mpi]mpiexec} -n 1 {envpython} -m mpi4py --version
    {[mpi]mpiexec} -n 5 {envpython} -m mpi4py -m mpi4py.bench helloworld
    {[mpi]mpiexec} -n 5 {envpython} -m mpi4py -m mpi4py.bench ringtest
    {[mpi]mpiexec} -n 5 {envpython} -m mpi4py -m mpi4py.bench pingpong -q -n 4096
    {[mpi]mpiexec} -n 5 {envpython} -m mpi4py -m mpi4py.bench futures  -q -n 4096
    {[mpi]mpiexec} -n 1 {envpython} {toxinidir}/test/main.py --no-builddir -q -e spawn []
    {[mpi]mpiexec} -n 5 {envpython} {toxinidir}/test/main.py --no-builddir -q -e spawn []
    {[mpi]mpiexec} -n 1 {envpython} {toxinidir}/demo/futures/test_futures.py -q []
    {[mpi]mpiexec} -n 5 {envpython} {toxinidir}/demo/futures/test_futures.py -q []
    {[mpi]mpiexec} -n 1 {envpython} -m mpi4py.futures {toxinidir}/demo/futures/test_futures.py -q []
    {[mpi]mpiexec} -n 5 {envpython} -m mpi4py.futures {toxinidir}/demo/futures/test_futures.py -q []
    {envpython} {toxinidir}/demo/test-run/test_run.py -q []

[testenv:build-cmake]
labels = build,cmake
deps = build
skip_install = true
allowlist_externals = {[mpi]mpiexec},rm
passenv = {[env]passenv}
setenv =
    CFLAGS=-O0 -Wp,-U_FORTIFY_SOURCE
    MPI4PY_BUILD_BACKEND=cmake
commands_pre =
    rm -rf build
commands =
    {envpython} -m build --outdir {envtmpdir}/dist
    {envpython} -m pip install --verbose .
    mpiexec -n 1 {envpython} test/main.py test_package

[testenv:build-meson]
labels = build,meson
deps = build
skip_install = true
allowlist_externals = {[mpi]mpiexec},rm
passenv = {[env]passenv}
setenv =
    CFLAGS=-O0 -Wp,-U_FORTIFY_SOURCE
    MPI4PY_BUILD_BACKEND=meson
commands_pre =
    rm -rf .mesonpy-*
commands =
    {envpython} -m build --outdir {envtmpdir}/dist
    {envpython} -m pip install --verbose .
    mpiexec -n 1 {envpython} test/main.py test_package

[testenv:code]
labels = code
deps = setuptools -r{toxinidir}/conf/requirements-build-cython.txt
skip_install = true
allowlist_externals = mv
setenv =
    MPICFG=nompi
    CFLAGS=-O0 -Wp,-U_FORTIFY_SOURCE
commands =
    {envpython} conf/mpiapigen.py
    {envpython} setup.py --quiet build -b build/code --force
    mv src/lib-mpi/pympiconf.h conf/nompi/pympiconf.h
    {envpython} setup.py --quiet build -b build/code install --force
    {envpython} conf/mpistubgen.py

[testenv:conf]
labels = conf,check
deps = setuptools -r{toxinidir}/conf/requirements-build-cython.txt
skip_install = true
allowlist_externals = diff
setenv =
    MPICFG=nompi
    CFLAGS=-O0 -Wp,-U_FORTIFY_SOURCE
commands =
    {envpython} setup.py --quiet build -b build/conf --force
    diff -u conf/nompi/pympiconf.h src/lib-mpi/pympiconf.h

[testenv:lint]
labels = lint,check
deps = -r{toxinidir}/conf/requirements-lint.txt
allowlist_externals = sh
setenv =
    MPICFG=nompi-fast
    CFLAGS=-O0
commands =
    ruff check --quiet
    ruff format --quiet --diff
    flake8
    pylint mpi4py
    codespell
    sh conf/cythonize.sh -Wextra -Werror
    cython-lint .
    yamllint .
    sh conf/shellcheck.sh

[testenv:type]
labels = type,check
deps = -r{toxinidir}/conf/requirements-type.txt
setenv =
    MPICFG=nompi-fast
    CFLAGS=-O0
commands =
    stubtest --ignore-disjoint-bases mpi4py
    mypy --python-version 3.14 -p mpi4py
    mypy --python-version 3.13 -p mpi4py
    mypy --python-version 3.12 -p mpi4py
    mypy --python-version 3.11 -p mpi4py
    mypy --python-version 3.10 -p mpi4py

[testenv:docs]
labels = docs
deps = -r{toxinidir}/conf/requirements-docs.txt
allowlist_externals = rm,mv
passenv = SOURCE_DATE_EPOCH
setenv =
    MPICFG=nompi-fast
    CFLAGS=-O0
    TOPDIR=
    DOCDIR=docs/
    SRCDIR=docs/source/
    BLDDIR=build/
    OUTDIR=docs/
    LATEXMKOPTS=-quiet
commands_pre =
    {envpython} -m pip uninstall --yes sphinx-rtd-theme
    rm -rf {env:OUTDIR}html
commands =
    rst2html5 {env:DOCDIR}index.rst {env:OUTDIR}index.html
    sphinx-build -M html     {env:SRCDIR} {env:BLDDIR} -q -E -W -j auto
    sphinx-build -M man      {env:SRCDIR} {env:BLDDIR} -q -E -W -j auto
    sphinx-build -M info     {env:SRCDIR} {env:BLDDIR} -q -E -W -j auto
    sphinx-build -M latexpdf {env:SRCDIR} {env:BLDDIR} -q -E -W -j auto
    rm -r {env:SRCDIR}reference
    rm {env:BLDDIR}html/.buildinfo
    mv {env:BLDDIR}html                {env:OUTDIR}
    mv {env:BLDDIR}man/mpi4py.3        {env:OUTDIR}
    mv {env:BLDDIR}texinfo/mpi4py.info {env:OUTDIR}
    mv {env:BLDDIR}latex/mpi4py.pdf    {env:OUTDIR}