102 行
3.7 KiB
Python
102 行
3.7 KiB
Python
from yandex_music import YandexMusicObject
|
||
|
||
|
||
class TrackShort(YandexMusicObject):
|
||
"""Класс представляющий укороченную версию трека с неполными данными.
|
||
|
||
Attributes:
|
||
id (:obj:`str`): Уникальный идентификатор трека.
|
||
timestamp (:obj:`str`): Дата TODO.
|
||
album_id (:obj:`str`): Уникальный идентификатор альбома.
|
||
client (:obj:`yandex_music.Client`): Объект класса :class:`yandex_music.Client` представляющий клиент Yandex
|
||
Music.
|
||
|
||
Args:
|
||
id (:obj:`str`): Уникальный идентификатор трека.
|
||
timestamp (:obj:`str`): Дата TODO.
|
||
album_id (:obj:`str`, optional): Уникальный идентификатор альбома.
|
||
client (:obj:`yandex_music.Client`, optional): Объект класса :class:`yandex_music.Client` представляющий клиент
|
||
Yandex Music.
|
||
**kwargs: Произвольные ключевые аргументы полученные от API.
|
||
"""
|
||
|
||
def __init__(self,
|
||
id,
|
||
timestamp,
|
||
album_id=None,
|
||
client=None,
|
||
**kwargs):
|
||
self.id = id
|
||
self.timestamp = timestamp
|
||
|
||
self.album_id = album_id
|
||
|
||
self._track = None
|
||
|
||
self.client = client
|
||
self._id_attrs = (self.id, self.album_id)
|
||
|
||
@property
|
||
def track(self):
|
||
""":obj:`yandex_music.Track`: Объект класса :class:`yandex_music.Track` представляющий полную версию трека."""
|
||
if self._track:
|
||
return self._track
|
||
|
||
self._track = self.client.tracks(self.track_id)[0]
|
||
|
||
return self._track
|
||
|
||
@property
|
||
def track_id(self):
|
||
""":obj:`str`: Уникальный идентификатор трека состоящий из его номера и номера альбома или просто из номера."""
|
||
|
||
if self.album_id:
|
||
return f'{self.id}:{self.album_id}'
|
||
|
||
return f'{self.id}'
|
||
|
||
@classmethod
|
||
def de_json(cls, data, client):
|
||
"""Десериализация объекта.
|
||
|
||
Args:
|
||
data (:obj:`dict`): Поля и значения десериализуемого объекта.
|
||
client (:obj:`yandex_music.Client`): Объект класса :class:`yandex_music.Client` представляющий клиент Yandex
|
||
Music.
|
||
|
||
Returns:
|
||
:obj:`yandex_music.TrackShort`: Объект класса :class:`yandex_music.TrackShort`.
|
||
"""
|
||
if not data:
|
||
return None
|
||
|
||
data = super(TrackShort, cls).de_json(data, client)
|
||
|
||
return cls(client=client, **data)
|
||
|
||
@classmethod
|
||
def de_list(cls, data, client):
|
||
"""Десериализация списка объектов.
|
||
|
||
Args:
|
||
data (:obj:`list`): Список словарей с полями и значениями десериализуемого объекта.
|
||
client (:obj:`yandex_music.Client`): Объект класса :class:`yandex_music.Client` представляющий клиент Yandex
|
||
Music.
|
||
|
||
Returns:
|
||
:obj:`list` из :obj:`yandex_music.TrackShort`: Список объектов класса :class:`yandex_music.TrackShort`.
|
||
"""
|
||
if not data:
|
||
return []
|
||
|
||
tracks = list()
|
||
for track in data:
|
||
tracks.append(cls.de_json(track, client))
|
||
|
||
return tracks
|
||
|
||
# camelCase псевдонимы
|
||
|
||
#: Псевдоним для :attr:`track_id`
|
||
trackId = track_id
|