How to Disable a Test Using Pytest?

Better Stack Team
Updated on May 15, 2024

If you need to disable a specific test when running your test suite with pytest, use the pytest skip decorator. Suppose you have the following tests in your test suite:

test_math.py
import pytest

def test_addition():
    result = 2 + 2
    assert result == 4

def test_subtraction():
    result = 5 - 3
    assert result == 2

To skip the test_addition test, apply the @pytest.mark.skip decorator with a reason for skipping:

 
import pytest

@pytest.mark.skip(reason="Temporarily disabled for demonstration purposes")
def test_addition():
    result = 2 + 2
    assert result == 4

def test_subtraction():
    result = 5 - 3
    assert result == 2

When you execute the tests using pytest:

 
pytest -v

Pytest will report that the addition test has been skipped and only the subtraction test has been executed:

Output
...

test_math.py::test_addition SKIPPED (Temporarily disabled this test for demonstration purposes)                                                                       [ 50%]
test_math.py::test_subtraction PASSED                                                                                                                                 [100%]

======================================================================= 1 passed, 1 skipped in 0.00s ========================================================================

Make your mark

Join the writer's program

Are you a developer and love writing and sharing your knowledge with the world? Join our guest writing program and get paid for writing amazing technical guides. We'll get them to the right readers that will appreciate them.

Write for us
Writer of the month
Marin Bezhanov
Marin is a software engineer and architect with a broad range of experience working...
Build on top of Better Stack

Write a script, app or project on top of Better Stack and share it with the world. Make a public repository and share it with us at our email.

community@betterstack.com

or submit a pull request and help us build better products for everyone.

See the full list of amazing projects on github