armi.tests.test_mpiFeatures module

Tests for featurest that need MPI, and thus require special testing.

These tests will be generally ignored by pytest if you are trying to run them in an environment without MPI installed.

To run these tests from the commandline, install MPI, mpi4py, and do:

mpiexec -n 2 python -m pytest armi/tests/test_mpiFeatures.py or mpiexec.exe -n 2 python -m pytest armi/tests/test_mpiFeatures.py

class armi.tests.test_mpiFeatures.FailingInterface1(r, cs)

Bases: Interface

utility classes to make sure the logging system fails properly.

Construct an interface.

The r and cs arguments are required, but may be None, where appropriate for the specific Interface implementation.

Parameters:

• r (Reactor) – A reactor to attach to

• cs (Settings) – Settings object to use

Raises:

RuntimeError – Interfaces derived from Interface must define their name

name: Optional[str] = 'failer'

The name of the interface. This is undefined for the base class, and must be overridden by any concrete class that extends this one.

interactEveryNode(cycle, node)

class armi.tests.test_mpiFeatures.FailingInterface2(r, cs)

Bases: Interface

utility class to make sure the logging system fails properly.

Construct an interface.

The r and cs arguments are required, but may be None, where appropriate for the specific Interface implementation.

Parameters:

• r (Reactor) – A reactor to attach to

• cs (Settings) – Settings object to use

Raises:

RuntimeError – Interfaces derived from Interface must define their name

name: Optional[str] = 'failer'

The name of the interface. This is undefined for the base class, and must be overridden by any concrete class that extends this one.

interactEveryNode(cycle, node)

class armi.tests.test_mpiFeatures.FailingInterface3(r, cs)

Bases: Interface

fails on worker operate.

Construct an interface.

The r and cs arguments are required, but may be None, where appropriate for the specific Interface implementation.

Parameters:

• r (Reactor) – A reactor to attach to

• cs (Settings) – Settings object to use

Raises:

RuntimeError – Interfaces derived from Interface must define their name

name: Optional[str] = 'failer'

The name of the interface. This is undefined for the base class, and must be overridden by any concrete class that extends this one.

fail()

interactEveryNode(c, n)

workerOperate(cmd)

class armi.tests.test_mpiFeatures.MockInterface(r, cs)

Bases: Interface

Construct an interface.

The r and cs arguments are required, but may be None, where appropriate for the specific Interface implementation.

Parameters:

• r (Reactor) – A reactor to attach to

• cs (Settings) – Settings object to use

Raises:

RuntimeError – Interfaces derived from Interface must define their name

name: Optional[str] = 'mockInterface'

The name of the interface. This is undefined for the base class, and must be overridden by any concrete class that extends this one.

interactInit()

class armi.tests.test_mpiFeatures.MpiOperatorTests(methodName='runTest')

Bases: TestCase

Testing the MPI parallelization operator.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

test_basicOperatorMPI(mockOpMpi)

Test we can drive a parallel operator.

test_primaryException()

Test a custom interface that only fails on the main process.

test_primaryCritical()

test_finalizeInteract()

Test to make sure workers are reset after interface interactions.

class armi.tests.test_mpiFeatures.BcastAction1

Bases: MpiAction

invokeHook()

class armi.tests.test_mpiFeatures.BcastAction2

Bases: MpiAction

invokeHook()

class armi.tests.test_mpiFeatures.MpiDistributeStateTests(methodName='runTest')

Bases: TestCase

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

test_distributeSettings()

Under normal circumstances, we would not test “private” methods; however, distributeState is quite complicated.

test_distributeReactor()

Under normal circumstances, we would not test “private” methods; however, distributeState is quite complicated.

test_distributeInterfaces()

Under normal circumstances, we would not test “private” methods; however, distributeState is quite complicated.

test_distributeState()

test_compileResults()

class armi.tests.test_mpiFeatures.MpiPathToolsTests(methodName='runTest')

Bases: TestCase

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

test_cleanPathMpi()

class armi.tests.test_mpiFeatures.TestContextMpi(methodName='runTest')

Bases: TestCase

Parallel tests for the Context module.

Create an instance of the class that will use the named test method when executed. Raises a ValueError if the instance does not have a method with the specified name.

test_rank()

test_nonNoneData()