Python library for interacting with JIRA via REST APIs.
Project description
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,test]
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 JIRA Server for testing - make install-sdk
pip install jira[test]
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.
Travis for hosting our continuous integration
Navicat for providing us free licenses of their powerful database client GUI tools.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file jira-3.0a1.tar.gz.
File metadata
- Download URL: jira-3.0a1.tar.gz
- Upload date:
- Size: 103.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 0543abeaeddea685c2e39f33299b4b49cca772b872efd6042dec3ef03d2c3f82 |
|
| MD5 | 62634bd39e4279732282d74d78a6d014 |
|
| BLAKE2b-256 | 7f6d13bf6b6e58151a7c30993f74586a11415a3a5de7911b0481626e05ea1872 |
File details
Details for the file jira-3.0a1-py3-none-any.whl.
File metadata
- Download URL: jira-3.0a1-py3-none-any.whl
- Upload date:
- Size: 63.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | a3ec898a77caf00f7c4b8ce930fa2e0d210b7eb661dd8fab8642fde439766dc6 |
|
| MD5 | 8e8da18ac726ceaddf4f6727d1a5de93 |
|
| BLAKE2b-256 | 51ef711426858cb199ef04ed5337e4ba1e1d370ec90db876760e2fe93d1e36eb |
