Python library for interacting with JIRA via REST APIs.
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.
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]'
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]
See the documentation for full details.
Development takes place on GitHub using the default repository branch. Each version is tagged.
Automatic (VS Code)
Follow the instructions in the contributing guide, which will describe how to use the dev container that will automatically setup a suitable environment.
Install pyenv to install a suitable python version.
- Launch docker jira server
docker run -dit -p 2990:2990 --name jira addono/jira-software-standalone
tox -e lint
- Run tests
- Build and publish with TWINE
tox -e publish
In addition to all the contributors we would like to thank to these companies:
GitHub for hosting our continuous integration and our git repo
Navicat for providing us free licenses of their powerful database client GUI tools.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.