2020-03-24 17:42:47 +09:00
|
|
|
|
import logging
|
2020-01-26 22:17:09 +09:00
|
|
|
|
import builtins
|
2019-05-07 06:02:21 +09:00
|
|
|
|
from abc import ABCMeta
|
2020-01-26 22:17:09 +09:00
|
|
|
|
from typing import TYPE_CHECKING, Optional
|
2019-05-07 06:02:21 +09:00
|
|
|
|
|
2020-01-26 22:17:09 +09:00
|
|
|
|
if TYPE_CHECKING:
|
|
|
|
|
from yandex_music import Client
|
2019-12-27 05:27:58 +09:00
|
|
|
|
|
Добавлены тайп хинты в соответствии с документацией для следуюшщих классов: YandexMusicObject, Cover, Captcha, DownloadInfo, Experiments, Icon, InvocationInfo, Pager, PermissionAlerts, PromoCodeStatus, Settings, TrackShort, TracksList, Video #120
2019-12-24 16:17:04 +09:00
|
|
|
|
ujson: bool = False
|
2019-12-23 18:07:11 +09:00
|
|
|
|
try:
|
|
|
|
|
import ujson as json
|
2020-01-26 22:17:09 +09:00
|
|
|
|
|
2019-12-23 18:07:11 +09:00
|
|
|
|
ujson = True
|
|
|
|
|
except ImportError:
|
|
|
|
|
import json
|
|
|
|
|
|
2019-12-27 05:27:58 +09:00
|
|
|
|
reserved_names = [name.lower() for name in dir(builtins)]
|
|
|
|
|
|
2020-03-24 17:42:47 +09:00
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
new_issue_by_template_url = 'https://bit.ly/3dsFxyH'
|
|
|
|
|
|
2019-05-07 06:02:21 +09:00
|
|
|
|
|
2019-08-18 18:54:13 +09:00
|
|
|
|
class YandexMusicObject:
|
2019-05-07 06:02:21 +09:00
|
|
|
|
__metaclass__ = ABCMeta
|
Добавлены тайп хинты в соответствии с документацией для следуюшщих классов: YandexMusicObject, Cover, Captcha, DownloadInfo, Experiments, Icon, InvocationInfo, Pager, PermissionAlerts, PromoCodeStatus, Settings, TrackShort, TracksList, Video #120
2019-12-24 16:17:04 +09:00
|
|
|
|
_id_attrs: tuple = ()
|
2020-03-23 01:09:45 +09:00
|
|
|
|
|
Добавлены тайп хинты в соответствии с документацией для следуюшщих классов: YandexMusicObject, Cover, Captcha, DownloadInfo, Experiments, Icon, InvocationInfo, Pager, PermissionAlerts, PromoCodeStatus, Settings, TrackShort, TracksList, Video #120
2019-12-24 16:17:04 +09:00
|
|
|
|
def __str__(self) -> str:
|
2019-05-07 06:02:21 +09:00
|
|
|
|
return str(self.to_dict())
|
|
|
|
|
|
Добавлены тайп хинты в соответствии с документацией для следуюшщих классов: YandexMusicObject, Cover, Captcha, DownloadInfo, Experiments, Icon, InvocationInfo, Pager, PermissionAlerts, PromoCodeStatus, Settings, TrackShort, TracksList, Video #120
2019-12-24 16:17:04 +09:00
|
|
|
|
def __repr__(self) -> str:
|
2019-05-15 05:38:15 +09:00
|
|
|
|
return str(self)
|
|
|
|
|
|
2019-05-07 06:02:21 +09:00
|
|
|
|
def __getitem__(self, item):
|
|
|
|
|
return self.__dict__[item]
|
|
|
|
|
|
2020-06-07 21:56:37 +09:00
|
|
|
|
@staticmethod
|
|
|
|
|
def report_new_fields_callback(obj, new_fields):
|
|
|
|
|
logger.warning(f'Found unknown fields received from API! Please copy warn message '
|
|
|
|
|
f'and send to {new_issue_by_template_url} (github issue), thank you!')
|
|
|
|
|
logger.warning(f'Type: {type(obj)}; kwargs: {new_fields}')
|
|
|
|
|
|
2020-03-24 17:42:47 +09:00
|
|
|
|
@staticmethod
|
|
|
|
|
def handle_unknown_kwargs(obj, **kwargs):
|
2020-05-16 04:14:44 +09:00
|
|
|
|
if kwargs and obj.client.report_new_fields:
|
2020-06-07 21:56:37 +09:00
|
|
|
|
obj.client.report_new_fields_callback(obj, kwargs)
|
2020-03-24 17:42:47 +09:00
|
|
|
|
|
2019-05-07 06:02:21 +09:00
|
|
|
|
@classmethod
|
2020-01-26 22:17:09 +09:00
|
|
|
|
def de_json(cls, data: dict, client: Optional['Client']) -> Optional[dict]:
|
|
|
|
|
"""Десериализация объекта.
|
|
|
|
|
|
|
|
|
|
Args:
|
|
|
|
|
data (:obj:`dict`): Поля и значения десериализуемого объекта.
|
Удаление избыточной информации (#247)
Классы: Account, AutoRenewable, PassportPhone, Permissions, Plus, Price,
Product, Status, Subscription, UserSettings, Album, Label,
TrackPosition, Playlist
У всех классов изменено описание атрибута client
2020-03-22 04:49:20 +09:00
|
|
|
|
client (:obj:`yandex_music.Client`, optional): Клиент Yandex Music.
|
2020-01-26 22:17:09 +09:00
|
|
|
|
|
|
|
|
|
Returns:
|
2020-03-22 06:29:34 +09:00
|
|
|
|
:obj:`yandex_music.YandexMusicObject` | :obj:`None`: :obj:`yandex_music.YandexMusicObject` или :obj:`None`.
|
2020-01-26 22:17:09 +09:00
|
|
|
|
"""
|
2019-05-07 06:02:21 +09:00
|
|
|
|
if not data:
|
|
|
|
|
return None
|
|
|
|
|
|
|
|
|
|
data = data.copy()
|
|
|
|
|
|
|
|
|
|
return data
|
|
|
|
|
|
Добавлены тайп хинты в соответствии с документацией для следуюшщих классов: YandexMusicObject, Cover, Captcha, DownloadInfo, Experiments, Icon, InvocationInfo, Pager, PermissionAlerts, PromoCodeStatus, Settings, TrackShort, TracksList, Video #120
2019-12-24 16:17:04 +09:00
|
|
|
|
def to_json(self) -> str:
|
2020-03-23 01:09:45 +09:00
|
|
|
|
"""Сериализация объекта.
|
|
|
|
|
|
|
|
|
|
Returns:
|
|
|
|
|
:obj:`str`: Сериализованный в JSON объект.
|
|
|
|
|
"""
|
2019-12-23 18:07:11 +09:00
|
|
|
|
return json.dumps(self.to_dict(), ensure_ascii=not ujson)
|
2019-05-07 06:02:21 +09:00
|
|
|
|
|
Добавлены тайп хинты в соответствии с документацией для следуюшщих классов: YandexMusicObject, Cover, Captcha, DownloadInfo, Experiments, Icon, InvocationInfo, Pager, PermissionAlerts, PromoCodeStatus, Settings, TrackShort, TracksList, Video #120
2019-12-24 16:17:04 +09:00
|
|
|
|
def to_dict(self) -> dict:
|
2020-03-23 01:09:45 +09:00
|
|
|
|
"""Рекурсивная сериализация объекта.
|
|
|
|
|
|
|
|
|
|
Note:
|
|
|
|
|
Исключает из сериализации `client` и `_id_attrs` необходимые в `__eq__`.
|
|
|
|
|
|
|
|
|
|
К зарезервированным именам добавляет "_" в конец.
|
|
|
|
|
|
|
|
|
|
Returns:
|
|
|
|
|
:obj:`dict`: Сериализованный в dict объект.
|
|
|
|
|
"""
|
Добавлены основные тесты для следующих классов: AlbumEvent, AlbumsLikes, ArtistEvent, ArtistsLikes, ChartItem, Dashboard, Day, Event, Sequence, StationTracksResult, Supplement, TrackWithAds.
Исправлены фикстуры и сравнения для вышеперечисленных классов.
Отрефакторен conftest.py.
Исправлен баг в .to_dict() методе, связанный с не рекурсивной десериализацией объектов списков и словарей.
Исправлен баг с десериализацией artist в классе ArtistEvent
2019-11-09 22:43:02 +09:00
|
|
|
|
def parse(val):
|
|
|
|
|
if hasattr(val, 'to_dict'):
|
|
|
|
|
return val.to_dict()
|
|
|
|
|
elif isinstance(val, list):
|
|
|
|
|
return [parse(it) for it in val]
|
|
|
|
|
elif isinstance(val, dict):
|
2020-01-26 21:19:22 +09:00
|
|
|
|
return {key: parse(value) for key, value in val.items()}
|
Добавлены основные тесты для следующих классов: AlbumEvent, AlbumsLikes, ArtistEvent, ArtistsLikes, ChartItem, Dashboard, Day, Event, Sequence, StationTracksResult, Supplement, TrackWithAds.
Исправлены фикстуры и сравнения для вышеперечисленных классов.
Отрефакторен conftest.py.
Исправлен баг в .to_dict() методе, связанный с не рекурсивной десериализацией объектов списков и словарей.
Исправлен баг с десериализацией artist в классе ArtistEvent
2019-11-09 22:43:02 +09:00
|
|
|
|
else:
|
|
|
|
|
return val
|
|
|
|
|
|
|
|
|
|
data = self.__dict__.copy()
|
|
|
|
|
data.pop('client', None)
|
|
|
|
|
data.pop('_id_attrs', None)
|
|
|
|
|
|
2019-12-27 05:27:58 +09:00
|
|
|
|
for k, v in data.copy().items():
|
|
|
|
|
if k.lower() in reserved_names:
|
|
|
|
|
data.pop(k)
|
|
|
|
|
data.update({f'{k}_': v})
|
|
|
|
|
|
Добавлены основные тесты для следующих классов: AlbumEvent, AlbumsLikes, ArtistEvent, ArtistsLikes, ChartItem, Dashboard, Day, Event, Sequence, StationTracksResult, Supplement, TrackWithAds.
Исправлены фикстуры и сравнения для вышеперечисленных классов.
Отрефакторен conftest.py.
Исправлен баг в .to_dict() методе, связанный с не рекурсивной десериализацией объектов списков и словарей.
Исправлен баг с десериализацией artist в классе ArtistEvent
2019-11-09 22:43:02 +09:00
|
|
|
|
return parse(data)
|
2019-05-07 06:02:21 +09:00
|
|
|
|
|
Добавлены тайп хинты в соответствии с документацией для следуюшщих классов: YandexMusicObject, Cover, Captcha, DownloadInfo, Experiments, Icon, InvocationInfo, Pager, PermissionAlerts, PromoCodeStatus, Settings, TrackShort, TracksList, Video #120
2019-12-24 16:17:04 +09:00
|
|
|
|
def __eq__(self, other) -> bool:
|
2020-03-23 01:09:45 +09:00
|
|
|
|
"""Проверка на равенство двух объектов.
|
|
|
|
|
|
|
|
|
|
Note:
|
|
|
|
|
Проверка осуществляется по определённым атрибутам классов, перечисленных в множестве `_id_attrs`.
|
|
|
|
|
|
|
|
|
|
Returns:
|
|
|
|
|
:obj:`bool`: Одинаковые ли объекты (по содержимому).
|
|
|
|
|
"""
|
2019-05-07 06:02:21 +09:00
|
|
|
|
if isinstance(other, self.__class__):
|
|
|
|
|
return self._id_attrs == other._id_attrs
|
|
|
|
|
return super(YandexMusicObject, self).__eq__(other)
|
|
|
|
|
|
2020-03-23 01:09:45 +09:00
|
|
|
|
def __hash__(self) -> int:
|
|
|
|
|
"""Реализация хеш-функции на основе ключевых атрибутов.
|
|
|
|
|
|
|
|
|
|
Note:
|
|
|
|
|
Так как перечень ключевых атрибутов хранится в виде множества, для вычисления хеша он замораживается.
|
|
|
|
|
|
|
|
|
|
Returns:
|
|
|
|
|
:obj:`int`: Хеш объекта.
|
|
|
|
|
"""
|
2019-05-07 06:02:21 +09:00
|
|
|
|
if self._id_attrs:
|
2019-11-10 03:11:43 +09:00
|
|
|
|
frozen_attrs = tuple(frozenset(attr) if isinstance(attr, list) else attr for attr in self._id_attrs)
|
|
|
|
|
return hash((self.__class__, frozen_attrs))
|
2019-05-07 06:02:21 +09:00
|
|
|
|
return super(YandexMusicObject, self).__hash__()
|