Pytest: run a function at the end of the tests

pytest call fixture directly
pytest cleanup after all tests
pytest no tests ran
pytest before all
pytest conftest
pytest.mark.usefixtures example
pytest nested tests

I would like to run a function at the end of all the tests.

A kind of global teardown function.

I found an example here and some clues here but it doesn't match my need. It runs the function at the beginning of the tests. I also saw the function pytest_runtest_teardown(), but it is called after each test.

Plus: if the function could be called only if all the tests passed, it would be great.

I found:

def pytest_sessionfinish(session, exitstatus):
    """ whole test run finishes. """

exitstatus can be used to define which action to run. pytest docs about this

Usage and Invocations, You can invoke testing through the Python interpreter from the command line: builtin function arguments pytest -h | --help # show help on command line and The -r flag can be used to display a “short test summary info” at the end of the test​  Pytest supports the use of breakpoint () with the following behaviours: When breakpoint () is called and PYTHONBREAKPOINT is set to the default value, pytest will use the custom internal PDB trace UI instead of the system default Pdb. When tests are complete, the system will default back to the system Pdb trace UI.

To run a function at the end of all the tests, use a pytest fixture with a "session" scope. Here is an example:

@pytest.fixture(scope="session", autouse=True)
def cleanup(request):
    """Cleanup a testing directory once we are finished."""
    def remove_test_dir():

The @pytest.fixture(scope="session", autouse=True) bit adds a pytest fixture which will run once every test session (which gets run every time you use pytest). The autouse=True tells pytest to run this fixture automatically (without being called anywhere else).

Within the cleanup function, we define the remove_test_dir and use the request.addfinalizer(remove_test_dir) line to tell pytest to run the remove_test_dir function once it is done (because we set the scope to "session", this will run once the entire testing session is done).

pytest fixtures: explicit, modular, scalable, Here is the exact protocol used by pytest to call the test function this way: the smtp_connection object automatically closes when the with statement ends. The pytest-openfiles plugin allows for the detection of open I/O resources at the end of unit tests. This is particularly useful for testing code that manipulates file handles or other I/O resources. It allows developers to ensure that this kind of code properly cleans up I/O resources when they are no longer needed.

You can use the "atexit" module.

For instance, if you want to report something at the end of all the test you need to add a report funtion like this:

def report(report_dict=report_dict):
    print("THIS IS AFTER TEST...")
    for k, v in report_dict.items():
        print(f"item for report: {k, v}")

then at the end of the module, you call atexit like this:


hoop this helps!

Basic patterns and examples, Now we can profile which test functions execute the slowest: it to your end-​users, it is a good idea to also package your test runner and run your tests using the  Pythons: Python 3.5, 3.6, 3.7, PyPy3. pytest is a framework that makes building simple and scalable tests easy. Tests are expressive and readable—no boilerplate code required. Get started in minutes with a small unit test or complex functional test for your application or library. Create a simple test function with just four lines of code:

Parametrizing tests, For basic docs, see Parametrizing fixtures and test functions. if metafunc.config.​getoption("all"): end = 5 else: end = 2 metafunc.parametrize("param1", range(end​)). This means that we only run 2 tests if we do not pass --all : $ pytest -q  The pytest framework makes it easy to write small tests, yet scales to support complex functional testing for applications and libraries. An example of a simple test: # content of def inc ( x ): return x + 1 def test_answer (): assert inc ( 3 ) == 5

How to teardown in the end of all tests? · Issue #3051 · pytest-dev , I tried to create function teardown() in conftest and it is not work. And when I run tests from 'tests' directory, like this 'pytest -q tests', I have  Plugins can provide custom markers and implement specific behaviour based on it. This is a self-contained example which adds a command line option and a parametrized test function marker to run tests specifies via named environments: # content of import pytest def pytest_addoption(parser): parser.addoption( "-E", action="store

Python testing with Pytest: Order of test functions, So if you have a print statement in our code, we will not see its output during normal test run. examples/python/pt2/ import sys; def test_hello  To use, either run py.test --doctest-modules command, or set your configuration with pytest.ini: $ cat pytest.ini # content of pytest.ini [pytest] addopts = --doctest-modules Man page: PyTest: doctest integration for modules and test files.

  • pytest_unconfigure seems to do the job, but maybe someone will come up with a better idea
  • To make your fixture run some function at the end, you should use request.addfinalizer(tear_down_function). To make it run at the end of hole session, but not every test case - specify exact scope as @pytest.fixture(scope="session")