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:
|
2020-05-07 17:09:12 +09:00
|
|
|
|
from yandex_music import Client, User, Cover, MadeFor, TrackShort, PlaylistAbsence, PlayCounter,\
|
Добавлены новые классы: Brand, Contest, OpenGraphData.
Поля contest, dummy_description, dummy_page_description, dummy_cover, dummy_rollover_cover, og_data, branding классу Playlist.
Добавлена информацию по поводу запуска потока по треку, плейлисту и т.д.
Документация и тесты к новым полям, классам #339
2020-06-15 04:11:38 +09:00
|
|
|
|
PlaylistRecommendations, Artist, TrackId, Contest, OpenGraphData, Brand
|
2019-12-27 18:14:51 +09:00
|
|
|
|
|
New supported objects: Album, CaseForms, Label, Library, MadeFor, Major, Normalization, PlayCounter, Playlist, Track, TrackPosition, TrackShort, User
The following methods are wrapped:
- albums;
- playlists/list;
- users/{user_id}/playlists/list;
- tracks;
- users/{user_id}/likes/tracks.
Added property to get full track ID
Cover received more optional fields
Ability to pass arguments to the request
Removed unnecessary type conversions
2019-05-13 02:39:12 +09:00
|
|
|
|
|
|
|
|
|
class Playlist(YandexMusicObject):
|
2020-03-15 02:18:24 +09:00
|
|
|
|
"""Класс, представляющий плейлист.
|
|
|
|
|
|
|
|
|
|
Note:
|
Добавлены новые классы: Brand, Contest, OpenGraphData.
Поля contest, dummy_description, dummy_page_description, dummy_cover, dummy_rollover_cover, og_data, branding классу Playlist.
Добавлена информацию по поводу запуска потока по треку, плейлисту и т.д.
Документация и тесты к новым полям, классам #339
2020-06-15 04:11:38 +09:00
|
|
|
|
Под полями с заглушками понимаются поля, которые доступны у умных плейлистов тогда, когда у сервиса мало
|
|
|
|
|
данных для генерации плейлиста.
|
|
|
|
|
|
2020-03-15 02:18:24 +09:00
|
|
|
|
Известные значения `visibility`: `public` - публичный плейлист, `private` - приватный плейлист.
|
2020-01-26 23:50:54 +09:00
|
|
|
|
|
2020-03-22 04:04:58 +09:00
|
|
|
|
Известные значения `generated_playlist_type`: `playlistOfTheDay` - Плейлист дня, `recentTracks` - Премьера,
|
|
|
|
|
`neverHeard` - Дежавю, `podcasts` - Подкасты недели, `missedLikes` - Тайник, `origin` - Плейлист с Алисой.
|
|
|
|
|
|
2020-01-26 23:50:54 +09:00
|
|
|
|
Attributes:
|
Удаление избыточной информации (#247)
Классы: Account, AutoRenewable, PassportPhone, Permissions, Plus, Price,
Product, Status, Subscription, UserSettings, Album, Label,
TrackPosition, Playlist
У всех классов изменено описание атрибута client
2020-03-22 04:49:20 +09:00
|
|
|
|
owner (:obj:`yandex_music.User`): Владелец плейлиста.
|
|
|
|
|
cover (:obj:`yandex_music.Cover`): Обложка альбома.
|
|
|
|
|
made_for (:obj:`yandex_music.MadeFor`): Пользователь для которого был создан плейлист. Присутствует только у
|
|
|
|
|
персональных плейлистов.
|
2020-06-06 18:37:03 +09:00
|
|
|
|
play_counter (:obj:`yandex_music.PlayCounter`): Счётчик дней. Присутствует только у плейлиста дня.
|
Удаление избыточной информации (#247)
Классы: Account, AutoRenewable, PassportPhone, Permissions, Plus, Price,
Product, Status, Subscription, UserSettings, Album, Label,
TrackPosition, Playlist
У всех классов изменено описание атрибута client
2020-03-22 04:49:20 +09:00
|
|
|
|
playlist_absence (:obj:`yandex_music.PlaylistAbsence`): Причина отсутствия плейлиста.
|
2020-03-15 02:18:24 +09:00
|
|
|
|
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`): Есть ли у плейлиста соавторы.
|
2020-06-06 18:37:03 +09:00
|
|
|
|
url_part (:obj:`str`): Часть ссылки на плейлист ('daily`).
|
2020-03-15 02:18:24 +09:00
|
|
|
|
created (:obj:`str`): Дата создания в формате ISO 8601.
|
|
|
|
|
modified (:obj:`str`): Дата последнего изменения в формате ISO 8601.
|
2020-03-22 04:04:58 +09:00
|
|
|
|
available (:obj:`bool`): Доступен TODO.
|
|
|
|
|
is_banner (:obj:`bool`): Является ли банером TODO.
|
|
|
|
|
is_premiere (:obj:`bool`): Является ли премьерой TODO.
|
2020-03-15 02:18:24 +09:00
|
|
|
|
duration_ms (:obj:`int`): Длительность в миллисекундах.
|
|
|
|
|
og_image (:obj:`str`): Ссылка на превью Open Graph.
|
2020-06-06 18:37:03 +09:00
|
|
|
|
og_title (:obj:`str`): Заголовок Open Graph.
|
Добавлен новый класс 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
|
|
|
|
og_description (:obj:`str`, optional): Описание Open Graph.
|
2020-06-06 18:37:03 +09:00
|
|
|
|
image (:obj:`str`): Изображение TODO.
|
|
|
|
|
cover_without_text (:obj:`yandex_music.Cover`): Обложка без текста.
|
Добавлены новые классы: Brand, Contest, OpenGraphData.
Поля contest, dummy_description, dummy_page_description, dummy_cover, dummy_rollover_cover, og_data, branding классу Playlist.
Добавлена информацию по поводу запуска потока по треку, плейлисту и т.д.
Документация и тесты к новым полям, классам #339
2020-06-15 04:11:38 +09:00
|
|
|
|
contest (:obj:`yandex_music.Contest`): Контест TODO.
|
2020-06-06 18:37:03 +09:00
|
|
|
|
background_color (:obj:`str`): Цвет заднего фона TODO.
|
|
|
|
|
text_color (:obj:`str`): Цвет текста TODO.
|
|
|
|
|
id_for_from (:obj:`str`): Откуда пришло событие (уникальный идентификатор объекта) TODO.
|
Добавлены новые классы: Brand, Contest, OpenGraphData.
Поля contest, dummy_description, dummy_page_description, dummy_cover, dummy_rollover_cover, og_data, branding классу Playlist.
Добавлена информацию по поводу запуска потока по треку, плейлисту и т.д.
Документация и тесты к новым полям, классам #339
2020-06-15 04:11:38 +09:00
|
|
|
|
dummy_description (:obj:`str`): Описание-заглушка плейлиста.
|
|
|
|
|
dummy_page_description (:obj:`str`): Описание-заглушка страницы.
|
|
|
|
|
dummy_cover (:obj:`str`): Обложка-заглушка.
|
|
|
|
|
dummy_rollover_cover (:obj:`str`): Обложка-заглушка TODO.
|
|
|
|
|
og_data (:obj:`yandex_music.OpenGraphData`): Данные для OpenGraph.
|
|
|
|
|
branding (:obj:`yandex_music.Brand`): Бренд.
|
2020-06-14 21:09:50 +09:00
|
|
|
|
metrika_id (:obj:`int`): Уникальный идентификатор счётчика на Яндекс.Метрика.
|
Метод de_list в TrackId.
Поля coauthors и recent_tracks в Playlist.
Поле regions в User.
Поля users, podcasts, podcast_episodes, type_, page, per_page в Search.
Поддержка новых типов поиска: подкасты, выпуски, пользователи.
Поля short_description, description, is_premiere, is_banner в Like.
Документация и тесты к новым поля. #339
2020-06-07 18:55:30 +09:00
|
|
|
|
coauthors (:obj:`list` из :obj:`int`): Перечень ID аккаунтов соавторов плейлиста.
|
Добавлен новый класс 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
|
|
|
|
top_artist (:obj:`list` из :obj:`yandex_music.Artist`): Топ артистов TODO.
|
Метод de_list в TrackId.
Поля coauthors и recent_tracks в Playlist.
Поле regions в User.
Поля users, podcasts, podcast_episodes, type_, page, per_page в Search.
Поддержка новых типов поиска: подкасты, выпуски, пользователи.
Поля short_description, description, is_premiere, is_banner в Like.
Документация и тесты к новым поля. #339
2020-06-07 18:55:30 +09:00
|
|
|
|
recent_tracks (:obj:`list` из :obj:`yandex_music.TrackId`): Список ID недавних треков.
|
2020-03-15 02:18:24 +09:00
|
|
|
|
tracks (:obj:`list` из :obj:`yandex_music.TrackShort`): Список треков.
|
Удаление избыточной информации (#247)
Классы: Account, AutoRenewable, PassportPhone, Permissions, Plus, Price,
Product, Status, Subscription, UserSettings, Album, Label,
TrackPosition, Playlist
У всех классов изменено описание атрибута client
2020-03-22 04:49:20 +09:00
|
|
|
|
prerolls (:obj:`list`): Прерол, проигрываемый перед плейлистом. Присутствует только у персональных плейлистов.
|
2020-03-15 02:18:24 +09:00
|
|
|
|
likes_count (:obj:`int`): Количество лайков.
|
2020-06-06 18:37:03 +09:00
|
|
|
|
similar_playlists (:obj:`list` из :obj:`yandex_music.Playlist`): Похожие плейлисты.
|
|
|
|
|
last_owner_playlists (:obj:`list` из :obj:`yandex_music.Playlist`): Последние плейлисты владельца.
|
2020-03-15 02:18:24 +09:00
|
|
|
|
generated_playlist_type (:obj:`str`): Тип генерируемого плейлиста.
|
|
|
|
|
animated_cover_uri (:obj:`str`): Ссылка на анимированную обложку.
|
|
|
|
|
ever_played (:obj:`str`): Играл ли этот плейлист. Присутствует только у персональных плейлистов. TODO
|
|
|
|
|
description (:obj:`str`): Описание плейлиста с разметкой Markdown.
|
|
|
|
|
description_formatted (:obj:`str`): Описание плейлиста. Только текст, без разметки.
|
2020-03-22 04:04:58 +09:00
|
|
|
|
is_for_from: TODO.
|
|
|
|
|
regions: Регион 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:
|
Удаление избыточной информации (#247)
Классы: Account, AutoRenewable, PassportPhone, Permissions, Plus, Price,
Product, Status, Subscription, UserSettings, Album, Label,
TrackPosition, Playlist
У всех классов изменено описание атрибута client
2020-03-22 04:49:20 +09:00
|
|
|
|
owner (:obj:`yandex_music.User`, optional): Владелец плейлиста.
|
|
|
|
|
cover (:obj:`yandex_music.Cover`, optional): Обложка альбома.
|
2020-06-06 18:37:03 +09:00
|
|
|
|
made_for (:obj:`yandex_music.MadeFor`, optional): Пользователь для которого был создан плейлист. Присутствует
|
|
|
|
|
только у персональных плейлистов.
|
|
|
|
|
play_counter (:obj:`yandex_music.PlayCounter`, optional): Счётчик дней. Присутствует только у плейлиста дня.
|
Удаление избыточной информации (#247)
Классы: Account, AutoRenewable, PassportPhone, Permissions, Plus, Price,
Product, Status, Subscription, UserSettings, Album, Label,
TrackPosition, Playlist
У всех классов изменено описание атрибута client
2020-03-22 04:49:20 +09:00
|
|
|
|
playlist_absence (:obj:`yandex_music.PlaylistAbsence`, optional): Причина отсутствия плейлиста.
|
2020-03-15 02:18:24 +09:00
|
|
|
|
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): Есть ли у плейлиста соавторы.
|
2020-06-06 18:37:03 +09:00
|
|
|
|
url_part (:obj:`str`, optional): Часть ссылки на плейлист ('daily`).
|
2020-03-15 02:18:24 +09:00
|
|
|
|
created (:obj:`str`, optional): Дата создания в формате ISO 8601.
|
|
|
|
|
modified (:obj:`str`, optional): Дата последнего изменения в формате ISO 8601.
|
2020-03-22 04:04:58 +09:00
|
|
|
|
available (:obj:`bool`, optional): Доступен TODO.
|
|
|
|
|
is_banner (:obj:`bool`, optional): Является ли банером TODO.
|
|
|
|
|
is_premiere (:obj:`bool`, optional): Является ли премьерой TODO.
|
2020-03-15 02:18:24 +09:00
|
|
|
|
duration_ms (:obj:`int`, optional): Длительность в миллисекундах.
|
|
|
|
|
og_image (:obj:`str`, optional): Ссылка на превью Open Graph.
|
2020-06-06 18:37:03 +09:00
|
|
|
|
og_title (:obj:`str`, optional): Заголовок Open Graph.
|
Добавлен новый класс 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
|
|
|
|
og_description (:obj:`str`, optional): Описание Open Graph.
|
2020-06-06 18:37:03 +09:00
|
|
|
|
image (:obj:`str`, optional): Изображение TODO.
|
|
|
|
|
cover_without_text (:obj:`yandex_music.Cover`, optional): Обложка без текста.
|
Добавлены новые классы: Brand, Contest, OpenGraphData.
Поля contest, dummy_description, dummy_page_description, dummy_cover, dummy_rollover_cover, og_data, branding классу Playlist.
Добавлена информацию по поводу запуска потока по треку, плейлисту и т.д.
Документация и тесты к новым полям, классам #339
2020-06-15 04:11:38 +09:00
|
|
|
|
contest (:obj:`yandex_music.Contest`, optional): Контест TODO.
|
2020-06-06 18:37:03 +09:00
|
|
|
|
background_color (:obj:`str`, optional): Цвет заднего фона TODO.
|
|
|
|
|
text_color (:obj:`str`, optional): Цвет текста TODO.
|
|
|
|
|
id_for_from (:obj:`str`, optional): Откуда пришло событие (уникальный идентификатор объекта) TODO.
|
Добавлены новые классы: Brand, Contest, OpenGraphData.
Поля contest, dummy_description, dummy_page_description, dummy_cover, dummy_rollover_cover, og_data, branding классу Playlist.
Добавлена информацию по поводу запуска потока по треку, плейлисту и т.д.
Документация и тесты к новым полям, классам #339
2020-06-15 04:11:38 +09:00
|
|
|
|
dummy_description (:obj:`str`, optional): Описание-заглушка плейлиста.
|
|
|
|
|
dummy_page_description (:obj:`str`, optional): Описание-заглушка страницы.
|
|
|
|
|
dummy_cover (:obj:`str`, optional): Обложка-заглушка.
|
|
|
|
|
dummy_rollover_cover (:obj:`str`, optional): Обложка-заглушка TODO.
|
|
|
|
|
og_data (:obj:`yandex_music.OpenGraphData`, optional): Данные для OpenGraph.
|
|
|
|
|
branding (:obj:`yandex_music.Brand`): Бренд.
|
2020-06-14 21:09:50 +09:00
|
|
|
|
metrika_id (:obj:`int`, optional): Уникальный идентификатор счётчика на Яндекс.Метрика.
|
Метод de_list в TrackId.
Поля coauthors и recent_tracks в Playlist.
Поле regions в User.
Поля users, podcasts, podcast_episodes, type_, page, per_page в Search.
Поддержка новых типов поиска: подкасты, выпуски, пользователи.
Поля short_description, description, is_premiere, is_banner в Like.
Документация и тесты к новым поля. #339
2020-06-07 18:55:30 +09:00
|
|
|
|
coauthors (:obj:`list` из :obj:`int`, optional): Перечень ID аккаунтов соавторов плейлиста.
|
Добавлен новый класс 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
|
|
|
|
top_artist (:obj:`list` из :obj:`yandex_music.Artist`, optional): Топ артистов TODO.
|
Метод de_list в TrackId.
Поля coauthors и recent_tracks в Playlist.
Поле regions в User.
Поля users, podcasts, podcast_episodes, type_, page, per_page в Search.
Поддержка новых типов поиска: подкасты, выпуски, пользователи.
Поля short_description, description, is_premiere, is_banner в Like.
Документация и тесты к новым поля. #339
2020-06-07 18:55:30 +09:00
|
|
|
|
recent_tracks (:obj:`list` из :obj:`yandex_music.TrackId`, optional): Список ID недавних треков.
|
2020-03-15 02:18:24 +09:00
|
|
|
|
tracks (:obj:`list` из :obj:`yandex_music.TrackShort`, optional): Список треков.
|
|
|
|
|
prerolls (:obj:`list`, optional): Прерол, проигрываемый перед плейлистом. Присутствует только у персональных
|
|
|
|
|
плейлистов.
|
|
|
|
|
likes_count (:obj:`int`, optional): Количество лайков.
|
2020-06-06 18:37:03 +09:00
|
|
|
|
similar_playlists (:obj:`list` из :obj:`yandex_music.Playlist`, optional): Похожие плейлисты.
|
|
|
|
|
last_owner_playlists (:obj:`list` из :obj:`yandex_music.Playlist`, optional): Последние плейлисты владельца.
|
2020-03-15 02:18:24 +09:00
|
|
|
|
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): Описание плейлиста. Только текст, без разметки.
|
2020-03-22 04:04:58 +09:00
|
|
|
|
is_for_from: TODO.
|
|
|
|
|
regions: Регион 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.
|
|
|
|
|
"""
|
|
|
|
|
|
New supported objects: Album, CaseForms, Label, Library, MadeFor, Major, Normalization, PlayCounter, Playlist, Track, TrackPosition, TrackShort, User
The following methods are wrapped:
- albums;
- playlists/list;
- users/{user_id}/playlists/list;
- tracks;
- users/{user_id}/likes/tracks.
Added property to get full track ID
Cover received more optional fields
Ability to pass arguments to the request
Removed unnecessary type conversions
2019-05-13 02:39:12 +09:00
|
|
|
|
def __init__(self,
|
2019-12-27 18:14:51 +09:00
|
|
|
|
owner: Optional['User'],
|
|
|
|
|
cover: Optional['Cover'],
|
|
|
|
|
made_for: Optional['MadeFor'],
|
|
|
|
|
play_counter: Optional['PlayCounter'],
|
|
|
|
|
playlist_absence: Optional['PlaylistAbsence'],
|
2019-12-28 22:25:09 +09:00
|
|
|
|
uid: Optional[int] = None,
|
|
|
|
|
kind: Optional[int] = None,
|
|
|
|
|
title: Optional[str] = None,
|
|
|
|
|
track_count: Optional[int] = None,
|
|
|
|
|
tags: Optional[list] = None,
|
|
|
|
|
revision: Optional[int] = None,
|
|
|
|
|
snapshot: Optional[int] = None,
|
|
|
|
|
visibility: Optional[str] = None,
|
|
|
|
|
collective: Optional[bool] = None,
|
2020-05-15 07:49:50 +09:00
|
|
|
|
url_part: Optional[str] = None,
|
2019-12-28 22:25:09 +09:00
|
|
|
|
created: Optional[str] = None,
|
|
|
|
|
modified: Optional[str] = None,
|
|
|
|
|
available: Optional[bool] = None,
|
|
|
|
|
is_banner: Optional[bool] = None,
|
|
|
|
|
is_premiere: Optional[bool] = None,
|
|
|
|
|
duration_ms: Optional[int] = None,
|
|
|
|
|
og_image: Optional[str] = None,
|
2020-05-15 07:49:50 +09:00
|
|
|
|
og_title: Optional[str] = None,
|
Добавлен новый класс 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
|
|
|
|
og_description: Optional[str] = None,
|
2020-05-15 07:49:50 +09:00
|
|
|
|
image: Optional[str] = None,
|
|
|
|
|
cover_without_text: Optional['Cover'] = None,
|
Добавлены новые классы: Brand, Contest, OpenGraphData.
Поля contest, dummy_description, dummy_page_description, dummy_cover, dummy_rollover_cover, og_data, branding классу Playlist.
Добавлена информацию по поводу запуска потока по треку, плейлисту и т.д.
Документация и тесты к новым полям, классам #339
2020-06-15 04:11:38 +09:00
|
|
|
|
contest: Optional['Contest'] = None,
|
2020-05-15 07:49:50 +09:00
|
|
|
|
background_color: Optional[str] = None,
|
|
|
|
|
text_color: Optional[str] = None,
|
|
|
|
|
id_for_from: Optional[str] = None,
|
Добавлены новые классы: Brand, Contest, OpenGraphData.
Поля contest, dummy_description, dummy_page_description, dummy_cover, dummy_rollover_cover, og_data, branding классу Playlist.
Добавлена информацию по поводу запуска потока по треку, плейлисту и т.д.
Документация и тесты к новым полям, классам #339
2020-06-15 04:11:38 +09:00
|
|
|
|
dummy_description: Optional[str] = None,
|
|
|
|
|
dummy_page_description: Optional[str] = None,
|
|
|
|
|
dummy_cover: Optional['Cover'] = None,
|
|
|
|
|
dummy_rollover_cover: Optional['Cover'] = None,
|
|
|
|
|
og_data: Optional['OpenGraphData'] = None,
|
|
|
|
|
branding: Optional['Brand'] = None,
|
2020-06-14 21:09:50 +09:00
|
|
|
|
metrika_id: Optional[int] = None,
|
Метод de_list в TrackId.
Поля coauthors и recent_tracks в Playlist.
Поле regions в User.
Поля users, podcasts, podcast_episodes, type_, page, per_page в Search.
Поддержка новых типов поиска: подкасты, выпуски, пользователи.
Поля short_description, description, is_premiere, is_banner в Like.
Документация и тесты к новым поля. #339
2020-06-07 18:55:30 +09:00
|
|
|
|
coauthors: List[int] = None,
|
Добавлен новый класс 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
|
|
|
|
top_artist: List['Artist'] = None,
|
Метод de_list в TrackId.
Поля coauthors и recent_tracks в Playlist.
Поле regions в User.
Поля users, podcasts, podcast_episodes, type_, page, per_page в Search.
Поддержка новых типов поиска: подкасты, выпуски, пользователи.
Поля short_description, description, is_premiere, is_banner в Like.
Документация и тесты к новым поля. #339
2020-06-07 18:55:30 +09:00
|
|
|
|
recent_tracks: List['TrackId'] = None,
|
2019-12-28 22:25:09 +09:00
|
|
|
|
tracks: List['TrackShort'] = None,
|
|
|
|
|
prerolls: Optional[list] = None,
|
|
|
|
|
likes_count: Optional[int] = None,
|
2020-06-06 18:37:03 +09:00
|
|
|
|
similar_playlists: List['Playlist'] = None,
|
|
|
|
|
last_owner_playlists: List['Playlist'] = None,
|
2019-12-28 22:25:09 +09:00
|
|
|
|
generated_playlist_type: Optional[str] = None,
|
|
|
|
|
animated_cover_uri: Optional[str] = None,
|
|
|
|
|
ever_played: Optional[bool] = None,
|
|
|
|
|
description: Optional[str] = None,
|
|
|
|
|
description_formatted: Optional[str] = None,
|
New supported objects: Album, CaseForms, Label, Library, MadeFor, Major, Normalization, PlayCounter, Playlist, Track, TrackPosition, TrackShort, User
The following methods are wrapped:
- albums;
- playlists/list;
- users/{user_id}/playlists/list;
- tracks;
- users/{user_id}/likes/tracks.
Added property to get full track ID
Cover received more optional fields
Ability to pass arguments to the request
Removed unnecessary type conversions
2019-05-13 02:39:12 +09:00
|
|
|
|
is_for_from=None,
|
New supported objects: Search, Suggestions, Video, Best, AlbumSearchResult, ArtistSearchResult, PlaylistSearchResult, TrackSearchResult, VideoSearchResult,
The following methods are wrapped:
- /search
- /search/suggest
The following classes received optional fields instead of required ones: Album, Artist, Playlist, Track
Added "params" arg to the GET request
Code refactoring
2019-05-18 01:20:34 +09:00
|
|
|
|
regions=None,
|
2019-12-27 18:14:51 +09:00
|
|
|
|
client: Optional['Client'] = None,
|
|
|
|
|
**kwargs) -> None:
|
New supported objects: Album, CaseForms, Label, Library, MadeFor, Major, Normalization, PlayCounter, Playlist, Track, TrackPosition, TrackShort, User
The following methods are wrapped:
- albums;
- playlists/list;
- users/{user_id}/playlists/list;
- tracks;
- users/{user_id}/likes/tracks.
Added property to get full track ID
Cover received more optional fields
Ability to pass arguments to the request
Removed unnecessary type conversions
2019-05-13 02:39:12 +09:00
|
|
|
|
self.owner = owner
|
New supported objects: Search, Suggestions, Video, Best, AlbumSearchResult, ArtistSearchResult, PlaylistSearchResult, TrackSearchResult, VideoSearchResult,
The following methods are wrapped:
- /search
- /search/suggest
The following classes received optional fields instead of required ones: Album, Artist, Playlist, Track
Added "params" arg to the GET request
Code refactoring
2019-05-18 01:20:34 +09:00
|
|
|
|
self.cover = cover
|
|
|
|
|
self.made_for = made_for
|
|
|
|
|
self.play_counter = play_counter
|
2019-11-24 07:51:45 +09:00
|
|
|
|
self.playlist_absence = playlist_absence
|
New supported objects: Search, Suggestions, Video, Best, AlbumSearchResult, ArtistSearchResult, PlaylistSearchResult, TrackSearchResult, VideoSearchResult,
The following methods are wrapped:
- /search
- /search/suggest
The following classes received optional fields instead of required ones: Album, Artist, Playlist, Track
Added "params" arg to the GET request
Code refactoring
2019-05-18 01:20:34 +09:00
|
|
|
|
|
2019-11-24 07:51:45 +09:00
|
|
|
|
self.uid = uid
|
|
|
|
|
self.kind = kind
|
|
|
|
|
self.title = title
|
|
|
|
|
self.track_count = track_count
|
New supported objects: Album, CaseForms, Label, Library, MadeFor, Major, Normalization, PlayCounter, Playlist, Track, TrackPosition, TrackShort, User
The following methods are wrapped:
- albums;
- playlists/list;
- users/{user_id}/playlists/list;
- tracks;
- users/{user_id}/likes/tracks.
Added property to get full track ID
Cover received more optional fields
Ability to pass arguments to the request
Removed unnecessary type conversions
2019-05-13 02:39:12 +09:00
|
|
|
|
self.revision = revision
|
|
|
|
|
self.snapshot = snapshot
|
|
|
|
|
self.visibility = visibility
|
|
|
|
|
self.collective = collective
|
2020-05-15 07:49:50 +09:00
|
|
|
|
self.url_part = url_part
|
2019-11-08 04:52:26 +09:00
|
|
|
|
self.created = created
|
|
|
|
|
self.modified = modified
|
New supported objects: Album, CaseForms, Label, Library, MadeFor, Major, Normalization, PlayCounter, Playlist, Track, TrackPosition, TrackShort, User
The following methods are wrapped:
- albums;
- playlists/list;
- users/{user_id}/playlists/list;
- tracks;
- users/{user_id}/likes/tracks.
Added property to get full track ID
Cover received more optional fields
Ability to pass arguments to the request
Removed unnecessary type conversions
2019-05-13 02:39:12 +09:00
|
|
|
|
self.available = available
|
|
|
|
|
self.is_banner = is_banner
|
|
|
|
|
self.is_premiere = is_premiere
|
|
|
|
|
self.duration_ms = duration_ms
|
|
|
|
|
self.og_image = og_image
|
2020-05-15 07:49:50 +09:00
|
|
|
|
self.og_title = og_title
|
Добавлен новый класс 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.og_description = og_description
|
2020-05-15 07:49:50 +09:00
|
|
|
|
self.image = image
|
|
|
|
|
self.cover_without_text = cover_without_text
|
Добавлены новые классы: Brand, Contest, OpenGraphData.
Поля contest, dummy_description, dummy_page_description, dummy_cover, dummy_rollover_cover, og_data, branding классу Playlist.
Добавлена информацию по поводу запуска потока по треку, плейлисту и т.д.
Документация и тесты к новым полям, классам #339
2020-06-15 04:11:38 +09:00
|
|
|
|
self.contest = contest
|
2020-05-15 07:49:50 +09:00
|
|
|
|
self.background_color = background_color
|
|
|
|
|
self.text_color = text_color
|
|
|
|
|
self.id_for_from = id_for_from
|
Добавлены новые классы: Brand, Contest, OpenGraphData.
Поля contest, dummy_description, dummy_page_description, dummy_cover, dummy_rollover_cover, og_data, branding классу Playlist.
Добавлена информацию по поводу запуска потока по треку, плейлисту и т.д.
Документация и тесты к новым полям, классам #339
2020-06-15 04:11:38 +09:00
|
|
|
|
self.dummy_description = dummy_description
|
|
|
|
|
self.dummy_page_description = dummy_page_description
|
|
|
|
|
self.dummy_cover = dummy_cover
|
|
|
|
|
self.dummy_rollover_cover = dummy_rollover_cover
|
|
|
|
|
self.og_data = og_data
|
|
|
|
|
self.branding = branding
|
2020-06-14 21:09:50 +09:00
|
|
|
|
self.metrika_id = metrika_id
|
Метод de_list в TrackId.
Поля coauthors и recent_tracks в Playlist.
Поле regions в User.
Поля users, podcasts, podcast_episodes, type_, page, per_page в Search.
Поддержка новых типов поиска: подкасты, выпуски, пользователи.
Поля short_description, description, is_premiere, is_banner в Like.
Документация и тесты к новым поля. #339
2020-06-07 18:55:30 +09:00
|
|
|
|
self.coauthors = coauthors
|
Добавлен новый класс 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.top_artist = top_artist
|
Метод de_list в TrackId.
Поля coauthors и recent_tracks в Playlist.
Поле regions в User.
Поля users, podcasts, podcast_episodes, type_, page, per_page в Search.
Поддержка новых типов поиска: подкасты, выпуски, пользователи.
Поля short_description, description, is_premiere, is_banner в Like.
Документация и тесты к новым поля. #339
2020-06-07 18:55:30 +09:00
|
|
|
|
self.recent_tracks = recent_tracks
|
2019-06-01 17:23:28 +09:00
|
|
|
|
self.tracks = tracks
|
New supported objects: Album, CaseForms, Label, Library, MadeFor, Major, Normalization, PlayCounter, Playlist, Track, TrackPosition, TrackShort, User
The following methods are wrapped:
- albums;
- playlists/list;
- users/{user_id}/playlists/list;
- tracks;
- users/{user_id}/likes/tracks.
Added property to get full track ID
Cover received more optional fields
Ability to pass arguments to the request
Removed unnecessary type conversions
2019-05-13 02:39:12 +09:00
|
|
|
|
self.prerolls = prerolls
|
|
|
|
|
self.likes_count = likes_count
|
|
|
|
|
self.animated_cover_uri = animated_cover_uri
|
|
|
|
|
self.description = description
|
|
|
|
|
self.description_formatted = description_formatted
|
|
|
|
|
self.ever_played = ever_played
|
2020-05-15 07:49:50 +09:00
|
|
|
|
self.similar_playlists = similar_playlists
|
|
|
|
|
self.last_owner_playlists = last_owner_playlists
|
New supported objects: Album, CaseForms, Label, Library, MadeFor, Major, Normalization, PlayCounter, Playlist, Track, TrackPosition, TrackShort, User
The following methods are wrapped:
- albums;
- playlists/list;
- users/{user_id}/playlists/list;
- tracks;
- users/{user_id}/likes/tracks.
Added property to get full track ID
Cover received more optional fields
Ability to pass arguments to the request
Removed unnecessary type conversions
2019-05-13 02:39:12 +09:00
|
|
|
|
self.generated_playlist_type = generated_playlist_type
|
|
|
|
|
self.is_for_from = is_for_from
|
New supported objects: Search, Suggestions, Video, Best, AlbumSearchResult, ArtistSearchResult, PlaylistSearchResult, TrackSearchResult, VideoSearchResult,
The following methods are wrapped:
- /search
- /search/suggest
The following classes received optional fields instead of required ones: Album, Artist, Playlist, Track
Added "params" arg to the GET request
Code refactoring
2019-05-18 01:20:34 +09:00
|
|
|
|
self.regions = regions
|
New supported objects: Landing, Block, BlockEntity, Chart, ChartItem, MixLink, PersonalPlaylistsData, PlayContext, PlayContextsData, Promotion, TrackId, TrackShorOld (YEAH!)
The following method are wrapped:
- /landing3
Added the ability to download covers
The following field are optional: Playlist.tags
Now, when parsing json, the "client" key is replaced with "client_"
2019-05-25 02:10:39 +09:00
|
|
|
|
self.tags = tags
|
New supported objects: Album, CaseForms, Label, Library, MadeFor, Major, Normalization, PlayCounter, Playlist, Track, TrackPosition, TrackShort, User
The following methods are wrapped:
- albums;
- playlists/list;
- users/{user_id}/playlists/list;
- tracks;
- users/{user_id}/likes/tracks.
Added property to get full track ID
Cover received more optional fields
Ability to pass arguments to the request
Removed unnecessary type conversions
2019-05-13 02:39:12 +09:00
|
|
|
|
|
|
|
|
|
self.client = client
|
2019-11-24 07:51:45 +09:00
|
|
|
|
self._id_attrs = (self.uid, self.kind, self.title, self.playlist_absence)
|
New supported objects: Album, CaseForms, Label, Library, MadeFor, Major, Normalization, PlayCounter, Playlist, Track, TrackPosition, TrackShort, User
The following methods are wrapped:
- albums;
- playlists/list;
- users/{user_id}/playlists/list;
- tracks;
- users/{user_id}/likes/tracks.
Added property to get full track ID
Cover received more optional fields
Ability to pass arguments to the request
Removed unnecessary type conversions
2019-05-13 02:39:12 +09:00
|
|
|
|
|
2020-05-16 04:14:44 +09:00
|
|
|
|
super().handle_unknown_kwargs(self, **kwargs)
|
|
|
|
|
|
2019-06-01 15:04:15 +09:00
|
|
|
|
@property
|
2019-12-27 18:14:51 +09:00
|
|
|
|
def is_mine(self) -> bool:
|
2019-12-24 06:20:07 +09:00
|
|
|
|
return self.owner.uid == self.client.me.account.uid
|
2019-06-01 15:04:15 +09:00
|
|
|
|
|
2019-05-19 05:59:14 +09:00
|
|
|
|
@property
|
2019-12-27 18:14:51 +09:00
|
|
|
|
def playlist_id(self) -> str:
|
2019-05-19 05:59:14 +09:00
|
|
|
|
return f'{self.owner.uid}:{self.kind}'
|
|
|
|
|
|
2020-05-07 17:09:12 +09:00
|
|
|
|
def get_recommendations(self, *args, **kwargs) -> Optional['PlaylistRecommendations']:
|
|
|
|
|
"""Сокращение для::
|
|
|
|
|
|
|
|
|
|
client.users_playlists_recommendations(playlist.kind, playlist.owner.uid, *args, **kwargs)
|
|
|
|
|
"""
|
|
|
|
|
return self.client.users_playlists_recommendations(self.kind, self.owner.uid, *args, **kwargs)
|
|
|
|
|
|
2019-12-27 21:32:50 +09:00
|
|
|
|
def download_animated_cover(self, filename: str, size: str = '200x200') -> None:
|
2019-08-18 23:44:46 +09:00
|
|
|
|
"""Загрузка анимированной обложки.
|
|
|
|
|
|
|
|
|
|
Args:
|
|
|
|
|
filename (:obj:`str`): Путь для сохранения файла с названием и расширением (GIF).
|
|
|
|
|
size (:obj:`str`, optional): Размер анимированной обложки.
|
|
|
|
|
"""
|
|
|
|
|
self.client.request.download(f'https://{self.animated_cover_uri.replace("%%", size)}', filename)
|
|
|
|
|
|
2019-12-27 21:32:50 +09:00
|
|
|
|
def download_og_image(self, filename: str, size: str = '200x200') -> None:
|
2019-08-18 23:44:46 +09:00
|
|
|
|
"""Загрузка обложки.
|
|
|
|
|
|
|
|
|
|
Используйте это только когда нет self.cover!
|
|
|
|
|
|
|
|
|
|
Args:
|
|
|
|
|
filename (:obj:`str`): Путь для сохранения файла с названием и расширением.
|
|
|
|
|
size (:obj:`str`, optional): Размер обложки.
|
|
|
|
|
"""
|
|
|
|
|
self.client.request.download(f'https://{self.og_image.replace("%%", size)}', filename)
|
|
|
|
|
|
2019-12-27 18:14:51 +09:00
|
|
|
|
def rename(self, name: str) -> None:
|
2019-06-01 15:04:15 +09:00
|
|
|
|
client, kind = self.client, self.kind
|
|
|
|
|
|
|
|
|
|
self.__dict__.clear()
|
|
|
|
|
self.__dict__.update(client.users_playlists_name(kind, name).__dict__)
|
|
|
|
|
|
2019-12-27 18:14:51 +09:00
|
|
|
|
def like(self, *args, **kwargs) -> bool:
|
2019-10-07 02:06:28 +09:00
|
|
|
|
"""Сокращение для::
|
|
|
|
|
|
|
|
|
|
client.users_likes_playlists_add(playlist.uid, user.id *args, **kwargs)
|
|
|
|
|
"""
|
2019-12-24 06:20:07 +09:00
|
|
|
|
return self.client.users_likes_playlists_add(self.uid, self.client.me.account.uid, *args, **kwargs)
|
2019-10-07 02:06:28 +09:00
|
|
|
|
|
2019-12-27 18:14:51 +09:00
|
|
|
|
def dislike(self, *args, **kwargs) -> bool:
|
2019-10-07 02:06:28 +09:00
|
|
|
|
"""Сокращение для::
|
|
|
|
|
|
|
|
|
|
client.users_likes_playlists_remove(playlist.uid, user.id *args, **kwargs)
|
|
|
|
|
"""
|
2019-12-24 06:20:07 +09:00
|
|
|
|
return self.client.users_likes_playlists_remove(self.uid, self.client.me.account.uid, *args, **kwargs)
|
2019-10-07 02:06:28 +09:00
|
|
|
|
|
2020-05-15 06:48:49 +09:00
|
|
|
|
def fetch_tracks(self, *args, **kwargs) -> List['TrackShort']:
|
|
|
|
|
"""Сокращение для::
|
|
|
|
|
|
|
|
|
|
client.users_playlists(playlist.kind, playlist.owner.id, *args, **kwargs).tracks
|
|
|
|
|
"""
|
|
|
|
|
return self.client.users_playlists(self.kind, self.owner.uid, *args, **kwargs).tracks
|
|
|
|
|
|
New supported objects: Album, CaseForms, Label, Library, MadeFor, Major, Normalization, PlayCounter, Playlist, Track, TrackPosition, TrackShort, User
The following methods are wrapped:
- albums;
- playlists/list;
- users/{user_id}/playlists/list;
- tracks;
- users/{user_id}/likes/tracks.
Added property to get full track ID
Cover received more optional fields
Ability to pass arguments to the request
Removed unnecessary type conversions
2019-05-13 02:39:12 +09:00
|
|
|
|
@classmethod
|
2019-12-27 18:14:51 +09:00
|
|
|
|
def de_json(cls, data: dict, client: 'Client') -> Optional['Playlist']:
|
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:
|
Изменения описания de_json и de_list под новый стиль документации (#247).
Классы: Account, AutoRenewable, PassportPhone, Permissions, Plus, Price,
Product, Status, Subscription, UserSettings, Album, Label,
TrackPosition, Playlist
2020-03-22 05:06:19 +09:00
|
|
|
|
:obj:`yandex_music.Playlist`: Плейлист.
|
2020-01-26 22:17:09 +09:00
|
|
|
|
"""
|
New supported objects: Album, CaseForms, Label, Library, MadeFor, Major, Normalization, PlayCounter, Playlist, Track, TrackPosition, TrackShort, User
The following methods are wrapped:
- albums;
- playlists/list;
- users/{user_id}/playlists/list;
- tracks;
- users/{user_id}/likes/tracks.
Added property to get full track ID
Cover received more optional fields
Ability to pass arguments to the request
Removed unnecessary type conversions
2019-05-13 02:39:12 +09:00
|
|
|
|
if not data:
|
|
|
|
|
return None
|
|
|
|
|
|
|
|
|
|
data = super(Playlist, cls).de_json(data, client)
|
Добавлены новые классы: Brand, Contest, OpenGraphData.
Поля contest, dummy_description, dummy_page_description, dummy_cover, dummy_rollover_cover, og_data, branding классу Playlist.
Добавлена информацию по поводу запуска потока по треку, плейлисту и т.д.
Документация и тесты к новым полям, классам #339
2020-06-15 04:11:38 +09:00
|
|
|
|
from yandex_music import User, MadeFor, Cover, PlayCounter, TrackShort, \
|
|
|
|
|
PlaylistAbsence, Artist, TrackId, Contest, OpenGraphData, Brand
|
New supported objects: Album, CaseForms, Label, Library, MadeFor, Major, Normalization, PlayCounter, Playlist, Track, TrackPosition, TrackShort, User
The following methods are wrapped:
- albums;
- playlists/list;
- users/{user_id}/playlists/list;
- tracks;
- users/{user_id}/likes/tracks.
Added property to get full track ID
Cover received more optional fields
Ability to pass arguments to the request
Removed unnecessary type conversions
2019-05-13 02:39:12 +09:00
|
|
|
|
data['owner'] = User.de_json(data.get('owner'), client)
|
|
|
|
|
data['cover'] = Cover.de_json(data.get('cover'), client)
|
2020-05-15 07:49:50 +09:00
|
|
|
|
data['cover_without_text'] = Cover.de_json(data.get('cover_without_text'), client)
|
New supported objects: Album, CaseForms, Label, Library, MadeFor, Major, Normalization, PlayCounter, Playlist, Track, TrackPosition, TrackShort, User
The following methods are wrapped:
- albums;
- playlists/list;
- users/{user_id}/playlists/list;
- tracks;
- users/{user_id}/likes/tracks.
Added property to get full track ID
Cover received more optional fields
Ability to pass arguments to the request
Removed unnecessary type conversions
2019-05-13 02:39:12 +09:00
|
|
|
|
data['made_for'] = MadeFor.de_json(data.get('made_for'), client)
|
2019-06-01 17:23:28 +09:00
|
|
|
|
data['tracks'] = TrackShort.de_list(data.get('tracks'), client)
|
Метод de_list в TrackId.
Поля coauthors и recent_tracks в Playlist.
Поле regions в User.
Поля users, podcasts, podcast_episodes, type_, page, per_page в Search.
Поддержка новых типов поиска: подкасты, выпуски, пользователи.
Поля short_description, description, is_premiere, is_banner в Like.
Документация и тесты к новым поля. #339
2020-06-07 18:55:30 +09:00
|
|
|
|
data['recent_tracks'] = TrackId.de_list(data.get('recent_tracks'), client)
|
New supported objects: Album, CaseForms, Label, Library, MadeFor, Major, Normalization, PlayCounter, Playlist, Track, TrackPosition, TrackShort, User
The following methods are wrapped:
- albums;
- playlists/list;
- users/{user_id}/playlists/list;
- tracks;
- users/{user_id}/likes/tracks.
Added property to get full track ID
Cover received more optional fields
Ability to pass arguments to the request
Removed unnecessary type conversions
2019-05-13 02:39:12 +09:00
|
|
|
|
data['play_counter'] = PlayCounter.de_json(data.get('play_counter'), client)
|
Добавлен новый класс 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
|
|
|
|
data['top_artist'] = Artist.de_list(data.get('top_artist'), client)
|
Добавлены новые классы: Brand, Contest, OpenGraphData.
Поля contest, dummy_description, dummy_page_description, dummy_cover, dummy_rollover_cover, og_data, branding классу Playlist.
Добавлена информацию по поводу запуска потока по треку, плейлисту и т.д.
Документация и тесты к новым полям, классам #339
2020-06-15 04:11:38 +09:00
|
|
|
|
data['contest'] = Contest.de_json(data.get('contest'), client)
|
|
|
|
|
data['og_data'] = OpenGraphData.de_json(data.get('og_data'), client)
|
|
|
|
|
data['dummy_cover'] = Cover.de_json(data.get('dummy_cover'), client)
|
|
|
|
|
data['dummy_rollover_cover'] = Cover.de_json(data.get('dummy_rollover_cover'), client)
|
|
|
|
|
data['branding'] = Brand.de_json(data.get('branding'), client)
|
2019-11-24 08:23:24 +09:00
|
|
|
|
|
2020-05-15 07:49:50 +09:00
|
|
|
|
data['similar_playlists'] = Playlist.de_list(data.get('similar_playlists'), client)
|
|
|
|
|
data['last_owner_playlists'] = Playlist.de_list(data.get('last_owner_playlists'), client)
|
|
|
|
|
|
2019-11-24 08:23:24 +09:00
|
|
|
|
data['playlist_absence'] = PlaylistAbsence.de_json(data.get('playlist_absence'), client) # на случай фикса
|
|
|
|
|
if data.get('playlist_absense'): # очепятка яндуха
|
|
|
|
|
data['playlist_absence'] = PlaylistAbsence.de_json(data.get('playlist_absense'), client)
|
|
|
|
|
data.pop('playlist_absense')
|
New supported objects: Album, CaseForms, Label, Library, MadeFor, Major, Normalization, PlayCounter, Playlist, Track, TrackPosition, TrackShort, User
The following methods are wrapped:
- albums;
- playlists/list;
- users/{user_id}/playlists/list;
- tracks;
- users/{user_id}/likes/tracks.
Added property to get full track ID
Cover received more optional fields
Ability to pass arguments to the request
Removed unnecessary type conversions
2019-05-13 02:39:12 +09:00
|
|
|
|
|
|
|
|
|
return cls(client=client, **data)
|
|
|
|
|
|
|
|
|
|
@classmethod
|
2019-12-27 18:14:51 +09:00
|
|
|
|
def de_list(cls, data: dict, client: 'Client') -> List['Playlist']:
|
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:
|
Изменения описания de_json и de_list под новый стиль документации (#247).
Классы: Account, AutoRenewable, PassportPhone, Permissions, Plus, Price,
Product, Status, Subscription, UserSettings, Album, Label,
TrackPosition, Playlist
2020-03-22 05:06:19 +09:00
|
|
|
|
:obj:`list` из :obj:`yandex_music.Playlist`: Плейлисты.
|
2020-01-26 22:17:09 +09:00
|
|
|
|
"""
|
New supported objects: Album, CaseForms, Label, Library, MadeFor, Major, Normalization, PlayCounter, Playlist, Track, TrackPosition, TrackShort, User
The following methods are wrapped:
- albums;
- playlists/list;
- users/{user_id}/playlists/list;
- tracks;
- users/{user_id}/likes/tracks.
Added property to get full track ID
Cover received more optional fields
Ability to pass arguments to the request
Removed unnecessary type conversions
2019-05-13 02:39:12 +09:00
|
|
|
|
if not data:
|
|
|
|
|
return []
|
|
|
|
|
|
2020-05-15 07:49:50 +09:00
|
|
|
|
return [cls.de_json(playlist, client) for playlist in data]
|
2019-08-18 18:54:13 +09:00
|
|
|
|
|
|
|
|
|
# camelCase псевдонимы
|
|
|
|
|
|
2019-10-19 17:55:45 +09:00
|
|
|
|
#: Псевдоним для :attr:`is_mine`
|
2019-08-18 18:54:13 +09:00
|
|
|
|
isMine = is_mine
|
2019-10-19 17:55:45 +09:00
|
|
|
|
#: Псевдоним для :attr:`playlist_id`
|
2019-08-18 18:54:13 +09:00
|
|
|
|
playlistId = playlist_id
|
2020-05-07 17:46:56 +09:00
|
|
|
|
#: Псевдоним для :attr:`get_recommendations`
|
|
|
|
|
getRecommendations = get_recommendations
|
2019-10-19 17:55:45 +09:00
|
|
|
|
#: Псевдоним для :attr:`download_animated_cover`
|
2019-08-18 23:44:46 +09:00
|
|
|
|
downloadAnimatedCover = download_animated_cover
|
2019-10-19 17:55:45 +09:00
|
|
|
|
#: Псевдоним для :attr:`download_og_image`
|
2019-08-18 23:44:46 +09:00
|
|
|
|
downloadOgImage = download_og_image
|
2020-05-15 07:49:50 +09:00
|
|
|
|
#: Псевдоним для :attr:`fetch_tracks`
|
2020-05-15 06:48:49 +09:00
|
|
|
|
fetchTracks = fetch_tracks
|