yandex-music-api/docs/source/client_async.md

1.7 KiB
Raw Blame 履歴

Асинхронный клиент

Приступив к работе первым делом необходимо создать экземпляр клиента.

Инициализация асинхронного клиента:

from yandex_music import ClientAsync

client = ClientAsync()
await client.init()

# или

client = await Client().init()

После успешного создания клиента вы вольны в выборе необходимого метода из API. Все они доступны у объекта класса ClientAsync и описаны ниже. Используйте навигацию из меню справа для быстрого доступа.

Особенности использования асинхронного клиента

При работе с асинхронной версией библиотеке стоит всегда помнить следующие особенности:

  • Клиент следует импортировать с названием ClientAsync, а не просто Client.
  • При использовании методов-сокращений нужно выбирать метод с суффиксом _async.

Пояснение ко второму пункту:

from yandex_music import ClientAsync

client = await ClientAsync('token').init()
liked_short_track = (await client.users_likes_tracks())[0]

# правильно
full_track = await liked_short_track.fetch_track_async()
await full_track.download_async()

# НЕПРАВИЛЬНО
full_track = await liked_short_track.fetch_track()
await full_track.download()
.. include:: yandex_music.client_async.rst