Skip to main content
https://img.shields.io/pypi/v/jira.svg https://img.shields.io/pypi/l/jira.svg https://img.shields.io/pypi/wheel/jira.svg https://img.shields.io/github/issues/pycontribs/jira.svg https://img.shields.io/badge/irc-%23pycontribs-blue
https://readthedocs.org/projects/jira/badge/?version=master https://travis-ci.com/pycontribs/jira.svg?branch=master Python Black Code Style https://codecov.io/gh/pycontribs/jira/branch/master/graph/badge.svg https://img.shields.io/bountysource/team/pycontribs/activity.svg Requirements Status

Note

It’s just and fix for the original lib

This library eases the use of the Jira REST API from Python and it has been used in production for years.

As this is an open-source project that is community maintained, do not be surprised if some bugs or features are not implemented quickly enough. You are always welcomed to use BountySource to motivate others to help.

Quickstart

Feeling impatient? I like your style.

from jira import JIRA

jira = JIRA('https://jira.atlassian.com')

issue = jira.issue('JRA-9')
print(issue.fields.project.key)            # 'JRA'
print(issue.fields.issuetype.name)         # 'New Feature'
print(issue.fields.reporter.displayName)   # 'Mike Cannon-Brookes [Atlassian]'

Installation

Download and install using pip install jira or easy_install jira

You can also try pip install --user --upgrade jira which will install or upgrade jira to your user directory. Or maybe you ARE using a virtualenv right?

By default only the basic library dependencies are installed, so if you want to use the cli tool or other optional dependencies do perform a full installation using pip install jira[opt,cli,test]

Usage

See the documentation for full details.

Development

Development takes place on GitHub:

  • master - (default branch) contains the primary development stream. Tags will be used to show latest releases.

Setup

  • Fork repo

  • Keep it sync’ed while you are developing

  • Install pyenv

  • Install Atlassian Jira Server for testing - make install-sdk

  • pip install jira[test]

  • Start up Jira Server - atlas-run-standalone

  • Test your changes - make test

Credits

In addition to all the contributors we would like to thank to these companies:

  • Atlassian for developing such a powerful issue tracker and for providing a free on-demand Jira instance that we can use for continuous integration testing.

  • JetBrains for providing us with free licenses of PyCharm

  • Travis for hosting our continuous integration

  • Navicat for providing us free licenses of their powerful database client GUI tools.

https://raw.githubusercontent.com/pycontribs/resources/master/logos/x32/logo-atlassian.png https://raw.githubusercontent.com/pycontribs/resources/master/logos/x32/logo-pycharm.png https://raw.githubusercontent.com/pycontribs/resources/master/logos/x32/logo-navicat.png

Metadata

Release files for jira-333 3.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jira-333 3.4.0
File Size Uploaded
jira_333-3.4.0.tar.gz 106.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for jira-333 3.4.0
File Interpreter ABI Platform
jira_333-3.4.0-py3-none-any.whl Python 3 none any Details

Total release size: 168.2 kB

Release files / jira_333-3.4.0.tar.gz

Download URL jira_333-3.4.0.tar.gz
Size 106.9 kB
Tags Source
SHA-256 checksum
How to use checksums
bd319604cbd38ca4a9a1b663319c4acceda88cd2bde9adec58ed5ee9275cb6b6
BLAKE2b-256 checksum
How to use checksums
5163c0868297457b58dc67521677cbb0bd469e1aecddb03b2e8d31e609c86b3a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.1 importlib_metadata/3.10.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.2

Release files / jira_333-3.4.0-py3-none-any.whl

Download URL jira_333-3.4.0-py3-none-any.whl
Size 61.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1825bccf930fdf764a81b4af9c5f6042f5912275d527707b5e9d9eac07e706c3
BLAKE2b-256 checksum
How to use checksums
7c350e0f493d992f7b45e2852247fe91df97da0a0d0876b6fb9d139dea0618b4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.1 importlib_metadata/3.10.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.2

Release history Release notifications | RSS feed

This release

3.4.0 This release

2 release files

3.2.0

2 release files

3.1.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page