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://readthedocs.org/projects/jira/badge/?version=master https://api.travis-ci.org/pycontribs/jira.svg?branch=master 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,testing]

Usage

See the documentation for full details.

Development

Development takes place on GitHub, where the git-flow branch structure is used:

  • master - contains the latest released code.

  • develop - (default branch) is used for development of the next release.

  • feature/XXX - feature branches are used for development of new features before they are merged to develop.

Credits

In additions 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-1.0.15.tar.gz (95.1 kB view details)

Uploaded Source

Built Distribution

jira-1.0.15-py2.py3-none-any.whl (55.1 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file jira-1.0.15.tar.gz.

File metadata

  • Download URL: jira-1.0.15.tar.gz
  • Upload date:
  • Size: 95.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for jira-1.0.15.tar.gz
Algorithm Hash digest
SHA256 20108a1d5b0dd058d5d4e0047f2d09ee06aaa413b22ca4d5c249e86167417fe8
MD5 6a3b805cd6ca3925729c45b9b0be33cb
BLAKE2b-256 6ab1373a9d99ab0b730a74db79ac39f93f616efdb0e0d11fb3353a2fabba8b7f

See more details on using hashes here.

File details

Details for the file jira-1.0.15-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for jira-1.0.15-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 b0139d7cf0f31d3de7b99fa1210e67e9859c294336c2eaa9dde70619c8aa8ced
MD5 2310150f6b20f2e465ad8ca71db17519
BLAKE2b-256 7d863b3c5114359dc1102c2f8948cdab3cc2c97688f7cad6b37bdca3509d3410

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