pytest-skip-markers

What it is and what it does

pytest-skip-markers is a pytest plugin that provides a collection of pre-built skip markers to simplify conditional test skipping. Instead of writing custom skip logic for platform-specific or environment-specific tests, you decorate test functions with markers like @pytest.mark.skip_unless_on_linux to skip tests based on runtime conditions. The plugin was extracted from pytest-salt-factories and targets common scenarios such as platform-specific test execution.

The package depends on pytest as its core framework, along with attrs, distro (for OS detection), and pywin32 (for Windows support). It supports Python 3.8 through 3.12 and is classified as Production/Stable. The codebase is typed, making it compatible with static type checkers.

Use it for:

• Skip Linux-only tests when running on Windows or macOS without manual platform checks
• Conditionally run Windows-specific tests only on Windows systems during CI/CD
• Reduce boilerplate by using declarative markers instead of if-statements in test functions
• Simplify test suites that need to run different tests across multiple operating systems

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A pytest plugin that provides skip markers to conditionally skip tests based on platform, OS, and other runtime conditions without writing custom skip logic.

Yes, if you have platform-specific tests and want to reduce skip-logic boilerplate. The package is stable and has no known vulnerabilities. However, note that it has been dormant for 735 days—while the repository is not archived and recent commits exist, you should verify that the available markers match your needs before adopting it, as the feature set may not have evolved recently.

Install

pytest-skip-markers on PyPI

pip install pytest-skip-markers

uv add pytest-skip-markers

poetry add pytest-skip-markers

Installing pytest-skip-markers

Before you install

Low friction install with stable maintenance. The package is dormant (735 days since last release) but the repository remains active with a recent commit on 2024-08-09. Dependencies are lightweight: pytest, attrs, distro, and pywin32.

License in practice

Licensed under Apache Software License 2.0 (permissive). You can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart

pip install pytest-skip-markers

import pytest

@pytest.mark.skip_unless_on_linux
def test_on_linux():
    assert True

Verify before relying

• The specific skip markers available beyond skip_unless_on_linux are not detailed in the excerpt
• Whether pywin32 is a required runtime dependency or optional for Windows-only functionality

Package facts

Evidence: pytest_skip_markers-1.5.2-py3-none-any.whl

Tags

More Testing packages