From ec4860b12e4774837468b1e4dc9db52f6f15fdf5 Mon Sep 17 00:00:00 2001 From: Gleb Liutsko Date: Sat, 14 Mar 2020 21:18:24 +0400 Subject: [PATCH 1/2] =?UTF-8?q?=D0=94=D0=BE=D0=BA=D1=83=D0=BC=D0=B5=D0=BD?= =?UTF-8?q?=D1=82=D0=B0=D1=86=D0=B8=D1=8F=20=D0=BA=D0=BB=D0=B0=D1=81=D1=81?= =?UTF-8?q?=D0=B0=20Playlist?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- yandex_music/playlist/playlist.py | 81 ++++++++++++++++++++++++++++++- 1 file changed, 79 insertions(+), 2 deletions(-) diff --git a/yandex_music/playlist/playlist.py b/yandex_music/playlist/playlist.py index acc3034..570f256 100644 --- a/yandex_music/playlist/playlist.py +++ b/yandex_music/playlist/playlist.py @@ -7,13 +7,90 @@ if TYPE_CHECKING: class Playlist(YandexMusicObject): - """Класс, представляющий . + """Класс, представляющий плейлист. + + Note: + Известные значения `visibility`: `public` - публичный плейлист, `private` - приватный плейлист. Attributes: + owner (:obj:`yandex_music.User`): Объект класса :class:`yandex_music.User`, представляющий владельца + плейлиста. + cover (:obj:`yandex_music.Cover`): Объект класса :class:`yandex_music.Cover`, представляющий обложку + альбома. + made_for (:obj:`yandex_music.MadeFor`): Объект класса :class:`yandex_music.MadeFor`, представляющий + пользователя для которого был создан плейлист. Присутствует только у персональных плейлистов. + play_counter (:obj:`yandex_music.PlayCounter`): Объект класса :class:`yandex_music.PlayCounter`, + представляющий счетчик дней. Присутствует только у плейлиста дня. + playlist_absence (:obj:`yandex_music.PlaylistAbsence`): Объект класса + :class:`yandex_music.PlaylistAbsence`, представляющий причину отсутствия плейлиста. + uid (:obj:`int`): Идентификатор владельца плейлиста. + kind (:obj:`int`): Идентификатор плейлиста. + title (:obj:`str`): Название плейлиста. + track_count (:obj:`int`): Количество треков. + tags (:obj:`list`): Список тегов плейлиста. + revision (:obj:`int`): Актуальность данных TODO. + snapshot (:obj:`int`): Версия плейлиста. Увеличивается на 1 при каждом изменении. + visibility (:obj:`str`): Видимость плейлиста. + collective (:obj:`bool`): Есть ли у плейлиста соавторы. + created (:obj:`str`): Дата создания в формате ISO 8601. + modified (:obj:`str`): Дата последнего изменения в формате ISO 8601. + available (:obj:`bool`): TODO + is_banner (:obj:`bool`): TODO + is_premiere (:obj:`bool`): TODO + duration_ms (:obj:`int`): Длительность в миллисекундах. + og_image (:obj:`str`): Ссылка на превью Open Graph. + tracks (:obj:`list` из :obj:`yandex_music.TrackShort`): Список треков. + prerolls (:obj:`list`): Прерол, проигрываемый перед плейлистом. Присутствует только у персональных + плейлистов. + likes_count (:obj:`int`): Количество лайков. + generated_playlist_type (:obj:`str`): Тип генерируемого плейлиста. + animated_cover_uri (:obj:`str`): Ссылка на анимированную обложку. + ever_played (:obj:`str`): Играл ли этот плейлист. Присутствует только у персональных плейлистов. TODO + description (:obj:`str`): Описание плейлиста с разметкой Markdown. + description_formatted (:obj:`str`): Описание плейлиста. Только текст, без разметки. + is_for_from: TODO + regions: TODO client (:obj:`yandex_music.Client`): Объект класса :class:`yandex_music.Client`, представляющий клиент - Yandex Music. + Yandex Music. Args: + owner (:obj:`yandex_music.User`, optional): Объект класса :class:`yandex_music.User`, представляющий владельца + плейлиста. + cover (:obj:`yandex_music.Cover`, optional): Объект класса :class:`yandex_music.Cover`, представляющий обложку + альбома. + made_for (:obj:`yandex_music.MadeFor`, optional): Объект класса :class:`yandex_music.MadeFor`, представляющий + пользователя для которого был создан плейлист. Присутствует только у персональных плейлистов. + play_counter (:obj:`yandex_music.PlayCounter`, optional): Объект класса :class:`yandex_music.PlayCounter`, + представляющий счетчик дней. Присутствует только у плейлиста дня. + playlist_absence (:obj:`yandex_music.PlaylistAbsence`, optional): Объект класса + :class:`yandex_music.PlaylistAbsence`, представляющий причину отсутствия плейлиста. + uid (:obj:`int`, optional): Идентификатор владельца плейлиста. + kind (:obj:`int`, optional): Идентификатор плейлиста. + title (:obj:`str`, optional): Название плейлиста. + track_count (:obj:`int`, optional): Количество треков. + tags (:obj:`list`, optional): Список тегов плейлиста. + revision (:obj:`int`, optional): Актуальность данных TODO. + snapshot (:obj:`int`, optional): Версия плейлиста. Увеличивается на 1 при каждом изменении. + visibility (:obj:`str`, optional): Видимость плейлиста. + collective (:obj:`bool`, optional): Есть ли у плейлиста соавторы. + created (:obj:`str`, optional): Дата создания в формате ISO 8601. + modified (:obj:`str`, optional): Дата последнего изменения в формате ISO 8601. + available (:obj:`bool`, optional): TODO + is_banner (:obj:`bool`, optional): TODO + is_premiere (:obj:`bool`, optional): TODO + duration_ms (:obj:`int`, optional): Длительность в миллисекундах. + og_image (:obj:`str`, optional): Ссылка на превью Open Graph. + tracks (:obj:`list` из :obj:`yandex_music.TrackShort`, optional): Список треков. + prerolls (:obj:`list`, optional): Прерол, проигрываемый перед плейлистом. Присутствует только у персональных + плейлистов. + likes_count (:obj:`int`, optional): Количество лайков. + generated_playlist_type (:obj:`str`, optional): Тип генерируемого плейлиста. + animated_cover_uri (:obj:`str`, optional): Ссылка на анимированную обложку. + ever_played (:obj:`str`, optional): Играл ли этот плейлист. Присутствует только у персональных плейлистов. TODO + description (:obj:`str`, optional): Описание плейлиста с разметкой Markdown. + description_formatted (:obj:`str`, optional): Описание плейлиста. Только текст, без разметки. + is_for_from: TODO + regions: TODO client (:obj:`yandex_music.Client`, optional): Объект класса :class:`yandex_music.Client`, представляющий клиент Yandex Music. **kwargs: Произвольные ключевые аргументы полученные от API. From e304cc3ab3665f366bee3f69094c5ab3e2ffa721 Mon Sep 17 00:00:00 2001 From: Gleb Liutsko Date: Sat, 21 Mar 2020 23:04:58 +0400 Subject: [PATCH 2/2] =?UTF-8?q?=D0=9F=D1=80=D0=B0=D0=B2=D0=BA=D0=B0=20?= =?UTF-8?q?=D0=B4=D0=BE=D0=BA=D1=83=D0=BC=D0=B5=D0=BD=D1=82=D0=B0=D1=86?= =?UTF-8?q?=D0=B8=D0=B8=20=D0=BA=D0=BB=D0=B0=D1=81=D1=81=D0=B0=20Playlist?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Добавлены известные значения generated_playlist_type Именено описание некоторых аттрибутов Точки в конце --- yandex_music/playlist/playlist.py | 23 +++++++++++++---------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/yandex_music/playlist/playlist.py b/yandex_music/playlist/playlist.py index 570f256..fbcedd5 100644 --- a/yandex_music/playlist/playlist.py +++ b/yandex_music/playlist/playlist.py @@ -12,6 +12,9 @@ class Playlist(YandexMusicObject): Note: Известные значения `visibility`: `public` - публичный плейлист, `private` - приватный плейлист. + Известные значения `generated_playlist_type`: `playlistOfTheDay` - Плейлист дня, `recentTracks` - Премьера, + `neverHeard` - Дежавю, `podcasts` - Подкасты недели, `missedLikes` - Тайник, `origin` - Плейлист с Алисой. + Attributes: owner (:obj:`yandex_music.User`): Объект класса :class:`yandex_music.User`, представляющий владельца плейлиста. @@ -34,9 +37,9 @@ class Playlist(YandexMusicObject): collective (:obj:`bool`): Есть ли у плейлиста соавторы. created (:obj:`str`): Дата создания в формате ISO 8601. modified (:obj:`str`): Дата последнего изменения в формате ISO 8601. - available (:obj:`bool`): TODO - is_banner (:obj:`bool`): TODO - is_premiere (:obj:`bool`): TODO + available (:obj:`bool`): Доступен TODO. + is_banner (:obj:`bool`): Является ли банером TODO. + is_premiere (:obj:`bool`): Является ли премьерой TODO. duration_ms (:obj:`int`): Длительность в миллисекундах. og_image (:obj:`str`): Ссылка на превью Open Graph. tracks (:obj:`list` из :obj:`yandex_music.TrackShort`): Список треков. @@ -48,8 +51,8 @@ class Playlist(YandexMusicObject): ever_played (:obj:`str`): Играл ли этот плейлист. Присутствует только у персональных плейлистов. TODO description (:obj:`str`): Описание плейлиста с разметкой Markdown. description_formatted (:obj:`str`): Описание плейлиста. Только текст, без разметки. - is_for_from: TODO - regions: TODO + is_for_from: TODO. + regions: Регион TODO. client (:obj:`yandex_music.Client`): Объект класса :class:`yandex_music.Client`, представляющий клиент Yandex Music. @@ -75,9 +78,9 @@ class Playlist(YandexMusicObject): collective (:obj:`bool`, optional): Есть ли у плейлиста соавторы. created (:obj:`str`, optional): Дата создания в формате ISO 8601. modified (:obj:`str`, optional): Дата последнего изменения в формате ISO 8601. - available (:obj:`bool`, optional): TODO - is_banner (:obj:`bool`, optional): TODO - is_premiere (:obj:`bool`, optional): TODO + available (:obj:`bool`, optional): Доступен TODO. + is_banner (:obj:`bool`, optional): Является ли банером TODO. + is_premiere (:obj:`bool`, optional): Является ли премьерой TODO. duration_ms (:obj:`int`, optional): Длительность в миллисекундах. og_image (:obj:`str`, optional): Ссылка на превью Open Graph. tracks (:obj:`list` из :obj:`yandex_music.TrackShort`, optional): Список треков. @@ -89,8 +92,8 @@ class Playlist(YandexMusicObject): ever_played (:obj:`str`, optional): Играл ли этот плейлист. Присутствует только у персональных плейлистов. TODO description (:obj:`str`, optional): Описание плейлиста с разметкой Markdown. description_formatted (:obj:`str`, optional): Описание плейлиста. Только текст, без разметки. - is_for_from: TODO - regions: TODO + is_for_from: TODO. + regions: Регион TODO. client (:obj:`yandex_music.Client`, optional): Объект класса :class:`yandex_music.Client`, представляющий клиент Yandex Music. **kwargs: Произвольные ключевые аргументы полученные от API.