pytest-mpi

What it is and what it does

pytest-mpi is a pytest plugin that adds MPI-aware testing capabilities to the pytest framework. It provides a marker decorator (`@pytest.mark.mpi`) that allows you to tag tests to run only under MPI execution, making it easier to organize and filter tests in codebases that use Message Passing Interface for parallel or distributed computing.

The plugin is designed for developers working on MPI-related code who want to integrate MPI tests into their standard pytest workflow. However, the package has been abandoned, with the latest release on 2022-01-08. It was last tested against Python versions 3.5 through 3.9, and compatibility with newer Python versions or pytest releases is unknown.

Use it for:

• Mark and selectively run MPI-specific tests in a pytest suite without running them in serial mode.
• Organize test collections for distributed memory projects that use MPI for parallel computing.
• Filter tests in CI/CD pipelines to run MPI tests only on systems with MPI installed and configured.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A pytest plugin that marks and runs tests under MPI (Message Passing Interface), enabling testing of MPI-related code within the pytest framework.

No—unless you are maintaining legacy code already using this plugin and cannot migrate. The package is abandoned with no maintenance signal since 2022-01-08. For new MPI testing projects, evaluate actively maintained alternatives or consider building on pytest directly. If you must use it, verify compatibility with your Python version first.

Install

pytest-mpi on PyPI

pip install pytest-mpi

uv add pytest-mpi

poetry add pytest-mpi

Installing pytest-mpi

Before you install

Low install friction with a single runtime dependency on pytest. However, the package is abandoned—last release was over 1679 days ago with no recent maintenance activity.

License in practice

Licensed under 3-clause BSD (permissive), so you can use, modify, and distribute the package freely with minimal restrictions, provided you retain the license notice.

Quickstart

pip install pytest-mpi

import pytest

@pytest.mark.mpi
def test_mpi():
    pass

Requires MPI to be installed on your system; the package is abandoned and may not work with Python versions beyond those listed in classifiers (3.5–3.9).

Verify before relying

• Whether the package works with Python versions newer than 3.9 or modern pytest releases.
• Whether MPI runtime compatibility has been tested recently or if breaking changes exist in newer MPI implementations.
• What specific MPI implementations (OpenMPI, MPICH, etc.) are supported or tested.

Package facts

Evidence: pytest_mpi-0.6-py2.py3-none-any.whl

Keywords: pytest, testing

Tags

More Testing packages