---
id: pytest-skip-markers
version: "1.5.2"
license: Apache Software License 2.0
license_treatment: permissive
maintenance: dormant
---

# pytest-skip-markers — Pytest Salt Plugin

License: permissive · Maintenance: dormant · Downloads: 74.4K/mo

## 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 above — 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

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

- License: Apache Software License 2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 74.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pytest skip markers, conditional test skipping, platform-specific test markers, pytest platform skip, skip tests by os, pytest conditional markers, test skipping plugin, pytest-plugin, test-markers, platform-detection

[View on SkillFed](https://skillfed.io/packages/pytest-skip-markers) · [View on PyPI](https://pypi.org/project/pytest-skip-markers/)