2019-12-27 18:14:51 +09:00
|
|
|
|
from typing import TYPE_CHECKING, Optional, List
|
|
|
|
|
|
2020-01-26 21:19:22 +09:00
|
|
|
|
from yandex_music import YandexMusicObject
|
|
|
|
|
|
2019-12-27 18:14:51 +09:00
|
|
|
|
if TYPE_CHECKING:
|
Тайп хинты для Label, TrackPosition, Artist, ArtistAlbums, ArtistTracks, BriefInfo, Counts, Description, Link, Ratings, Vinyl, AlbumEvent, ArtistEvent, Day, Event, GeneratedPlaylist, TrackWithAds, Genre, Images, Title
2019-12-28 20:38:59 +09:00
|
|
|
|
from yandex_music import Client, Playlist
|
2019-12-27 18:14:51 +09:00
|
|
|
|
|
2019-05-16 04:38:39 +09:00
|
|
|
|
|
|
|
|
|
class GeneratedPlaylist(YandexMusicObject):
|
2020-01-27 22:57:32 +09:00
|
|
|
|
"""Класс, представляющий автоматически сгенерированный плейлист.
|
|
|
|
|
|
|
|
|
|
Note:
|
|
|
|
|
Известные значения `type`: `playlistOfTheDay`, `origin`, `recentTracks`, `neverHeard`, `podcasts`,
|
|
|
|
|
`missedLikes`.
|
2020-01-26 23:50:54 +09:00
|
|
|
|
|
|
|
|
|
Attributes:
|
2020-01-27 22:57:32 +09:00
|
|
|
|
type (:obj:`str`): Тип сгенерированного плейлиста.
|
|
|
|
|
ready (:obj:`bool`): Готовность плейлиста.
|
|
|
|
|
notify (:obj:`bool`): Уведомлён ли пользователь об обновлении содержания.
|
2020-03-22 06:29:34 +09:00
|
|
|
|
data (:obj:`yandex_music.Playlist`): Сгенерированный плейлист.
|
Добавлен новый класс LicenceTextPart.
Поля cheapest, title, family_sub, fb_image, fb_name, family, intro_period_duration, intro_price, start_period_duration, start_price, licence_text_parts для Product.
Поля storage_dir, duplicates для Album.
Поле subscribed для ArtistEvent.
Поле description для GeneratedPlaylist.
Поле genre для Event.
Поле show_in_regions для Genre.
Поле cover_uri для MixLink.
Поля og_description, top_artist для Playlist.
Поля full_image_url, mts_full_image_url для Station.
Документация и тесты к новым поля. #339
2020-06-07 05:48:32 +09:00
|
|
|
|
description (:obj:`list`): Описание TODO.
|
2020-03-22 08:04:39 +09:00
|
|
|
|
client (:obj:`yandex_music.Client`): Клиент Yandex Music.
|
2020-01-26 23:50:54 +09:00
|
|
|
|
|
|
|
|
|
Args:
|
2020-01-27 22:57:32 +09:00
|
|
|
|
type_ (:obj:`str`): Тип сгенерированного плейлиста.
|
|
|
|
|
ready (:obj:`bool`): Готовность плейлиста.
|
|
|
|
|
notify (:obj:`bool`): Уведомлён ли пользователь об обновлении содержания.
|
2020-03-22 06:29:34 +09:00
|
|
|
|
data (:obj:`yandex_music.Playlist`, optional): Сгенерированный плейлист.
|
Добавлен новый класс LicenceTextPart.
Поля cheapest, title, family_sub, fb_image, fb_name, family, intro_period_duration, intro_price, start_period_duration, start_price, licence_text_parts для Product.
Поля storage_dir, duplicates для Album.
Поле subscribed для ArtistEvent.
Поле description для GeneratedPlaylist.
Поле genre для Event.
Поле show_in_regions для Genre.
Поле cover_uri для MixLink.
Поля og_description, top_artist для Playlist.
Поля full_image_url, mts_full_image_url для Station.
Документация и тесты к новым поля. #339
2020-06-07 05:48:32 +09:00
|
|
|
|
description (:obj:`list`, optional): Описание TODO.
|
Удаление избыточной информации (#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 23:50:54 +09:00
|
|
|
|
**kwargs: Произвольные ключевые аргументы полученные от API.
|
|
|
|
|
"""
|
|
|
|
|
|
2021-02-03 21:28:10 +09:00
|
|
|
|
def __init__(
|
|
|
|
|
self,
|
|
|
|
|
type_: str,
|
|
|
|
|
ready: bool,
|
|
|
|
|
notify: bool,
|
|
|
|
|
data: Optional['Playlist'],
|
|
|
|
|
description: Optional[list] = None,
|
|
|
|
|
client: Optional['Client'] = None,
|
|
|
|
|
**kwargs,
|
|
|
|
|
) -> None:
|
2019-12-27 04:51:29 +09:00
|
|
|
|
self.type = type_
|
2019-05-16 04:38:39 +09:00
|
|
|
|
self.ready = ready
|
|
|
|
|
self.notify = notify
|
|
|
|
|
self.data = data
|
|
|
|
|
|
Добавлен новый класс LicenceTextPart.
Поля cheapest, title, family_sub, fb_image, fb_name, family, intro_period_duration, intro_price, start_period_duration, start_price, licence_text_parts для Product.
Поля storage_dir, duplicates для Album.
Поле subscribed для ArtistEvent.
Поле description для GeneratedPlaylist.
Поле genre для Event.
Поле show_in_regions для Genre.
Поле cover_uri для MixLink.
Поля og_description, top_artist для Playlist.
Поля full_image_url, mts_full_image_url для Station.
Документация и тесты к новым поля. #339
2020-06-07 05:48:32 +09:00
|
|
|
|
self.description = description
|
|
|
|
|
|
2019-05-16 04:38:39 +09:00
|
|
|
|
self.client = client
|
2019-11-10 03:11:43 +09:00
|
|
|
|
self._id_attrs = (self.type, self.ready, self.notify, self.data)
|
2019-05-16 04:38:39 +09:00
|
|
|
|
|
2020-05-16 04:14:44 +09:00
|
|
|
|
super().handle_unknown_kwargs(self, **kwargs)
|
|
|
|
|
|
2019-05-16 04:38:39 +09:00
|
|
|
|
@classmethod
|
Тайп хинты для Label, TrackPosition, Artist, ArtistAlbums, ArtistTracks, BriefInfo, Counts, Description, Link, Ratings, Vinyl, AlbumEvent, ArtistEvent, Day, Event, GeneratedPlaylist, TrackWithAds, Genre, Images, Title
2019-12-28 20:38:59 +09:00
|
|
|
|
def de_json(cls, data: dict, client: 'Client') -> Optional['GeneratedPlaylist']:
|
2020-01-26 22:17:09 +09:00
|
|
|
|
"""Десериализация объекта.
|
|
|
|
|
|
|
|
|
|
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.GeneratedPlaylist`: Автоматически сгенерированный плейлист.
|
2020-01-26 22:17:09 +09:00
|
|
|
|
"""
|
2019-05-16 04:38:39 +09:00
|
|
|
|
if not data:
|
|
|
|
|
return None
|
|
|
|
|
|
|
|
|
|
data = super(GeneratedPlaylist, cls).de_json(data, client)
|
|
|
|
|
from yandex_music import Playlist
|
2021-02-03 21:28:10 +09:00
|
|
|
|
|
2019-05-16 04:38:39 +09:00
|
|
|
|
data['data'] = Playlist.de_json(data.get('data'), client)
|
|
|
|
|
|
|
|
|
|
return cls(client=client, **data)
|
|
|
|
|
|
|
|
|
|
@classmethod
|
Тайп хинты для Label, TrackPosition, Artist, ArtistAlbums, ArtistTracks, BriefInfo, Counts, Description, Link, Ratings, Vinyl, AlbumEvent, ArtistEvent, Day, Event, GeneratedPlaylist, TrackWithAds, Genre, Images, Title
2019-12-28 20:38:59 +09:00
|
|
|
|
def de_list(cls, data: dict, client: 'Client') -> List['GeneratedPlaylist']:
|
2020-01-26 22:17:09 +09:00
|
|
|
|
"""Десериализация списка объектов.
|
|
|
|
|
|
|
|
|
|
Args:
|
|
|
|
|
data (:obj:`list`): Список словарей с полями и значениями десериализуемого объекта.
|
Удаление избыточной информации (#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:`list` из :obj:`yandex_music.GeneratedPlaylist`: Автоматически сгенерированные плейлисты.
|
2020-01-26 22:17:09 +09:00
|
|
|
|
"""
|
2019-05-16 04:38:39 +09:00
|
|
|
|
if not data:
|
|
|
|
|
return []
|
|
|
|
|
|
Добавлен новый класс LicenceTextPart.
Поля cheapest, title, family_sub, fb_image, fb_name, family, intro_period_duration, intro_price, start_period_duration, start_price, licence_text_parts для Product.
Поля storage_dir, duplicates для Album.
Поле subscribed для ArtistEvent.
Поле description для GeneratedPlaylist.
Поле genre для Event.
Поле show_in_regions для Genre.
Поле cover_uri для MixLink.
Поля og_description, top_artist для Playlist.
Поля full_image_url, mts_full_image_url для Station.
Документация и тесты к новым поля. #339
2020-06-07 05:48:32 +09:00
|
|
|
|
return [cls.de_json(generated_playlist, client) for generated_playlist in data]
|