Skip to content

Generalized Test Functionality for pynxtools plugins

The pynxtools sub-package testing is to be utilized to write automated tests for pynxtools reader plugins without requiring in-depth knowledge of the pynxtools internal architecture. The tool supports generalised a general test for all reader plugins, irrespective of the technical details of the raw data files and the internal design of the plugin (note: it is assumed that the plugin was built from the plugin template or has the same structure internally).

Why it is needed

To test integration of a plugin with the pynxtools core system, we need to: 1. Test the plugin's integration with pynxtools from the plugin's CI/CD. 2. Test in the pynxtools's CI/CD if the plugin has been integrated with pynxtools properly.

How to write an integration test for a reader plugin with pynxtools.testing

It is very simple to write a test to verify the plugin integration with pynxtools within the plugin's tests directory. The developer can place the test where they want, but they need to use the provided test interface from pynxtools. An example test for pynxtools-FOO (a demo plugin) plugin is given below:

# test_plugin.py

import os

import pytest
from pynxtools.testing.nexus_conversion import ReaderTest

# e.g. module_dir = /pynxtools-foo/tests
module_dir = os.path.dirname(os.path.abspath(__file__))


@pytest.mark.parametrize(
    "nxdl,reader_name,files_or_dir",
    [
        ("NXfoo", "foo", f"{module_dir}/../tests/data/test_data_dir_1"),
        ("NXfoo", "foo", f"{module_dir}/../tests/data/test_data_dir_2")
    ],
)
def test_foo_reader(nxdl, reader_name, files_or_dir, tmp_path, caplog):
    """Test for the FooReader or foo reader plugin.

    Parameters
    ----------
    nxdl : str
        Name of the NXDL application definition that is to be tested by
        this reader plugin (e.g. NXfoo), without the file ending .nxdl.xml.
    reader_name : str
        Name of the class of the reader (e.g. "foo")
    files_or_dir : class
        Name of the class of the reader.
    tmp_path : pytest.fixture
        Pytest fixture variable, used to create temporary file and clean up the generated files
        after test.
    caplog : pytest.fixture
        Pytest fixture variable, used to capture the log messages during the test.
    """
    # test plugin reader
    test = ReaderTest(nxdl, reader_name, files_or_dir, tmp_path, caplog)
    test.convert_to_nexus()
    # test.convert_to_nexus(caplog_level="ERROR", ignore_undocumented=True)
    # Use `ignore_undocumented` to skip undocumented fields
    # caplog_level can be "ERROR" or "WARNING"
    test.check_reproducibility_of_nexus()

Alongside the test data in test/data, it is also possible to add other types of test data inside the test directory of the plugin.

You can also pass additional parameters to test.convert_to_nexus:

  • caplog_level (str): Can be either "ERROR" (by default) or "warning". This parameter determines the level at which the caplog is set during testing. If it is "WARNING", the test will also fail if any warnings are reported by the reader.

  • ignore_undocumented (boolean): If true, the test skipts the verification of undocumented keys. Otherwise, a warning massages for undocumented keys is raised