Test Parametrization

Using slash.parametrize

Use the slash.parametrize() decorator to multiply a test function for different parameter values:

@slash.parametrize('x', [1, 2, 3])
def test_something(x):
    pass

The above example will yield 3 test cases, one for each value of x. Slash also supports parametrizing the before and after methods of test classes, thus multiplying each case by several possible setups:

class SomeTest(Test):
    @slash.parametrize('x', [1, 2, 3])
    def before(self, x):
        # ...

    @slash.parametrize('y', [4, 5, 6])
    def test(self, y):
        # ...

    @slash.parametrize('z', [7, 8, 9])
    def after(self, z):
        # ...

The above will yield 27 different runnable tests, one for each cartesian product of the before, test and after possible parameter values.

This also works across inheritence. Each base class can parametrize its before or after methods, multiplying the number of variations actually run accordingly. Calls to super are handled automatically in this case:

class BaseTest(Test):

    @slash.parametrize('base_parameter', [1, 2, 3])
    def before(self, base_parameter):
        # ....

class DerivedTest(BaseTest):

    @slash.parametrize('derived_parameter', [4, 5, 6])
    def before(self, derived_parameter):
        super(DerivedTest, self).before() # note that base parameters aren't specified here
        # .....

More Parametrization Shortcuts

In addition to slash.parametrize(), Slash also supports slash.parameters.toggle as a shortcut for toggling a boolean flag in two separate cases:

@slash.parameters.toggle('with_safety_switch')
def test_operation(with_safety_switch):
    ...

Another useful shortcut is slash.parameters.iterate, which is an alternative way to specify parametrizations:

@slash.parameters.iterate(x=[1, 2, 3], y=[4, 5, 6])
def test_something(x, y):
    ...

Specifying Multiple Arguments at Once

You can specify dependent parameters in a way that forces them to receive related values, instead of a simple cartesian product:

@slash.parametrize(('fruit', 'color'), [('apple', 'red'), ('apple', 'green'), ('banana', 'yellow')])
def test_fruits(fruit, color):
    ... # <-- this never gets a yellow apple

Labeling Parameters

By default, parameters are being designated by their ordinal number, starting with zero. This means that the following test:

@slash.parametrize('param', [Object1(), Object2()])
def test_something(param):
    ...

This will generate tests named test_something(param=param0) and test_something(param=param1). This is not very useful for most cases – as the tests should be indicative of their respective parametrization flavors.

To cope with this, Slash supports parametrization labels. This can be done as follows:

@slash.parametrize('param', [
  slash.param('first', Object1()),
  slash.param('second', Object2()),
])
def test_something(param):
    ...

The above will generate tests named test_something(param=first) and test_something(param=second), which, given descriptive labels, should differentiate the cases more clearly.

The labeling mechanism has a second possible syntactic shortcut, for developers preferring the value to appear first:

@slash.parametrize('param', [
  Object1() // slash.param('first'),
  Object2() // slash.param('second'),
])
def test_something(param):
    ...

The two forms are functionally equivalent.

Note

Label names are limited to 30 characters, and are under the same naming constraints as Python variables. This is intentional, and is intended to avoid abuse and keep labels concise.

Excluding Parameter Values

You can easily skip specific values from parametrizations in tests through slash.exclude:

import slash

SUPPORTED_SIZES = [10, 15, 20, 25]

@slash.parametrize('size', SUPPORTED_SIZES)
@slash.exclude('size', [10, 20])
def test_size(size): # <-- will be skipped for sizes 10 and 20
    ...

This also works for parameters of fixtures (for more information about fixtures see the fixtures chapter)

import slash

SUPPORTED_SIZES = [10, 15, 20, 25]

@slash.exclude('car.size', [10, 20])
def test_car(car):
    ...

@slash.parametrize('size', SUPPORTED_SIZES)
@slash.fixture
def car(size): # <-- will be skipped for sizes 10 and 20
    ...

Exclusions also work on sets of parameters:

import slash

SUPPORTED_SIZES = [10, 15, 20, 25]

@slash.exclude(('car.size', 'car.color'), [(10, 'red'), (20, 'blue')])
def test_car(car):
    ...

@slash.parametrize('size', SUPPORTED_SIZES)
@slash.parametrize('color', ['red', 'green', 'blue'])
@slash.fixture
def car(size, color): # <-- red cars of size 10 and blue cars of size 20 will be skipped
    ...