Skip to main content

Python library for interacting with JIRA via REST APIs.

Project description

https://img.shields.io/pypi/v/jira.svg https://img.shields.io/pypi/l/jira.svg https://img.shields.io/github/issues/pycontribs/jira.svg https://img.shields.io/badge/irc-%23pycontribs-blue
https://readthedocs.org/projects/jira/badge/?version=main https://codecov.io/gh/pycontribs/jira/branch/main/graph/badge.svg https://img.shields.io/bountysource/team/pycontribs/activity.svg 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,test]

Usage

See the documentation for full details.

Development

Development takes place on GitHub using the default repository branch. Each version is tagged.

Setup

  • 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

    • Specify what tests to run with pytest
      • tox -e py39 -- tests/resources/test_attachment.py

    • Debug tests with breakpoints by disabling the coverage plugin, with the --no-cov argument.
      • Example for VSCode on Windows :

      {
          <s>"name"</s>: <s>"Pytest"</s>,
          <s>"type"</s>: <s>"python"</s>,
          <s>"request"</s>: <s>"launch"</s>,
          <s>"python"</s>: <s>".tox\\py39\\Scripts\\python.exe"</s>,
          <s>"module"</s>: <s>"pytest"</s>,
          <s>"env"</s>: {
              <s>"CI_JIRA_URL"</s>: <s>"http://localhost:2990/jira"</s>,
              <s>"CI_JIRA_ADMIN"</s>: <s>"admin"</s>,
              <s>"CI_JIRA_ADMIN_PASSWORD"</s>: <s>"admin"</s>,
              <s>"CI_JIRA_USER"</s>: <s>"jira_user"</s>,
              <s>"CI_JIRA_USER_FULL_NAME"</s>: <s>"Newly Created CI User"</s>,
              <s>"CI_JIRA_USER_PASSWORD"</s>: <s>"jira"</s>,
              <s>"CI_JIRA_ISSUE"</s>: <s>"Task"</s>,
              <s>"PYTEST_TIMEOUT"</s>: <s>"0"</s>, // Don't timeout
          },
          <s>"args"</s>: [
              // "-v",
              <s>"--no-cov"</s>, // running coverage affects breakpoints
              <s>"tests/resources/test_attachment.py"</s>
          ]
      }
    • Build and publish with TWINE
      • tox -e publish

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

  • 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/main/logos/x32/logo-atlassian.png https://raw.githubusercontent.com/pycontribs/resources/main/logos/x32/logo-pycharm.png https://raw.githubusercontent.com/pycontribs/resources/main/logos/x32/logo-navicat.png

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jira-3.1.1.tar.gz (111.4 kB view hashes)

Uploaded source

Built Distribution

jira-3.1.1-py3-none-any.whl (67.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page