Skip

The skip tag allows us to mark test functions to be skipped during test execution.

When a test is skipped, it will not be run but will be counted in the test results.

Basic Usage

1
2
3
4
5

import karva

@karva.tags.skip
def test_function():
    assert False

Then running uv run karva test will result in one skipped test.

1
2
3
4
5

import karva

@karva.tags.skip()
def test_function():
    assert False

Then running uv run karva test will result in one skipped test.

Running skipped tests

Use --run-ignored=only to run only tests whose skip condition is active, or --run-ignored=all to run them alongside normal tests. Active skip decorators are ignored for these tests, so their bodies run and can pass or fail normally.

1
2

uv run karva test --run-ignored=only
uv run karva test --run-ignored=all

Tests with false skip conditions are not considered ignored.

Reason

You can provide a str reason as a positional or keyword argument.

1
2
3
4
5

import karva

@karva.tags.skip("This test is not implemented yet")
def test_function():
    assert False

Then running uv run karva test will result in one skipped test.

1
2
3
4
5

import karva

@karva.tags.skip(reason="Waiting for feature X to be implemented")
def test_function():
    assert False

Then running uv run karva test will result in one skipped test.

Pytest

You can also still use @pytest.mark.skip.

1
2
3
4
5

import pytest

@pytest.mark.skip(reason="Waiting for feature X to be implemented")
def test_function():
    assert False

Then running uv run karva test will result in one skipped test.

Conditions

We can provide bool conditions as a positional arguments.

Then the test will only be skipped if all conditions are True.

1
2
3
4
5

import karva

@karva.tags.skip(True)
def test_function():
    assert False

Then running uv run karva test will result in one skipped test.

You can still provide a reason as a keyword argument.

1
2
3
4
5

import karva

@karva.tags.skip(True, reason="Waiting for feature X to be implemented")
def test_function():
    assert False

Then running uv run karva test will result in one skipped test.

Multiple Conditions

1
2
3
4
5

import karva

@karva.tags.skip(True, False) # This will not be skipped
def test_function():
    assert False

Then running uv run karva test will result in one failed test.

Pytest

You can also still use @pytest.mark.skipif.

1
2
3
4
5

import pytest

@pytest.mark.skipif(True, reason="Waiting for feature X to be implemented")
def test_function():
    assert False

Then running uv run karva test will result in one skipped test.