cs-testutils 20241122

Hacks to assist with testing.

Hacks to assist with testing.

Latest release 20241122: assertSingleThread: new optional exclude parameter which is a callable to test where a Thread should be ignored.

assertSingleThread(include_daemon=False, exclude=None)

Test that there is only one Thread still running.

Parameters:

• include_daemon: also count daemon Threads, normally skipped
• exclude: optional Callable[Thread] to test for other Threads to exclude

product_test(*da, **dkw)

Decorator for test methods which should run subTests against the Cartesian products from params.

A specific TestCase would define its own decorator and apply it throughout the suite. Here is an example from cs.vt.datadir_tests:

def multitest(test_method): return product_test( test_method, datadirclass=[DataDir, RawDataDir], indexclass=[ indexclass_by_name(indexname) for indexname in sorted(indexclass_names()) ], hashclass=[ HASHCLASS_BY_NAME[hashname] for hashname in sorted(HASHCLASS_BY_NAME.keys()) ], )

whose test suite then just decorates each method with @multitest:

@multitest
def test000IndexEntry(self):
    ....

Note that because there must be setup and teardown for each product, the TestCase class may well have empty setUp and tearDown methods and instead is expected to provide:

• product_setup(self,**params): a setup method taking keyword arguments for each product
• product_teardown(self): the corresponding testdown method There are called around each subTest.

Class SetupTeardownMixin

A mixin to support a single setupTeardown() context manager method.

SetupTeardownMixin.setUp(self): Run super().setUp() then the set up step of self.setupTeardown().

SetupTeardownMixin.tearDown(self): Run the tear down step of self.setupTeardown(), then super().tearDown().

Release Log

Release 20241122: assertSingleThread: new optional exclude parameter which is a callable to test where a Thread should be ignored.

Release 20240623: New assertSingleThread() function to check that there are no left over Threads.

Release 20230109:

• @product_test decorator for running test matrices.
• SetupTeardownMixin providing unittest setUp/tearDown from setupTeardown context manager method.