Skip to main content

Skip matching marks. Matches partial marks using wildcards.

Project description

PyPI PyPI - Python Version GitHub See Build Status on Travis CI See Build Status on AppVeyor

Skip matching marks. Matches partial marks using wildcards.

This Pytest plugin was generated with Cookiecutter along with @hackebrot’s Cookiecutter-pytest-plugin template.


  • Allows any tag to be used for a skip or xfail

  • Wildcards can be used for tags with variable parts (ie: Specify bug_.* for bug_123, bug_777)

  • Important tags can be specified and the user will be warned when they’re skipped

  • Tags that should be skipped can be forced to run anyways


You can install “pytest-match-skip” via pip from PyPI:

pip install pytest-match-skip


command line options

  • The following pytest options can be used on the command line:
    • –skip_marks

    • –important_marks

    • –run_skips

    • –xfail_skips

pytest ini options

  • The following options can be added to a pytest.ini file:
    • skip_marks: List of marks that will be detected

    • important_marks: List of marks that will warn the user if skipped

    • run_skips: true or false to run tests with a skip mark

    • xfail_skips: true or false to xfail instead of skip the marked tests


    skip_marks = bug_.* .*_tracker .*_known_failure_.*
    important_marks = smoke .*_sanity important_.*
    run_skips = false
    xfail_skips = false


The following pytest hooks are available:

  • pytest_match_skip_reason(request, message) - Called if a test is skipped

  • pytest_match_skip_run_skip_warning(request, message) - Called if run_skips is true and a test would otherwise be skipped.

  • pytest_match_skip_important_warning(request, message) - Called when important_marks are skipped


Contributions are very welcome. Tests can be run with tox, please ensure the coverage at least stays the same before you submit a pull request.


Distributed under the terms of the MIT license, “pytest-match-skip” is free and open source software


If you encounter any problems, please file an issue along with a detailed description.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytest-match-skip-0.2.1.tar.gz (5.0 kB view hashes)

Uploaded Source

Built Distribution

pytest_match_skip-0.2.1-py3-none-any.whl (7.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page