Skip to main content

Python library for interacting with JIRA via REST APIs.

Project description

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/develop/graph/badge.svg https://img.shields.io/bountysource/team/pycontribs/activity.svg Requirements Status

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jira-3.0a2.tar.gz (105.0 kB view details)

Uploaded Source

Built Distribution

jira-3.0a2-py3-none-any.whl (65.0 kB view details)

Uploaded Python 3

File details

Details for the file jira-3.0a2.tar.gz.

File metadata

  • Download URL: jira-3.0a2.tar.gz
  • Upload date:
  • Size: 105.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.4

File hashes

Hashes for jira-3.0a2.tar.gz
Algorithm Hash digest
SHA256 63adf9cdd4b93bbfc52458fa385f65d0374d09d300f69402eba2a24b42176ee3
MD5 454d1005547f8455827d76fbcdda4bed
BLAKE2b-256 83d45e600efb72017cf7dd4802fab5529ce5625e5dde182386a84b00042be0cc

See more details on using hashes here.

File details

Details for the file jira-3.0a2-py3-none-any.whl.

File metadata

  • Download URL: jira-3.0a2-py3-none-any.whl
  • Upload date:
  • Size: 65.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.4

File hashes

Hashes for jira-3.0a2-py3-none-any.whl
Algorithm Hash digest
SHA256 e2d4b48d21dd7dd7659f9aeac22cdfbe6cdc1825747eb3a7e276b9b6e41b1e4c
MD5 97879e248e9640e2d8b4675be34765df
BLAKE2b-256 2fa17fccf289dc9e6e661e758e78a01917bd5580ef7ce94b5c44e7a85f1b50ee

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page