---
id: pytest-jira
version: "0.4.0"
license: GPL-2.0-only
license_treatment: copyleft
maintenance: active
---

# pytest-jira — py.test JIRA integration plugin, using markers

License: copyleft · Maintenance: active · Downloads: 127.6K/mo

## What it is and what it does

pytest-jira is a pytest plugin that integrates test execution with JIRA issue tracking. It allows you to mark tests with JIRA ticket IDs (either via decorator or docstring) and automatically adjusts test behavior based on ticket status: unresolved tickets can skip tests or mark them as expected failures (xfail), while resolved tickets run tests normally. The plugin queries JIRA to determine status and can filter by component, version, and resolution type.

The plugin does not create, close, or modify JIRA tickets—it only reads their status to inform test behavior. It supports flexible configuration via jira.cfg files (loaded hierarchically from system, home, and project directories) or environment variables, with command-line overrides. It also provides a fixture for mid-test status checks and strategies for handling missing or unreachable issues.

Use it for:

- Skip tests for known unresolved bugs to prevent false failures during CI/CD runs
- Mark tests as expected failures when a JIRA ticket is open, then automatically pass when the ticket is resolved
- Filter test behavior by component or version so tests adapt to different deployment targets
- Examine JIRA issue status mid-test using the jira_issue fixture to conditionally skip assertions
- Manage test expectations across teams by centralizing issue status in JIRA rather than hardcoding skip decorators

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A pytest plugin that links test cases to JIRA tickets, allowing tests to be skipped or marked as expected failures based on ticket status without creating or closing tickets.

Yes, with conditions. The plugin is actively maintained, has low install friction, and solves a real problem for teams using JIRA and pytest. However, the GPL-2.0-only copyleft license means proprietary projects must either dual-license or avoid it. Requires upfront configuration (jira.cfg + credentials) and JIRA API access. No known vulnerabilities.

## Install

pip install pytest-jira
uv add pytest-jira
poetry add pytest-jira

## Installing pytest-jira

Before you install: Low friction install with six runtime dependencies including pytest, requests, and marshmallow. Active maintenance with a release 32 days ago and last commit on 2026-07-13.

License in practice: Licensed under GPL-2.0-only (copyleft). Derivative works and distributions must also be open source under GPL-2.0-only; proprietary projects cannot use this plugin without dual licensing.

Quickstart:

pip install pytest-jira

# In your test file:
import pytest

@pytest.mark.jira('ORG-1382')
def test_example():
    assert True

# Create jira.cfg with:
# [DEFAULT]
# url = https://jira.example.com
# username = USERNAME
# password = PASSWORD

Requires a jira.cfg configuration file in /etc, home directory, test root, or test directory with at least a JIRA URL and credentials (username/password or token).

Verify before relying:

- Whether the plugin supports JIRA Cloud vs Server/Data Center instances
- Performance impact when checking many tickets or running large test suites
- Exact retry behavior and timeout handling for JIRA API calls

## Package facts

- License: GPL-2.0-only (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 127.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pytest jira integration, link tests to jira tickets, jira marker for pytest, skip tests based on jira status, pytest jira plugin, test jira issue tracking, xfail tests from jira, jira-integration, test-management, ci-cd

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