Marking test functions with attributesΒΆ

By using the pytest.mark helper you can easily set metadata on your test functions. There are some builtin markers, for example:

  • skip - always skip a test function
  • skipif - skip a test function if a certain condition is met
  • xfail - produce an “expected failure” outcome if a certain condition is met
  • parametrize to perform multiple calls to the same test function.

It’s easy to create custom markers or to apply markers to whole test classes or modules. See Working with custom markers for examples which also serve as documentation.


Marks can only be applied to tests, having no effect on fixtures.