Note
New in version 0.2
Filter tests by attribute, excluding any tests whose attributes do not match any of the specified attributes.
Attributes may be simple values or lists, and may be attributes of a test method (or function), a test case class, or the callable yielded by a generator test.
Given the following test module, the attrib plugin can be used to select tests in the following ways (and others!):
Note
All examples assume the attrib plugin has been activated in a config file:
[unittest]
plugins = nose2.plugins.attrib
import unittest
class Test(unittest.TestCase):
def test_fast(self):
pass
test_fast.fast = 1
test_fast.layer = 2
test_fast.flags = ['blue', 'green']
def test_faster(self):
pass
test_faster.fast = 1
test_faster.layer = 1
test_faster.flags = ['red', 'green']
def test_slow(self):
pass
test_slow.fast = 0
test_slow.slow = 1
test_slow.layer = 2
def test_slower(self):
pass
test_slower.slow = 1
test_slower.layer = 3
test_slower.flags = ['blue', 'red']
Running nose2 like this:
nose2 -v -A fast
Runs these tests:
test_fast (attrib_example.Test) ... ok
test_faster (attrib_example.Test) ... ok
This selects all tests that define the attribute as any True value.
Running nose2 like this:
nose2 -v -A '!fast'
Runs these tests:
test_slow (attrib_example.Test) ... ok
test_slower (attrib_example.Test) ... ok
This selects all tests that define the attribute as a False value, and those tests that do not have the attribute at all.
Running nose2 like this:
nose2 -v -A layer=2
Runs these tests:
test_fast (attrib_example.Test) ... ok
test_slow (attrib_example.Test) ... ok
This selects all tests that define the attribute with a matching value. The attribute value of each test case is converted to a string before comparison with the specified value. Comparison is case-insensitive.
Running nose2 like this:
nose2 -v -A flags=red
Runs these tests:
test_faster (attrib_example.Test) ... ok
test_slower (attrib_example.Test) ... ok
Since the flags attribute is a list, this test selects all tests with the value red in their flags attribute. Comparison done after string conversion and is case-insensitive.
Running nose2 like this:
nose2 -v -A '!flags=red'
Runs these tests:
test_fast (attrib_example.Test) ... ok
The result in this case can be somewhat counter-intuitive. What the attrib plugin selects when you negate an attribute that is in a list are only those tests that have the list attribute but without the value specified. Tests that do not have the attribute at all are not selected.
For more complex cases, you can use the -E command-line option to pass a Python expression that will be evaluated in the context of each test case. Only those test cases where the expression evaluates to True (and doesn’t raise an exception) will be selected.
Running nose2 like this:
-nose2 -v -E '"blue" in flags and layer > 2'
Runs only one test:
test_slower (attrib_example.Test) ... ok