atlassian-api-py 0.3.18

Atlassian REST API Python Wrapper.

Atlassian REST API Python Wrapper

What is this?

This package is a wrapper of Atlassian Rest APIs written in Python, currently it supports Atlassian products: JIRA and Bitbucket.

This API package was created to bring ease of implementation for integration with JIRA and Bitbucket.

QuickStart

Establish connection

Connect with username and password

>>> from atlassian import Jira
>>> jira = Jira(url='https://jira.company.com', username="username", password="password")

Or connect with token

>>> from atlassian import Jira
>>> jira = Jira(url='https://jira.company.com', token="yourToken")

Or write your credentials in a configuration file config.ini, and get the credential though the configuration file.

[jira]
url = https://jira.company.com
username = username
password = password
# Or
token = yourToken

>>> import configparser
>>> config = configparser.ConfigParser()
>>> config.read('config.ini')

>>> jira_url = config['jira']['url']
>>> jira_usr = config['jira']['username']
>>> jira_psw = config['jira']['password']
>>> jira_token = config['jira']['token']

Get fields

Next, you can get the issue's fields as follow:

>>> issue = jira.issue('TEST-1')
>>> print(issue.fields.status.name)
Triage
>>> print(issue.fields.description)
this is a demo jira ticket
>>> print(issue.fields.status.name)
Triage
>>> print(issue.fields.issuetype.name)
Bug

More fields

>>> print(issue.id)
1684517
>>> print(issue.key)
TEST-1
>>> print(issue.fields.assignee.key)
xpshen
>>> print(issue.fields.summary)
Jira REST API Unit Test Example
>>> ...

Install from PyPI

# install
$ pip install atlassian-api-py

# upgrade to latest
$ pip install atlassian-api-py --upgrade

Unittest and Coverage

Run unittest

cd tests
python -m unittest

Run coverage

cd tests
coverage run -m unittest
coverage report -m              # to report on the results
coverage html                   # to get annotated HTML

Changelog

Track some minor and micro changes.

• 0.3.18 - Oct 7, 2021 - Fixed issues in bitbucket and test_bitbucket and refactor.
• 0.3.17 - Oct 2, 2021 - Support establish connection with token and update README.md.
• 0.3.15 - Sep 9, 2021 - Fixed permission issue temporarily by changing file_handler to console_handler.
• 0.3.14 - Sep 9, 2021 - Fixed Permission denied: 'logs' issue.
• 0.3.13 - Sep 8, 2021 - Added create_issue in Jira.
• 0.3.12 - Sep 2, 2021 - Added u: in Jira.
• 0.3.11 - Aug 25, 2021 - Added get_pull_request_comments in Bitbucket.
• 0.3.9 - Aug 19, 2021 - Changed search_issue_with_sql to search_issue_with_jql.
• 0.3.8 - Aug 19, 2021 - Changed update_custom_field to support pass 3 or 4 params in Jira.
• 0.3.7 - June 9, 2021 - Added update_build_status in Bitbucket.
• 0.3.6 - June 9, 2021 - Added get_build_status in Bitbucket.
• 0.3.5 - June 8, 2021 - Added update_custom_field in Jira .
• 0.3.3 - June 4, 2021 - Added get_file_content in Bitbucket .
• 0.3.0 - May 9, 2021 - Fixed Bitbucket and test_bitbucket issues.
• 0.2.7 - Apr 20, 2021 - Added create task with components in Jira.
• 0.2.5 - Apr 20, 2021 - Added update_issue_component in Jira .
• 0.2.4 - Mar 28, 2021 - Added create_task and refactor code for Jira.
• 0.2.0 - Mar 9, 2021 - Changed API return from JSON data to Python object.

FAQ

Q1: Which Jira/BitBucket version I used to develop?

For Jira I used Jira v8.5.9 and Jira Cloud.

For BitBucket I used Bitbucket v5.13.1. not support Bitbucket cloud for now.

Q2: Are there any major changes?

From 0.2.0 - Mar 9, 2021, convert get JIra API data from dict to object, no longer compatible with past old versions.