yandex_music.utils.request#

class yandex_music.utils.request.Request(client=None, headers=None, proxy_url=None)#

Bases: object

Вспомогательный класс для yandex_music, представляющий методы для выполнения POST и GET запросов, скачивания файлов.

Parameters

  • client (yandex_music.Client, optional) – Клиент Yandex Music.

  • headers (dict, optional) – Заголовки передаваемые с каждым запросом.

  • proxy_url (str, optional) – Прокси.

download(url, filename, timeout=5, *args, **kwargs) → None#

Отправка запроса на получение содержимого и его запись в файл.

Parameters

  • url (str) – Адрес для запроса.

  • filename (str) – Путь и(или) название файла вместе с расширением.

  • timeout (int | float) – Используется как время ожидания ответа от сервера вместо указанного при создании пула.

  • *args – Произвольные аргументы для requests.request.

  • **kwargs – Произвольные ключевые аргументы для requests.request.

Raises

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

get(url: str, params: Optional[dict] = None, timeout: Union[int, float] = 5, *args, **kwargs) → Union[dict, str]#

Отправка GET запроса.

Parameters

  • url (str) – Адрес для запроса.

  • params (str) – GET параметры для запроса.

  • timeout (int | float) – Используется как время ожидания ответа от сервера вместо указанного при создании пула.

  • *args – Произвольные аргументы для requests.request.

  • **kwargs – Произвольные ключевые аргументы для requests.request.

Returns

Обработанное тело ответа.

Return type

dict | str

Raises

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

post(url, data=None, timeout=5, *args, **kwargs) → Union[dict, str]#

Отправка POST запроса.

Parameters

  • url (str) – Адрес для запроса.

  • data (str) – POST тело запроса.

  • timeout (int | float) – Используется как время ожидания ответа от сервера вместо указанного при создании пула.

  • *args – Произвольные аргументы для requests.request.

  • **kwargs – Произвольные ключевые аргументы для requests.request.

Returns

Обработанное тело ответа.

Return type

dict | str

Raises

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

retrieve(url, timeout=5, *args, **kwargs) → bytes#

Отправка GET запроса и получение содержимого без обработки (парсинга).

Parameters

  • url (str) – Адрес для запроса.

  • timeout (int | float) – Используется как время ожидания ответа от сервера вместо указанного при создании пула.

  • *args – Произвольные аргументы для requests.request.

  • **kwargs – Произвольные ключевые аргументы для requests.request.

Returns

Тело ответа.

Return type

bytes

Raises

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

set_and_return_client(client) → Client#

Принимает клиент и присваивает его текущему объекту. При наличии авторизации добавляет заголовок.

Parameters

client (yandex_music.Client) – Клиент Yandex Music.

Returns

Клиент Yandex Music.

Return type

yandex_music.Client

set_authorization(token: str) → None#

Добавляет заголовок авторизации для каждого запроса.

Note

Используется при передаче своего экземпляра Request’a клиенту.

Parameters

token (str) – OAuth токен.

set_language(lang: str) → None#

Добавляет заголовок языка для каждого запроса.

Note

Возможные значения lang: en/uz/uk/us/ru/kk/hy.

Parameters

lang (str) – Язык.