Skip test¶

This is an example of using the pytest-hardpy functions with a test dependency on another test and skipping tests.

how to start¶

Launch hardpy init skip_test.
Launch CouchDH instance.
Modify the files described below.
Launch hardpy run skip_test.

description¶

If a test case/module that a test case/module depends on fails, errors or is skipped, the dependent test case/module will also be skipped. A module is considered passed only if all module tests passed. If these dependencies are incorrect, the tests will not run.

To use:

Add the line @pytest.mark.dependency() before independent tests.
Add the line @pytest.mark.dependency(test_1::test_a) before the dependent test, if a test that a test depends on is in the same file.
Add the line @pytest.mark.dependency(test_1) before the dependent test, if the test depends on the module.

Test/module name formats:

test_1 - if depends on the test module
test_1::test_a - if depends on the test case

case by case dependence¶

import pytest

def test_a():
    assert False

@pytest.mark.dependency("test_1::test_a")
def test_b():
    assert False

test_a is marked as a dependency for test_b using @pytest.mark.dependency("test_1::test_a"). If test_a, then test_b will be skipped.

module by module dependence¶

test_1.py¶

def test_a():
    assert False

test_2.py¶

import pytest

pytestmark = pytest.mark.dependency("test_1")

def test_a():
    assert True

Module test_2 depends on module test_1. If an error occurs in module test_1, all tests in module test_2 will be skipped.

multiple test dependencies example¶

You can specify multiple dependencies for a single test or module. The test will only run if ALL specified dependencies are successful. If any dependency fails, the test will be skipped.

import pytest

def test_a():
    assert True

def test_b():
    assert False

@pytest.mark.dependency("test_1::test_a")
@pytest.mark.dependency("test_1::test_b")
def test_c():
    assert True

In this case, test_c depends on two other tests. Since test_b fails, test_c will be skipped.

multiple module dependencies example¶

test_1.py¶

def test_a():
    assert True

test_2.py¶

def test_b():
    assert False

test_3.py¶

import pytest

pytestmark = [
    pytest.mark.dependency("test_1"),
    pytest.mark.dependency("test_2"),
]

def test_c():
    assert True

Here, the entire test_3 module depends on both test_1 and test_2 modules. Since test_2 fails, all tests in test_3 will be skipped.

incorrect dependency names¶

test_1.py¶

import pytest

def test_a():
    assert True

@pytest.mark.dependency("test_1::a")
def test_b():
    assert True

In this case, the test test_b has no dependencies because the test_1::a dependency is incorrect.