Yandex Tracker Client (or Yet Another Tracker Client)

Async Yandex Tracker Client based on aiohttp and pydantic

You can read API documentation for more information or API specification in OpenAPI format.

Installation

With pip:

pip install ya_tracker_client

With poetry:

poetry add ya_tracker_client

With uv:

uv add ya_tracker_client

Usage

import os
from asyncio import run

from dotenv import load_dotenv

from ya_tracker_client import YaTrackerClient


load_dotenv()
# from registered application at Yandex OAuth - https://oauth.yandex.ru/
API_TOKEN = os.getenv("API_TOKEN")
# from admin panel at Yandex Tracker - https://tracker.yandex.ru/admin/orgs
API_ORGANISATION_ID = os.getenv("API_ORGANISATION_ID")


async def main() -> None:
    # init client
    client = YaTrackerClient(
        organisation_id=API_ORGANISATION_ID,
        oauth_token=API_TOKEN,
    )

    # create issue
    new_issue = await client.create_issue('New issue', 'TRACKER-QUEUE')

     # get issue
    issue = await client.get_issue('KEY-1')

    # update issue (just pass kwargs)
    issue = await client.edit_issue('KEY-1', description='Hello World')

    # don't forget to close tracker on app shutdown
    await client.stop()


if __name__ == "__main__":
    run(main())

Explanations about naming

• All self properties renamed to url cause it's incompatible with Python;
• All camelCase properties renamed to pythonic_case;
• All datetime values converted to python's datetime.datetime objects;
• Methods named by author, cause Yandex API has no clear method names.

Current library capabilities

• Working with queues
• Getting information about issues, priorities and transitions
• Working with issue relationships
• Getting user information

More info about work status here: https://github.com/danfimov/ya_tracker_client/milestone/1