pytest-jira

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 on this page — 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

pytest-jira on PyPI

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

Evidence: pytest_jira-0.4.0-py3-none-any.whl

Keywords: jira, plugin, pytest

Tags

More Utilities packages