diff --git a/docs/source/yandex_music.exceptions.rst b/docs/source/yandex_music.exceptions.rst new file mode 100644 index 0000000..6ab8d7f --- /dev/null +++ b/docs/source/yandex_music.exceptions.rst @@ -0,0 +1,53 @@ +yandex_music.exceptions +======================= + +.. autoclass:: yandex_music.exceptions.YandexMusicError + :members: + :undoc-members: + :show-inheritance: + +.. autoclass:: yandex_music.exceptions.InvalidToken + :members: + :undoc-members: + :show-inheritance: + +.. autoclass:: yandex_music.exceptions.Unauthorized + :members: + :undoc-members: + :show-inheritance: + +.. autoclass:: yandex_music.exceptions.InvalidBitrate + :members: + :undoc-members: + :show-inheritance: + +.. autoclass:: yandex_music.exceptions.Captcha + :members: + :undoc-members: + :show-inheritance: + +.. autoclass:: yandex_music.exceptions.CaptchaRequired + :members: + :undoc-members: + :show-inheritance: + +.. autoclass:: yandex_music.exceptions.CaptchaWrong + :members: + :undoc-members: + :show-inheritance: + +.. autoclass:: yandex_music.exceptions.NetworkError + :members: + :undoc-members: + :show-inheritance: + +.. autoclass:: yandex_music.exceptions.BadRequest + :members: + :undoc-members: + :show-inheritance: + +.. autoclass:: yandex_music.exceptions.TimedOut + :members: + :undoc-members: + :show-inheritance: + diff --git a/docs/source/yandex_music.rst b/docs/source/yandex_music.rst index 8b400c5..6d075ad 100644 --- a/docs/source/yandex_music.rst +++ b/docs/source/yandex_music.rst @@ -8,6 +8,7 @@ yandex_music.cover yandex_music.download_info yandex_music.experiments + yandex_music.exceptions yandex_music.icon yandex_music.invocation_info yandex_music.pager diff --git a/yandex_music/utils/request.py b/yandex_music/utils/request.py index e8666c5..649d678 100644 --- a/yandex_music/utils/request.py +++ b/yandex_music/utils/request.py @@ -14,7 +14,7 @@ import requests from yandex_music.utils.captcha_response import CaptchaResponse from yandex_music.utils.response import Response from yandex_music.exceptions import Unauthorized, BadRequest, NetworkError, YandexMusicError, CaptchaRequired, \ - CaptchaWrong + CaptchaWrong, TimedOut if TYPE_CHECKING: from yandex_music import Client @@ -164,7 +164,7 @@ class Request: :obj:`yandex_music.utils.response.Response`: Ответ API. Raises: - :class:`TimeoutError`: При превышении времени ожидания. + :class:`yandex_music.exceptions.TimedOut`: При превышении времени ожидания. :class:`yandex_music.exceptions.Unauthorized`: При невалидном токене, долгом ожидании прямой ссылки на файл. :class:`yandex_music.exceptions.BadRequest`: При неправильном запросе. :class:`yandex_music.exceptions.NetworkError`: При проблемах с сетью. @@ -179,7 +179,7 @@ class Request: try: resp = requests.request(*args, **kwargs) except requests.Timeout: - raise TimeoutError() + raise TimedOut() except requests.RequestException as e: raise NetworkError(e) @@ -219,7 +219,6 @@ class Request: :obj:`yandex_music.utils.response.Response`: Ответ API. Raises: - :class:`TimeoutError`: При превышении времени ожидания. :class:`yandex_music.exceptions.YandexMusicError`: Базовое исключение библиотеки. """ result = self._request_wrapper('GET', url, params=params, headers=self.headers, proxies=self.proxies, @@ -242,7 +241,6 @@ class Request: :obj:`yandex_music.utils.response.Response`: Ответ API. Raises: - :class:`TimeoutError`: При превышении времени ожидания. :class:`yandex_music.exceptions.YandexMusicError`: Базовое исключение библиотеки. """ result = self._request_wrapper('POST', url, headers=self.headers, proxies=self.proxies, data=data, @@ -264,7 +262,6 @@ class Request: :obj:`Response`: Экземляр объекта ответа библиотеки `requests`. Raises: - :class:`TimeoutError`: При превышении времени ожидания. :class:`yandex_music.exceptions.YandexMusicError`: Базовое исключение библиотеки. """ return self._request_wrapper('GET', url, proxies=self.proxies, timeout=timeout, *args, **kwargs) @@ -281,7 +278,6 @@ class Request: **kwargs: Произвольные ключевые аргументы для `requests.request`. Raises: - :class:`TimeoutError`: При превышении времени ожидания. :class:`yandex_music.exceptions.YandexMusicError`: Базовое исключение библиотеки. """ result = self.retrieve(url, timeout=timeout, *args, *kwargs)