Skip to content

Latest commit

 

History

History
125 lines (80 loc) · 4.78 KB

README.rst

File metadata and controls

125 lines (80 loc) · 4.78 KB

JIRA Python Library


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

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 continous integration testing.
  • JetBrains for providing us with free licenses of PyCharm
  • Travis for hosting our continous integration
  • Navicat for providing us free licenses of their powerful database client GUI tools.
  • Citrix for providing maintenance of the library.
https://images1-focus-opensocial.googleusercontent.com/gadgets/proxy?container=focus&refresh=3600&resize_h=50&url=https://www.atlassian.com/dms/wac/images/press/Atlassian-logos/logoAtlassianPNG.png https://images1-focus-opensocial.googleusercontent.com/gadgets/proxy?container=focus&refresh=3600&resize_h=50&url=http://blog.jetbrains.com/pycharm/files/2015/12/PyCharm_400x400_Twitter_logo_white.png https://images1-focus-opensocial.googleusercontent.com/gadgets/proxy?container=focus&refresh=3600&resize_h=50&url=https://upload.wikimedia.org/wikipedia/en/9/90/PremiumSoft_Navicat_Premium_Logo.png https://images1-focus-opensocial.googleusercontent.com/gadgets/proxy?container=focus&refresh=3600&resize_h=50&url=https://www.citrix.com/content/dam/citrix/en_us/images/logos/citrix/citrix-logo-black.jpg