Run code before and after each test in py.test?

Posted on

Problem :

I want to run additional setup and teardown checks before and after each test in my test suite. I’ve looked at fixtures but not sure on whether they are the correct approach. I need to run the setup code prior to each test and I need to run the teardown checks after each test.

My use-case is checking for code that doesn’t cleanup correctly: it leaves temporary files. In my setup, I will check the files and in the teardown I also check the files. If there are extra files I want the test to fail.

Solution :

py.test fixtures are a technically adequate method to achieve your purpose.

You just need to define a fixture like that:

def run_around_tests():
    # Code that will run before your test, for example:
    files_before = # ... do something to check the existing files
    # A test function will be run at this point
    # Code that will run after your test, for example:
    files_after = # ... do something to check the existing files
    assert files_before == files_after

By declaring your fixture with autouse=True, it will be automatically invoked for each test function defined in the same module.

That said, there is one caveat. Asserting at setup/teardown is a controversial practice. I’m under the impression that the py.test main authors do not like it (I do not like it either, so that may colour my own perception), so you might run into some problems or rough edges as you go forward.

You can use a fixture in oder to achieve what you want.

import pytest

def run_before_and_after_tests(tmpdir):
    """Fixture to execute asserts before and after a test is run"""
    # Setup: fill with any logic you want

    yield # this is where the testing happens

    # Teardown : fill with any logic you want

Detailed Explanation

  1. @pytest.fixture(autouse=True), from the docs: “Occasionally, you may want to have fixtures get invoked automatically without declaring a function argument explicitly or a usefixtures decorator.” Therefore, this fixture will run every time a test is executed.

  2. # Setup: fill with any logic you want, this logic will be executed before every test is actually run. In your case, you can add your assert statements that will be executed before the actual test.

  3. yield, as indicated in the comment, this is where testing happens

  4. # Teardown : fill with any logic you want, this logic will be executed after every test. This logic is guaranteed to run regardless of what happens during the

Note: in pytest there is a difference between a failing test and an error while executing a test. A Failure indicates that the test failed in some way.
An Error indicates that you couldn’t get to the point of doing a proper test.

Consider the following examples:

Assert fails before test is run -> ERROR

import pytest

def run_around_tests():
    assert False # This will generate an error when running tests
    assert True

def test():
    assert True

Assert fails after test is run -> ERROR

import pytest

def run_around_tests():
    assert True
    assert False

def test():
    assert True

Test fails -> FAILED

import pytest

def run_around_tests():
    assert True
    assert True

def test():
    assert Fail

Test passes -> PASSED

import pytest

def run_around_tests():
    assert True
    assert True

def test():
    assert True

Fixtures are exactly what you want.
That’s what they are designed for.

Whether you use pytest style fixtures, or setup and teardown (module, class, or method level) xUnit style fixtures, depends on the circumstance and personal taste.

From what you are describing, it seems like you could use pytest autouse fixtures.
Or xUnit style function level setup_function()/teardown_function().

Pytest has you completely covered. So much so that perhaps it’s a fire hose of information.

You can use Module level setup/teardown Fixtures of Pytest.

Here’s the Link

It Works as follows:

 def setup_module(module):
     """ setup any state specific to the execution of the given module."""

 def teardown_module(module):
     """ teardown any state that was previously setup with a setup_module

        def test_01():
          #test 1 Code

It will call setup_module before this test and teardown_module after test completes.

You can include this fixture in each test-script to run it for each test.

IF you want to use something that is common to all tests in a directory You can use package/directory level fixtures nose framework

In file of the package you can include following

     def setup_package():
       '''Set up your environment for test package'''

     def teardown_package():
        '''revert the state '''

You may use decorators but programatically, so you don’t need to put the decorator in each method.

I’m assuming several things in next code:

The test methods are all named like: “testXXX()”
The decorator is added to the same module where test methods are implemented.

def test1():
    print ("Testing hello world")

def test2():
    print ("Testing hello world 2")

#This is the decorator
class TestChecker(object):
    def __init__(self, testfn, *args, **kwargs):
        self.testfn = testfn

    def pretest(self):
        print ('precheck %s' % str(self.testfn))
    def posttest(self):
        print ('postcheck %s' % str(self.testfn))
    def __call__(self):

for fn in dir() :
    if fn.startswith('test'):
        locals()[fn] = TestChecker(locals()[fn])

Now if you call the test methods…


The output should be something like:

precheck <function test1 at 0x10078cc20>
Testing hello world
postcheck <function test1 at 0x10078cc20>
precheck <function test2 at 0x10078ccb0>
Testing hello world 2
postcheck <function test2 at 0x10078ccb0>

If you have test methods as class methods, the approach is also valid. For instance:

class TestClass(object):
    def my_test(cls):
        print ("Testing from class method")

for fn in dir(TestClass) :
    if not fn.startswith('__'):
        setattr(TestClass, fn, TestChecker(getattr(TestClass, fn)))

The call to TestClass.my_test() will print:

precheck <bound method type.my_test of <class '__main__.TestClass'>>
Testing from class method 
postcheck <bound method type.my_test of <class '__main__.TestClass'>>

It is an old question but I personally found another way from the docs :
Use the pytest.ini file :

usefixtures = my_setup_and_tear_down
import pytest

def my_setup_and_tear_down():

    # SETUP
    # Write here the logic that you need for the setUp

    yield # this statement will let the tests execute

    # Write here the logic that you need after each tests

About the yield statement and how it allows to run the test : HERE

Fixtures by default have scope=function. So, if you just use a definition such as

def fixture_func(self)

It defaults to (scope='function').

So any finalizers in the fixture function will be called after each test.

Leave a Reply

Your email address will not be published. Required fields are marked *