---
id: pytest-mpi
version: "0.6"
license: 3-clause BSD
license_treatment: permissive
maintenance: abandoned
---

# pytest-mpi — pytest plugin to collect information from tests

License: permissive · Maintenance: abandoned · Downloads: 102.8K/mo

## 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 above — 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

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

- License: 3-clause BSD (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 102.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pytest mpi testing, mpi test runner, parallel testing mpi, pytest distributed computing, message passing interface testing, mpi pytest plugin, hpc test framework, mpi, hpc, abandoned

[View on SkillFed](https://skillfed.io/packages/pytest-mpi) · [View on PyPI](https://pypi.org/project/pytest-mpi/)