https://github.com/isaccanedo/atlassian-python-api

:rocket: Atlassian Python REST API wrapper
https://github.com/isaccanedo/atlassian-python-api

advanced-roadmaps api atlassian atlassian-jira bamboo bitbucket confluence crowd hacktoberfest jira jira-service-desk python rest tempo xray

Last synced: 7 months ago
JSON representation

:rocket: Atlassian Python REST API wrapper

• Host: GitHub
• URL: https://github.com/isaccanedo/atlassian-python-api
• Owner: isaccanedo
• License: apache-2.0
• Created: 2024-05-11T17:30:13.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2024-05-13T01:34:38.000Z (over 1 year ago)
• Last Synced: 2025-01-12T06:43:15.754Z (9 months ago)
• Topics: advanced-roadmaps, api, atlassian, atlassian-jira, bamboo, bitbucket, confluence, crowd, hacktoberfest, jira, jira-service-desk, python, rest, tempo, xray
• Language: Python
• Homepage: https://atlassian-python-api.readthedocs.io/
• Size: 321 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
============================

Atlassian Python API wrapper

============================

|Build Status| |PyPI version| |PyPI - Downloads| |License| |Codacy Badge| |Docs| |Discord|

What is it???

___________

The **atlassian-python-api** library provides a **simple** and convenient way to interact with Atlassian products

(such as Jira Service management, Jira Software, Confluence, Bitbucket and apps Insight, X-Ray) using Python.

It is based on the official REST APIs of these products, as well as additional private methods and protocols

(such as xml+rpc and raw HTTP requests).

This library can be used to automate tasks, integrate with other tools and systems,

and build custom applications that interact with Atlassian products.

It supports a wide range of Atlassian products, including Jira, Confluence, Bitbucket, StatusPage and others,

and is compatible with both Atlassian Server and Cloud instances.

Overall, the **atlassian-python-api** is a useful tool for Python developers who want to work with Atlassian products.

It is well-documented and actively maintained, and provides a convenient way to access the full range of

functionality offered by the Atlassian REST APIs.

Documentation

_____________

`Documentation`_

.. _Documentation: https://atlassian-python-api.readthedocs.io

How to Install?

_______________

From PyPI

.. code-block:: console

   $ pip install atlassian-python-api

From Source

- Git clone repository

- Use :code:`pip install -r requirements.txt` to install the required packages

- or :code:`pipenv install && pipenv install --dev`

Examples

________

More **examples** in :code:`examples/` directory.

Here's a short example of how to create a Confluence page:

.. code-block:: python

    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 HTML tags!')

    print(status)

Please, note Confluence Cloud need to be used via token parameter.

And here's another example of how to get issues from Jira using JQL Query:

.. code-block:: python

    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

.. code-block:: python

    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:

.. code-block:: python

    from atlassian import ServiceDesk

    sd = ServiceDesk(

            url='http://localhost:7990',

            username='admin',

            password='admin')

    data = sd.get_my_customer_requests()

    print(data)

Using Insight (CMDB Tool for Jira):

.. code-block:: python

    from atlassian import Insight

    insight = Insight(

            url='http://localhost:7990',

            username='admin',

            password='admin')

    data = insight.get_object(88)

    print(data)

Using Xray (Test Management tool for Jira):

.. code-block:: python

    from atlassian import Xray

    xr = Xray(

           url='http://localhost:7990',

            username='admin',

            password='admin')

    data = xr.get_tests('TEST-001')

    print(data)

Using Bamboo:

.. code-block:: python

    from atlassian import Bamboo

    bamboo = Bamboo(

            url='http://localhost:6990/bamboo/',

            token="")

    data = bamboo.get_elastic_configurations()

    print(data)

If you want to see the response in pretty print format JSON. Feel free for use construction like:

.. code-block:: python

    from pprint import pprint

    # you code here

    # and then print using pprint(result) instead of print(result)

    pprint(response)