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:
master
- (default branch) contains the primary development stream. Tags will be used to show latest releases.
- Fork repo
- Keep it sync'ed while you are developing
- Install pyenv
- develop and test
- Launch docker jira server
docker run -dit -p 2990:2990 --name jira addono/jira-software-standalone
- Lint
tox -e lint
- Run tests
tox
- Run tests for one env only
tox -e py37
- Build and publish with TWINE
tox -e publish
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
- GitHub for hosting our continuous integration and our git repo
- 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-atlassian.png)
![https://raw.githubusercontent.com/pycontribs/resources/master/logos/x32/logo-pycharm.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](https://raw.githubusercontent.com/pycontribs/resources/master/logos/x32/logo-navicat.png)