Metadata-Version: 2.0
Name: jira
Version: 0.28
Summary: A library to ease use of the JIRA 5 REST APIs.
Home-page: http://bitbucket.org/bspeakmon/jira-python
Author: Ben Speakmon
Author-email: ben.speakmon@gmail.com
License: BSD
Keywords: jira atlassian rest api
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Topic :: Internet :: WWW/HTTP
Provides: jira
Requires-Dist: requests (>=1.2.3)
Requires-Dist: requests-oauthlib (>=0.3.3)
Requires-Dist: tlslite (>=0.4.4)
Requires-Dist: six (>=1.5.2)
Provides-Extra: shell
Requires-Dist: ipython (>=0.13); extra == 'shell'
Provides-Extra: magic
Requires-Dist: filemagic (>=1.6); extra == 'magic'
Provides-Extra: parallel
Requires-Dist: grequests; extra == 'parallel'

=========
JIRA Python Library
=========

.. image:: https://api.travis-ci.org/pycontribs/jira.png?branch=master
        :target: https://travis-ci.org/pycontribs/jira

.. image:: https://coveralls.io/repos/pycontribs/jira/badge.png?branch=master
        :target: https://coveralls.io/r/pycontribs/jira

.. image:: https://pypip.in/d/jira/badge.png
        :target: https://pypi.python.org/pypi/jira/

.. image:: https://pypip.in/v/jira/badge.png
        :target: https://pypi.python.org/pypi/jira/

.. image:: https://pypip.in/egg/jira/badge.png
        :target: https://pypi.python.org/pypi/jira/

.. image:: https://pypip.in/wheel/jira/badge.png
        :target: https://pypi.python.org/pypi/jira/

.. image:: https://pypip.in/license/jira/badge.png
        :target: https://pypi.python.org/pypi/jira/

This library eases the use of the JIRA REST API from Python

# Quickstart

Feeling impatient? I like your style.

    :::python
        from jira.client import JIRA

        options = { 'server': 'https://jira.atlassian.com'}
        jira = JIRA(options)

        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 user directory. Or maybe you ARE using a [virtualenv][2], right?

# Usage

See the documentation (http://readthedocs.org/docs/jira-python/) for full details.

# Credits

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

* [Atlassian](https://www.atlassian.com/) for developing such a powerful issue tracker and for providing a [free on-demand JIRA instance](https://pycontribs.atlassian.net) that we can use for continous integration testing.
* [JetBrains](http://www.jetbrains.com) for providing us with free licenses of [PyCharm](http://www.jetbrains.com/pycharm/)
* [Travis CI](https://travis-ci.org/) for hosting our continous integration

[1]: http://docs.python-requests.org/
[2]: http://www.virtualenv.org/en/latest/index.html

.. image:: http://upload.wikimedia.org/wikipedia/en/6/6f/PremiumSoft_Navicat_Premium_Logo.jpg

