pytest-jira

py.test JIRA integration plugin, using markers

With conditionsPyPI UtilitiesReleased Jul 2026127.6K downloads / moGPL-2.0-onlyPure Python

Decision gist · record as of 2026-08-14

pure-Python wheel — pytest_jira-0.4.0-py3-none-any.whl

v0.4.0 · released 2026-07-13 · Python >=3.9 · 6 runtime deps: marshmallow, packaging, pytest, requests, retry2, six

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.AI-flagged interpretation of the facts on this page — verify before relying

Before you install

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).
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 · maintenance · safety

GPL-2.0-only (copyleft) — 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.

last release 2026-07-13 (32 days) · last repo commit 2026-07-13 · 27 stars

0 known vulnerabilities (OSV.dev, 2026-08-14) · 127,630 downloads/mo, #11,736 on PyPI

Alternatives

pytest-jira-xrayA pytest plugin that marks individual tests with JIRA XRAY IDs and uploads their pass/fail results back to JIRA.pure-Python wheel164.5K/mo pytest-runtime-xfailA pytest plugin that provides a `runtime_xfail` fixture to mark tests as expected-to-fail based on runtime conditions.pure-Python wheel179.9K/mo pytest-progressA pytest plugin that displays real-time test progress counts (passed, failed.pure-Python wheel124.2K/mo

Verify before relying

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

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

Same gist for agents: .md · .json

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 on it.

With conditions

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

pipuvpoetry

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.

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).

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

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 the current Python release >=3.9
Install friction	Low. Pure-Python wheel
Runtime dependencies	6 packages marshmallowpackagingpytestrequestsretry2six
Maintenance	Actively maintained 32 days since the last release
Last repo commit	2026-07-13
First released	2013-10-30
Downloads	127,630 / month, #11,736 on PyPI 30-day window, as of 2026-08-14
Known vulnerabilities	None known OSV.dev, checked 2026-08-14
Classifiers	Development Status :: 4 - BetaEnvironment :: PluginsFramework :: PytestIntended Audience :: DevelopersOperating System :: POSIXProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.9Topic :: Software Development :: Quality AssuranceTopic :: Software Development :: TestingTopic :: Utilities

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

Let your AI agent find packages like this

Example. Real query, live index.

You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.

wish › “link tests to jira tickets”

pytest-jiraA pytest plugin that links test cases to JIRA tickets, allowing tests…
pytest-jira-xrayA pytest plugin that marks individual tests with JIRA XRAY IDs and…
jiraA Python library that wraps the Jira REST API, letting you…

Give your agent the search over MCP, or paste the wish link into any chat.

More Utilities packages

idna Worth it

PyPI · Python Modules · released Jun 2026

Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.

Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.

BSD-3-Clausepure Python · 3.9+

1.8Bdownloads / mo

charset-normalizer Worth it

PyPI · Utilities · released Aug 2026

Detects and normalizes text encoding from unknown or ambiguous sources, supporting all IANA character sets that Python's core library provides codecs for, with the ability to register custom codecs.

permissive licensepure Python · 3.7+

1.7Bdownloads / mo

setuptools Worth it

PyPI · Python Modules · released Aug 2026

Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.

MITpure Python · 3.10+

1.6Bdownloads / mo

pluggy Worth it

PyPI · Libraries · released May 2025

Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.

Install it if you're building an extensible application or framework.

MITpure Python · 3.9+aging

1.3Bdownloads / mo

Pygments Worth it

PyPI · Utilities · released Mar 2026

Pygments is a syntax highlighter that colorizes source code and text in over 500 languages and formats, outputting to HTML, LaTeX, RTF, SVG, images, or ANSI terminal sequences.

Install it if you need to display or transform source code.

BSD-2-Clausepure Python · 3.9+

1.3Bdownloads / mo

six With conditions

PyPI · Libraries · released Dec 2024

Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.

MITpure Python

1.2Bdownloads / mo

pytest-jira

Decision gist · record as of 2026-08-14

Before you install

License · maintenance · safety

Alternatives

Verify before relying

What it is and what it does

Use it for

Worth the install?

Install

Before you install

License in practice

Quickstart

Verify before relying

Package facts

Tags

Let your AI agent find packages like this

More Utilities packages