Python JIRA Library is the easiest way to automate JIRA.
Python Makefile Shell
ssbarnea codecov: disabled comment
Avoid spam on PRs due to codecov comments, votes and checks are more than enough.
Latest commit 02c6a07 Aug 2, 2018
Permalink
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Update issue templates Jul 12, 2018
.idea Adopt pre-commit hooks Jun 21, 2018
build Fixed test execution. Nov 11, 2016
dist Fixed test execution. Nov 11, 2016
docs minor docs fixes Jul 12, 2018
examples Implement cookie based authentication Mar 18, 2018
jira Add StatusCategory resource (#596) Jul 20, 2018
tests Add StatusCategory resource (#596) Jul 20, 2018
.coveragerc Changed the way we load the version in setup.py in order to properly … Jan 20, 2015
.editorconfig linting fixes Mar 1, 2018
.gitchangelog.rc enabled cspell check Jun 1, 2018
.gitignore enabled cspell check Jun 1, 2018
.gitreview flake8 fix for FileNotFoundError and added gitreview file. Oct 21, 2016
.pre-commit-config.yaml upgraded pre-commit hooks (#640) Jul 19, 2018
.pyup.yml Configure pyup bot settings Aug 2, 2018
.travis.yml travis: fix deploy Jul 10, 2018
.yamllint Adopt pre-commit hooks Jun 21, 2018
AUTHORS.rst improved tests Jan 13, 2015
LICENSE Adopt pre-commit hooks Jun 21, 2018
MANIFEST.in Adopted pbr and hacking Nov 16, 2016
Makefile build: chore Jul 10, 2018
README.rst Update Travis badge to travis.com Jul 10, 2018
codecov.yml codecov: disabled comment Aug 2, 2018
cspell.json update pyyaml dependency Jul 11, 2018
package.json api: py37 support and rename async to async_ (#604) Jul 3, 2018
pytest.ini Enabled py36 target on travis Jan 12, 2017
requirements-dev.txt update pyyaml dependency Jul 11, 2018
requirements-opt.txt Adopt pre-commit hooks Jun 21, 2018
requirements.txt avoid pycrypto dependency Jul 10, 2018
setup.cfg fix pypi classifiers (#634) Jul 12, 2018
setup.py Remove wrong requirements from setup.py (#648) Jul 25, 2018
test.local Fixed test execution. Nov 11, 2016
tox.ini api: py37 support and rename async to async_ (#604) Jul 3, 2018

README.rst

JIRA Python Library


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

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:

  • 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 Server for testing - make install-sdk
  • pip install requirements-dev.txt
  • 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