Using Test IDs

Allow easy test selection with test ids.

Assigns (and, in verbose mode, prints) a sequential test id for each test executed. Ids can be fed back in as test names, and this plugin will translate them back to full test names. Saves typing!

This plugin implements reportStartTest(), loadTestsFromName(), loadTestsFromNames() and stopTest().

Enable this Plugin

This plugin is built-in, but not loaded by default.

Even if you specify always-on = True in the configuration, it will not run unless you also enable it. You can do so by putting the following in a unittest.cfg or nose2.cfg file

[unittest]
plugins = nose2.plugins.testid

The plugins parameter may contain a list of plugin names, including nose2.plugins.testid

Configuration [testid]

always-on
Default

False

Type

boolean

id-file
Default

.noseids

Type

str

Sample configuration

The default configuration is equivalent to including the following in a unittest.cfg file.

[testid]
always-on = False
id-file = .noseids

Command-line options

-I DEFAULT, --with-id DEFAULT

Add test ids to output

Plugin class reference: TestId

class nose2.plugins.testid.TestId(*args, **kwargs)[source]

Allow easy test select with ids

loadIds()[source]

Load previously pickled ‘ids’ and ‘tests’ attributes.

loadTestsFromName(event)[source]

Load tests from a name that is an id

If the name is a number, it might be an ID assigned by us. If we can find a test to which we have assigned that ID, event.name is changed to the test’s real ID. In this way, tests can be referred to via sequential numbers.

loadTestsFromNames(event)[source]

Translate test ids into test names

nextId()[source]

Increment ID and return it.

reportStartTest(event)[source]

Record and possibly output test id

stopTestRun(event)[source]

Write testids file