pytest-isolate-mpi 0.3

pytest-isolate-mpi allows for MPI-parallel tests being executed in a segfault and MPI_Abort safe manner

pytest-isolate-mpi is a plugin for Pytest to enable the test of MPI-parallel Python software. MPI-parallel tests are executed in forked MPI jobs with the help of mpirun to isolate the tests from each other. Thus, a crash in test only aborts the test, not the whole test suite. Similarly, deadlocks can be treated with timeouts for tests to prevent a test suite from never being able to finish:

import pytest


@pytest.mark.mpi(ranks=2, timeout=10, unit="s")
def test_with_mpi(mpi_ranks):
    assert True  # replace with actual, MPI-parallel test code

Installation

pytest-isolate-mpi is available on pypi.org and can be installed with pip:

pip install pytest-mpi-isolate

Documentation

For the full documentation, please see https://pytest-isolate-mpi.readthedocs.io/.

Contributing

Please refer to the Contributor Guide for instructions on how to contribute to pytest-isolate-mpi.

License

This work is licensed under the conditions of the BSD-3-Clause license, see LICENSE.

The software is provided as is. We sincerely welcome your feedback on issues, bugs and possible improvements. Please use the issue tracker of the project for the corresponding communication or make a fork. Our priority and time line for working on the issues depend on the project and its follow ups. This may lead to issue and tickets, which are not pursued. In case you need an urgent fix, please contact us directly for discussing possible forms of collaboration (direct contribution, projects, contracting, …): Institute of Software Methods for Product Virtualization.