What is it?
This package is used to provide a simple python interface for interacting with Atlassian products (Server, Data Center and Cloud) and apps from ecosystem (Portfolio, XRay). It is based on the official public Rest API documentation and private methods (+ xml+rpc, raw http request).
Documentation
How to Install?
From PyPI
$ pip install atlassian-python-apiFrom Source
Git clone repository
Use
pip install -r requirements.txtto install the required packagesor
pipenv install && pipenv install --dev
Examples
More examples in examples/ directory.
Here’s a short example of how to create a Confluence page:
from atlassian import Confluence
confluence = Confluence(
url='http://localhost:8090',
username='admin',
password='admin')
status = confluence.create_page(
space='DEMO',
title='This is the title',
body='This is the body. You can use <strong>HTML tags</strong>!')
print(status)And here’s another example of how to get issues from Jira using JQL Query:
from atlassian import Jira
jira = Jira(
url='http://localhost:8080',
username='admin',
password='admin')
JQL = 'project = DEMO AND status IN ("To Do", "In Progress") ORDER BY issuekey'
data = jira.jql(JQL)
print(data)Also, you can use the Bitbucket module e.g. for getting project list
from atlassian import Bitbucket
bitbucket = Bitbucket(
url='http://localhost:7990',
username='admin',
password='admin')
data = bitbucket.project_list()
print(data)Now you can use the Jira Service Desk module. See docs. Example to get your requests:
from atlassian import ServiceDesk
sd = ServiceDesk(
url='http://localhost:7990',
username='admin',
password='admin')
data = sd.get_my_customer_requests()
print(data)Using Xray (Test Management tool for Jira):
from atlassian import Xray
xr = Xray(
url='http://localhost:7990',
username='admin',
password='admin')
data = xr.get_tests('TEST-001')
print(data)If you want to see the response in pretty print format JSON. Feel free for use construction like:
from pprint import pprint
# you code here
# and then print using pprint(result) instead of print(result)
pprint(response)How to contribute?
First of all, I am happy for any PR requests. Let’s fork and provide your changes :) See the Contribution Guidelines for this project for details on how to make changes to this library.
Credits
In addition to all the contributors we would like to thank these vendors:
Release files for atlassian-python-api 3.8.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| atlassian-python-api-3.8.0.tar.gz | 118.1 kB | Details |
Release files / atlassian-python-api-3.8.0.tar.gz
| Download URL | atlassian-python-api-3.8.0.tar.gz |
|---|---|
| Size | 118.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7ef384a91a790c807336e2bd6b7554284691aadd6d7413d199baf752dd84c53e
|
|
BLAKE2b-256 checksum How to use checksums |
e1952906cf58bbeca1046a132b2fd2668739641cfe44340d80e7b43ad8d7abad
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
Python-urllib/2.7
|
