notion / dado

Data-driven test decorator

dado

Data-driven test decorator

What

Decorate a test to create indepenent tests for each decorated data set.

Example

Given:

from dado import data_driven

@data_driven(['first', 'second'], {
    'letters': ['a', 'b'],
    'numbers': [0, 1],
})
def test_first_two(first, second): ...

When you load the module, it will load as if you'd defined:

def test_first_two_letters():
    return test_first_two('a', 'b')

def test_first_two_numbers():
    return test_first_two(0, 1)

Name

A 'dado' in woodworking is "a groove cut in the face of a board, into which the edge of another board is fixed."

This decorator lets you define a test function into which you fit test data to get the tests you actually want to run.

Plus, 'dado' is much easier to say and remember than 'data-driven-test-decorator', while still keeping some phonetic similarity.

Naming credit goes to soapko :-)