python_test_helper.h File Reference

QtTest convenience layer on top of UTILSLIB::PythonRunner for cross-validating MNE-CPP results against MNE-Python. More...

#include "utils_global.h"
#include "python_runner.h"
#include <Eigen/Core>
#include <QObject>
#include <QString>
#include <QStringList>
#include <QVariantMap>

Include dependency graph for python_test_helper.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
class	UTILSLIB::PythonTestHelper
	Test helper for MNE-Python cross-validation. More...

Namespaces
namespace	UTILSLIB
	Shared utilities (I/O helpers, spectral analysis, layout management, warp algorithms).

Macros
#define	GUARD_PYTHON(available, reason)
	Skip (or fail) the current test if Python is not available.
#define	GUARD_PYTHON_PACKAGE(helper, packageName)
	Skip (or fail) the current test if a Python package is missing.

Detailed Description

QtTest convenience layer on top of UTILSLIB::PythonRunner for cross-validating MNE-CPP results against MNE-Python.

SPDX-License-Identifier: BSD-3-Clause Copyright (c) 2026 MNE-CPP Authors

Author

Christoph Dinh chris.nosp@m.toph.nosp@m..dinh.nosp@m.@mne.nosp@m.-cpp..nosp@m.org

Since

2.2.0

Date

April 2026

Built on UTILSLIB::PythonRunner, this helper adds the thin layer test code needs: a one-shot isAvailable() probe (which caches the result), hasPackage() lookups so a test can announce that it needs e.g. sklearn, and the eval / evalDouble shorthands for running a snippet and parsing its stdout into a number.

The companion GUARD_PYTHON / GUARD_PYTHON_PACKAGE macros QSKIP a test cleanly when Python is missing on developer machines but escalate to QFAIL when MNE_REQUIRE_PYTHON=true so CI runs can never silently skip cross-language regression coverage.

Definition in file python_test_helper.h.

Macro Definition Documentation

GUARD_PYTHON

#define GUARD_PYTHON	(		available,
			reason )

Value:

do {                                                                                           \
    if (!(available)) {                                                                        \
        if (UTILSLIB::PythonTestHelper::isPythonRequired())                                    \
            QFAIL(qPrintable(QString("HARD FAIL (MNE_REQUIRE_PYTHON=true): %1").arg(reason))); \
        QSKIP(qPrintable(QString("SKIP: %1").arg(reason)));                                    \
    }                                                                                          \
} while (0)

Skip (or fail) the current test if Python is not available.

Use this macro at the top of any test slot that requires Python.

• If MNE_REQUIRE_PYTHON is not set: QSKIP with a clear message.
• If MNE_REQUIRE_PYTHON=true: QFAIL so the skip is never silent in CI.

Parameters

available	A PythonTestHelper (or bool) — must support operator bool / isAvailable().
reason	Human-readable reason string.

Definition at line 69 of file python_test_helper.h.

GUARD_PYTHON_PACKAGE

#define GUARD_PYTHON_PACKAGE	(		helper,
			packageName )

Value:

GUARD_PYTHON((helper).hasPackage(packageName), \
             QString("Python package '%1' not available").arg(packageName))

Skip (or fail) the current test if a Python package is missing.

Parameters

helper	A PythonTestHelper instance.
packageName	Package name string (e.g. "sklearn").

Definition at line 84 of file python_test_helper.h.