2019-12-28 22:25:09 +09:00
|
|
|
|
from typing import TYPE_CHECKING, Optional, List, Union
|
2019-12-27 18:14:51 +09:00
|
|
|
|
|
2020-01-26 21:19:22 +09:00
|
|
|
|
from yandex_music import YandexMusicObject
|
2021-09-19 22:47:19 +09:00
|
|
|
|
from yandex_music.utils import model
|
2022-02-21 08:12:11 +09:00
|
|
|
|
from yandex_music.exceptions import InvalidBitrateError
|
2020-01-26 21:19:22 +09:00
|
|
|
|
|
2019-12-27 18:14:51 +09:00
|
|
|
|
if TYPE_CHECKING:
|
2021-02-03 21:28:10 +09:00
|
|
|
|
from yandex_music import (
|
|
|
|
|
Client,
|
|
|
|
|
Normalization,
|
|
|
|
|
Major,
|
|
|
|
|
Album,
|
|
|
|
|
Artist,
|
|
|
|
|
Supplement,
|
|
|
|
|
DownloadInfo,
|
|
|
|
|
User,
|
|
|
|
|
MetaData,
|
|
|
|
|
PoetryLoverMatch,
|
|
|
|
|
)
|
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
|
|
|
|
|
2021-09-19 22:47:19 +09:00
|
|
|
|
@model
|
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 Track(YandexMusicObject):
|
2020-03-22 23:43:25 +09:00
|
|
|
|
"""Класс, представляющий трек.
|
|
|
|
|
|
|
|
|
|
Note:
|
|
|
|
|
Известные значения поля `content_warning`: `explicit`.
|
|
|
|
|
|
|
|
|
|
Известные значения поля `type`: `music`.
|
2020-01-26 23:50:54 +09:00
|
|
|
|
|
2020-06-06 23:06:23 +09:00
|
|
|
|
Поля `can_publish`, `state`, `desired_visibility`, `filename`, `user_info` доступны только у треков что были
|
|
|
|
|
загружены пользователем.
|
|
|
|
|
|
2021-01-28 01:24:40 +09:00
|
|
|
|
Обычно у подкастов поле `remember_position == True`, а у треков `remember_position == False`.
|
|
|
|
|
|
2021-02-01 21:57:06 +09:00
|
|
|
|
Полное описание можно получить используя :func:`Track.get_supplement`.
|
|
|
|
|
|
2020-01-26 23:50:54 +09:00
|
|
|
|
Attributes:
|
2020-03-22 23:43:25 +09:00
|
|
|
|
id (:obj:`int` | :obj:`str`): Уникальный идентификатор.
|
|
|
|
|
title (:obj:`str`, optional): Название.
|
|
|
|
|
available (:obj:`bool`, optional): Доступен ли для прослушивания.
|
|
|
|
|
artists (:obj:`list` из :obj:`yandex_music.Artist`, optional): Исполнители.
|
|
|
|
|
albums (:obj:`list` из :obj:`yandex_music.Album`, optional): Альбомы.
|
|
|
|
|
available_for_premium_users (:obj:`bool`, optional): Доступен ли для пользователей с подпиской.
|
|
|
|
|
lyrics_available (:obj:`bool`, optional): Доступен ли текст песни.
|
2020-06-14 21:09:50 +09:00
|
|
|
|
poetry_lover_matches (:obj:`list` из :obj:`yandex_music.PoetryLoverMatch`, optional): Список слов TODO.
|
2020-04-17 04:27:48 +09:00
|
|
|
|
best (:obj:`bool`, optional): Лучшей ли трек TODO.
|
2020-03-22 23:43:25 +09:00
|
|
|
|
real_id (:obj:`int` | :obj:`str`, optional): TODO.
|
|
|
|
|
og_image (:obj:`str`, optional): Ссылка на превью Open Graph.
|
2021-09-19 22:47:19 +09:00
|
|
|
|
type (:obj:`str`, optional): Тип.
|
2020-03-22 23:43:25 +09:00
|
|
|
|
cover_uri (:obj:`str`, optional): Ссылка на изображение с обложкой.
|
|
|
|
|
major (:obj:`yandex_music.Major`, optional): Мейджор-лейбл.
|
|
|
|
|
duration_ms (:obj:`int`, optional): Длительность трека в миллисекундах.
|
|
|
|
|
storage_dir (:obj:`str`, optional): В какой папке на сервере хранится файл TODO.
|
|
|
|
|
file_size (:obj:`int`, optional): Размер файла. TODO добавить единицу измерения.
|
2020-06-06 23:06:23 +09:00
|
|
|
|
substituted (:obj:`yandex_music.Track`, optional): Замещённый трек.
|
|
|
|
|
matched_track (:obj:`yandex_music.Track`, optional): Соответствующий трек TODO.
|
2020-03-22 23:43:25 +09:00
|
|
|
|
normalization (:obj:`list` из :obj:`yandex_music.Normalization`, optional): Значения для нормализации трека.
|
|
|
|
|
error (:obj:`str`, optional): Сообщение об ошибке.
|
2020-06-06 23:06:23 +09:00
|
|
|
|
can_publish (:obj:`bool`, optional): Может ли быть опубликован.
|
|
|
|
|
state (:obj:`str`, optional): Состояние, например, playable.
|
|
|
|
|
desired_visibility (:obj:`str`, optional): Видимость трека.
|
|
|
|
|
filename (:obj:`str`, optional): Название файла.
|
|
|
|
|
user_info (:obj:`yandex_music.User`, optional): Информация о пользователе, который загрузил трек.
|
|
|
|
|
meta_data (:obj:`yandex_music.MetaData`, optional): Информация о метаданных трека.
|
2020-03-22 23:43:25 +09:00
|
|
|
|
regions (:obj:`list` из :obj:`str`, optional): Регион TODO.
|
|
|
|
|
available_as_rbt (:obj:`bool`, optional): TODO.
|
|
|
|
|
content_warning (:obj:`str`, optional): Тип откровенного контента.
|
|
|
|
|
explicit (:obj:`bool`, optional): Содержит ли откровенный контент.
|
|
|
|
|
preview_duration_ms (:obj:`int`, optional): TODO.
|
|
|
|
|
available_full_without_permission (:obj:`bool`, optional): Доступен ли без подписки.
|
|
|
|
|
version (:obj:`str`, optional): Версия.
|
2022-02-21 08:12:11 +09:00
|
|
|
|
remember_position (:obj:`bool`, optional): Если :obj:`True`, то запоминатся последняя позиция прослушивания,
|
2021-01-28 01:24:40 +09:00
|
|
|
|
иначе позиция не запоминается.
|
|
|
|
|
background_video_uri (:obj:`str`, optional): Ссылка на видеошот.
|
2022-02-21 08:12:11 +09:00
|
|
|
|
short_description (:obj:`str`, optional): Краткое опсание эпизода подкаста.
|
2021-01-28 01:24:40 +09:00
|
|
|
|
is_suitable_for_children (:obj:`bool`, optional): Подходит ли для детей TODO.
|
2020-03-22 23:43:25 +09:00
|
|
|
|
client (:obj:`yandex_music.Client`): Клиент Yandex Music.
|
2020-01-26 23:50:54 +09:00
|
|
|
|
"""
|
|
|
|
|
|
2021-09-19 22:47:19 +09:00
|
|
|
|
id: Union[str, int]
|
|
|
|
|
title: Optional[str] = None
|
|
|
|
|
available: Optional[bool] = None
|
|
|
|
|
artists: List['Artist'] = None
|
|
|
|
|
albums: List['Album'] = None
|
|
|
|
|
available_for_premium_users: Optional[bool] = None
|
|
|
|
|
lyrics_available: Optional[bool] = None
|
|
|
|
|
poetry_lover_matches: List['PoetryLoverMatch'] = None
|
|
|
|
|
best: Optional[bool] = None
|
|
|
|
|
real_id: Optional[Union[str, int]] = None
|
|
|
|
|
og_image: Optional[str] = None
|
|
|
|
|
type: Optional[str] = None
|
|
|
|
|
cover_uri: Optional[str] = None
|
|
|
|
|
major: Optional['Major'] = None
|
|
|
|
|
duration_ms: Optional[int] = None
|
|
|
|
|
storage_dir: Optional[str] = None
|
|
|
|
|
file_size: Optional[int] = None
|
|
|
|
|
substituted: Optional['Track'] = None
|
|
|
|
|
matched_track: Optional['Track'] = None
|
|
|
|
|
normalization: Optional['Normalization'] = None
|
|
|
|
|
error: Optional[str] = None
|
|
|
|
|
can_publish: Optional[bool] = None
|
|
|
|
|
state: Optional[str] = None
|
|
|
|
|
desired_visibility: Optional[str] = None
|
|
|
|
|
filename: Optional[str] = None
|
|
|
|
|
user_info: Optional['User'] = None
|
|
|
|
|
meta_data: Optional['MetaData'] = None
|
|
|
|
|
regions: Optional[List[str]] = None
|
|
|
|
|
available_as_rbt: Optional[bool] = None
|
|
|
|
|
content_warning: Optional[str] = None
|
|
|
|
|
explicit: Optional[bool] = None
|
|
|
|
|
preview_duration_ms: Optional[int] = None
|
|
|
|
|
available_full_without_permission: Optional[bool] = None
|
|
|
|
|
version: Optional[str] = None
|
|
|
|
|
remember_position: Optional[bool] = None
|
|
|
|
|
background_video_uri: Optional[str] = None
|
|
|
|
|
short_description: Optional[str] = None
|
|
|
|
|
is_suitable_for_children: Optional[bool] = None
|
|
|
|
|
client: Optional['Client'] = None
|
|
|
|
|
|
|
|
|
|
def __post_init__(self):
|
2022-02-20 02:59:53 +09:00
|
|
|
|
self.download_info = None
|
2020-04-17 04:27:48 +09:00
|
|
|
|
self._id_attrs = (self.id,)
|
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
|
|
|
|
|
2019-12-28 22:25:09 +09:00
|
|
|
|
def get_download_info(self, get_direct_links=False) -> List['DownloadInfo']:
|
2020-03-22 23:43:25 +09:00
|
|
|
|
"""Сокращение для::
|
|
|
|
|
|
2021-02-03 21:28:10 +09:00
|
|
|
|
client.tracks_download_info(self.track_id, get_direct_links)
|
2020-03-22 23:43:25 +09:00
|
|
|
|
"""
|
2019-05-23 18:10:14 +09:00
|
|
|
|
self.download_info = self.client.tracks_download_info(self.track_id, get_direct_links)
|
|
|
|
|
|
|
|
|
|
return self.download_info
|
|
|
|
|
|
2022-02-20 02:59:53 +09:00
|
|
|
|
async def get_download_info_async(self, get_direct_links=False) -> List['DownloadInfo']:
|
|
|
|
|
"""Сокращение для::
|
|
|
|
|
|
|
|
|
|
await client.tracks_download_info(self.track_id, get_direct_links)
|
|
|
|
|
"""
|
|
|
|
|
self.download_info = await self.client.tracks_download_info(self.track_id, get_direct_links)
|
|
|
|
|
|
|
|
|
|
return self.download_info
|
|
|
|
|
|
2019-12-28 22:25:09 +09:00
|
|
|
|
def get_supplement(self, *args, **kwargs) -> Optional['Supplement']:
|
2019-10-17 12:35:24 +09:00
|
|
|
|
"""Сокращение для::
|
|
|
|
|
|
2021-02-03 21:28:10 +09:00
|
|
|
|
client.track_supplement(track.id, *args, **kwargs)
|
2019-10-17 12:35:24 +09:00
|
|
|
|
"""
|
2019-10-19 05:44:17 +09:00
|
|
|
|
return self.client.track_supplement(self.id, *args, **kwargs)
|
2019-10-17 05:10:52 +09:00
|
|
|
|
|
2022-02-20 02:59:53 +09:00
|
|
|
|
async def get_supplement_async(self, *args, **kwargs) -> Optional['Supplement']:
|
|
|
|
|
"""Сокращение для::
|
|
|
|
|
|
|
|
|
|
await client.track_supplement(track.id, *args, **kwargs)
|
|
|
|
|
"""
|
|
|
|
|
return await self.client.track_supplement(self.id, *args, **kwargs)
|
|
|
|
|
|
2019-12-28 22:25:09 +09:00
|
|
|
|
def download_cover(self, filename: str, size: str = '200x200') -> None:
|
2019-08-18 23:44:46 +09:00
|
|
|
|
"""Загрузка обложки.
|
|
|
|
|
|
|
|
|
|
Args:
|
|
|
|
|
filename (:obj:`str`): Путь для сохранения файла с названием и расширением.
|
|
|
|
|
size (:obj:`str`, optional): Размер обложки.
|
|
|
|
|
"""
|
|
|
|
|
self.client.request.download(f'https://{self.cover_uri.replace("%%", size)}', filename)
|
|
|
|
|
|
2022-02-20 02:59:53 +09:00
|
|
|
|
async def download_cover_async(self, filename: str, size: str = '200x200') -> None:
|
|
|
|
|
"""Загрузка обложки.
|
|
|
|
|
|
|
|
|
|
Args:
|
|
|
|
|
filename (:obj:`str`): Путь для сохранения файла с названием и расширением.
|
|
|
|
|
size (:obj:`str`, optional): Размер обложки.
|
|
|
|
|
"""
|
|
|
|
|
await self.client.request.download(f'https://{self.cover_uri.replace("%%", size)}', filename)
|
|
|
|
|
|
2019-12-28 22:25:09 +09:00
|
|
|
|
def download_og_image(self, filename: str, size: str = '200x200') -> None:
|
2019-08-18 23:44:46 +09:00
|
|
|
|
"""Загрузка обложки.
|
|
|
|
|
|
2020-01-26 21:19:22 +09:00
|
|
|
|
Предпочтительнее использовать `self.download_cover()`.
|
2019-08-18 23:44:46 +09:00
|
|
|
|
|
|
|
|
|
Args:
|
|
|
|
|
filename (:obj:`str`): Путь для сохранения файла с названием и расширением.
|
|
|
|
|
size (:obj:`str`, optional): Размер обложки.
|
|
|
|
|
"""
|
2019-11-08 04:52:26 +09:00
|
|
|
|
self.client.request.download(f'https://{self.og_image.replace("%%", size)}', filename)
|
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
|
|
|
|
|
2022-02-20 02:59:53 +09:00
|
|
|
|
async def download_og_image_async(self, filename: str, size: str = '200x200') -> None:
|
|
|
|
|
"""Загрузка обложки.
|
|
|
|
|
|
|
|
|
|
Предпочтительнее использовать `self.download_cover_async()`.
|
|
|
|
|
|
|
|
|
|
Args:
|
|
|
|
|
filename (:obj:`str`): Путь для сохранения файла с названием и расширением.
|
|
|
|
|
size (:obj:`str`, optional): Размер обложки.
|
|
|
|
|
"""
|
|
|
|
|
await self.client.request.download(f'https://{self.og_image.replace("%%", size)}', filename)
|
|
|
|
|
|
2019-12-28 22:25:09 +09:00
|
|
|
|
def download(self, filename: str, codec: str = 'mp3', bitrate_in_kbps: int = 192) -> None:
|
2020-03-22 23:43:25 +09:00
|
|
|
|
"""Загрузка трека.
|
|
|
|
|
|
|
|
|
|
Note:
|
|
|
|
|
Известные значения `codec`: `mp3`, `aac`.
|
|
|
|
|
|
|
|
|
|
Известные значения `bitrate_in_kbps`: `64`, `128`, `192`, `320`.
|
|
|
|
|
|
|
|
|
|
Args:
|
|
|
|
|
filename (:obj:`str`): Путь для сохранения файла с названием и расширением.
|
|
|
|
|
codec (:obj:`str`, optional): Кодек из доступных в `self.download_info`.
|
|
|
|
|
bitrate_in_kbps (:obj:`int`, optional): Битрейт из доступных в `self.download_info` для данного кодека.
|
|
|
|
|
|
|
|
|
|
Raises:
|
2022-02-21 06:15:27 +09:00
|
|
|
|
:class:`yandex_music.exceptions.InvalidBitrateError`: Если в `self.download_info` не найден подходящий трек.
|
2020-03-22 23:43:25 +09:00
|
|
|
|
"""
|
2019-05-23 18:10:14 +09:00
|
|
|
|
if self.download_info is None:
|
|
|
|
|
self.get_download_info()
|
|
|
|
|
|
|
|
|
|
for info in self.download_info:
|
|
|
|
|
if info.codec == codec and info.bitrate_in_kbps == bitrate_in_kbps:
|
|
|
|
|
info.download(filename)
|
2020-02-24 18:01:26 +09:00
|
|
|
|
break
|
|
|
|
|
else:
|
2022-02-21 06:15:27 +09:00
|
|
|
|
raise InvalidBitrateError('Unavailable bitrate')
|
2019-05-23 18:10:14 +09:00
|
|
|
|
|
2022-02-20 02:59:53 +09:00
|
|
|
|
async def download_async(self, filename: str, codec: str = 'mp3', bitrate_in_kbps: int = 192) -> None:
|
|
|
|
|
"""Загрузка трека.
|
|
|
|
|
|
|
|
|
|
Note:
|
|
|
|
|
Известные значения `codec`: `mp3`, `aac`.
|
|
|
|
|
|
|
|
|
|
Известные значения `bitrate_in_kbps`: `64`, `128`, `192`, `320`.
|
|
|
|
|
|
|
|
|
|
Args:
|
|
|
|
|
filename (:obj:`str`): Путь для сохранения файла с названием и расширением.
|
|
|
|
|
codec (:obj:`str`, optional): Кодек из доступных в `self.download_info`.
|
|
|
|
|
bitrate_in_kbps (:obj:`int`, optional): Битрейт из доступных в `self.download_info` для данного кодека.
|
|
|
|
|
|
|
|
|
|
Raises:
|
2022-02-21 06:15:27 +09:00
|
|
|
|
:class:`yandex_music.exceptions.InvalidBitrateError`: Если в `self.download_info` не найден подходящий трек.
|
2022-02-20 02:59:53 +09:00
|
|
|
|
"""
|
|
|
|
|
if self.download_info is None:
|
|
|
|
|
await self.get_download_info_async()
|
|
|
|
|
|
|
|
|
|
for info in self.download_info:
|
|
|
|
|
if info.codec == codec and info.bitrate_in_kbps == bitrate_in_kbps:
|
|
|
|
|
await info.download_async(filename)
|
|
|
|
|
break
|
|
|
|
|
else:
|
2022-02-21 06:15:27 +09:00
|
|
|
|
raise InvalidBitrateError('Unavailable bitrate')
|
2022-02-20 02:59:53 +09:00
|
|
|
|
|
2019-12-28 22:25:09 +09:00
|
|
|
|
def like(self, *args, **kwargs) -> bool:
|
2019-10-07 02:06:28 +09:00
|
|
|
|
"""Сокращение для::
|
|
|
|
|
|
2021-02-03 21:28:10 +09:00
|
|
|
|
client.users_likes_tracks_add(track.id, user.id, *args, **kwargs)
|
2019-10-07 02:06:28 +09:00
|
|
|
|
"""
|
2019-12-24 06:20:07 +09:00
|
|
|
|
return self.client.users_likes_tracks_add(self.track_id, self.client.me.account.uid, *args, **kwargs)
|
2019-10-07 02:06:28 +09:00
|
|
|
|
|
2022-02-20 02:59:53 +09:00
|
|
|
|
async def like_async(self, *args, **kwargs) -> bool:
|
|
|
|
|
"""Сокращение для::
|
|
|
|
|
|
|
|
|
|
await client.users_likes_tracks_add(track.id, user.id, *args, **kwargs)
|
|
|
|
|
"""
|
|
|
|
|
return await self.client.users_likes_tracks_add(self.track_id, self.client.me.account.uid, *args, **kwargs)
|
|
|
|
|
|
2019-12-28 22:25:09 +09:00
|
|
|
|
def dislike(self, *args, **kwargs) -> bool:
|
2019-10-07 02:06:28 +09:00
|
|
|
|
"""Сокращение для::
|
|
|
|
|
|
2021-02-03 21:28:10 +09:00
|
|
|
|
client.users_likes_tracks_remove(track.id, user.id *args, **kwargs)
|
2019-10-07 02:06:28 +09:00
|
|
|
|
"""
|
2019-12-24 06:20:07 +09:00
|
|
|
|
return self.client.users_likes_tracks_remove(self.track_id, self.client.me.account.uid, *args, **kwargs)
|
2019-10-07 02:06:28 +09:00
|
|
|
|
|
2022-02-20 02:59:53 +09:00
|
|
|
|
async def dislike_async(self, *args, **kwargs) -> bool:
|
|
|
|
|
"""Сокращение для::
|
|
|
|
|
|
|
|
|
|
await client.users_likes_tracks_remove(track.id, user.id *args, **kwargs)
|
|
|
|
|
"""
|
|
|
|
|
return await self.client.users_likes_tracks_remove(self.track_id, self.client.me.account.uid, *args, **kwargs)
|
|
|
|
|
|
2021-02-06 20:51:33 +09:00
|
|
|
|
def artists_name(self) -> List[str]:
|
|
|
|
|
"""Получает имена всех исполнителей.
|
|
|
|
|
|
|
|
|
|
Returns:
|
|
|
|
|
:obj:`list` из :obj:`str`: Имена исполнителей.
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
return [i.name for i in self.artists]
|
|
|
|
|
|
2019-05-19 05:59:14 +09:00
|
|
|
|
@property
|
2019-12-28 22:25:09 +09:00
|
|
|
|
def track_id(self) -> str:
|
2020-03-22 23:43:25 +09:00
|
|
|
|
""":obj:`str`: Уникальный идентификатор трека состоящий из его номера и номера альбома или просто из номера."""
|
2020-01-23 00:08:08 +09:00
|
|
|
|
if self.albums:
|
|
|
|
|
return f'{self.id}:{self.albums[0].id}'
|
2019-05-19 05:59:14 +09:00
|
|
|
|
return f'{self.id}'
|
|
|
|
|
|
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-28 22:25:09 +09:00
|
|
|
|
def de_json(cls, data: dict, client: 'Client') -> Optional['Track']:
|
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 23:43:25 +09:00
|
|
|
|
:obj:`yandex_music.Track`: Трек.
|
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(Track, cls).de_json(data, client)
|
2020-06-14 21:09:50 +09:00
|
|
|
|
from yandex_music import Normalization, Major, Album, Artist, User, MetaData, PoetryLoverMatch
|
2021-02-03 21:28:10 +09:00
|
|
|
|
|
2019-10-27 23:14:11 +09:00
|
|
|
|
data['albums'] = Album.de_list(data.get('albums'), client)
|
|
|
|
|
data['artists'] = Artist.de_list(data.get('artists'), client)
|
2019-06-03 01:23:29 +09:00
|
|
|
|
data['normalization'] = Normalization.de_json(data.get('normalization'), client)
|
|
|
|
|
data['major'] = Major.de_json(data.get('major'), client)
|
2020-06-06 23:06:23 +09:00
|
|
|
|
data['substituted'] = Track.de_json(data.get('substituted'), client)
|
|
|
|
|
data['matched_track'] = Track.de_json(data.get('matched_track'), client)
|
|
|
|
|
data['user_info'] = User.de_json(data.get('user_info'), client)
|
|
|
|
|
data['meta_data'] = MetaData.de_json(data.get('meta_data'), client)
|
2020-06-14 21:09:50 +09:00
|
|
|
|
data['poetry_lover_matches'] = PoetryLoverMatch.de_list(data.get('poetry_lover_matches'), 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
|
|
|
|
|
|
|
|
|
return cls(client=client, **data)
|
|
|
|
|
|
|
|
|
|
@classmethod
|
2019-12-28 22:25:09 +09:00
|
|
|
|
def de_list(cls, data: dict, client: 'Client') -> List['Track']:
|
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 23:43:25 +09:00
|
|
|
|
:obj:`list` из :obj:`yandex_music.Track`: Треки.
|
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-06-06 23:06:23 +09:00
|
|
|
|
return [cls.de_json(track, client) for track in data]
|
2019-08-18 18:54:13 +09:00
|
|
|
|
|
|
|
|
|
# camelCase псевдонимы
|
|
|
|
|
|
2019-10-19 17:55:45 +09:00
|
|
|
|
#: Псевдоним для :attr:`get_download_info`
|
2019-08-18 18:54:13 +09:00
|
|
|
|
getDownloadInfo = get_download_info
|
2022-02-20 02:59:53 +09:00
|
|
|
|
#: Псевдоним для :attr:`get_download_info_async`
|
|
|
|
|
getDownloadInfoAsync = get_download_info_async
|
2019-10-19 17:55:45 +09:00
|
|
|
|
#: Псевдоним для :attr:`get_supplement`
|
2019-10-19 05:44:17 +09:00
|
|
|
|
getSupplement = get_supplement
|
2022-02-20 02:59:53 +09:00
|
|
|
|
#: Псевдоним для :attr:`get_supplement_async`
|
|
|
|
|
getSupplementAsync = get_supplement_async
|
2019-10-19 17:55:45 +09:00
|
|
|
|
#: Псевдоним для :attr:`download_cover`
|
2019-08-18 18:54:13 +09:00
|
|
|
|
downloadCover = download_cover
|
2022-02-20 02:59:53 +09:00
|
|
|
|
#: Псевдоним для :attr:`download_cover_async`
|
|
|
|
|
downloadCoverAsync = download_cover_async
|
2019-10-19 17:55:45 +09:00
|
|
|
|
#: Псевдоним для :attr:`download_og_image`
|
2019-08-18 23:44:46 +09:00
|
|
|
|
downloadOgImage = download_og_image
|
2022-02-20 02:59:53 +09:00
|
|
|
|
#: Псевдоним для :attr:`download_og_image_async`
|
|
|
|
|
downloadOgImageAsync = download_og_image_async
|
2019-10-19 17:55:45 +09:00
|
|
|
|
#: Псевдоним для :attr:`track_id`
|
2019-08-18 18:54:13 +09:00
|
|
|
|
trackId = track_id
|
2022-02-20 02:59:53 +09:00
|
|
|
|
#: Псевдоним для :attr:`like_async`
|
|
|
|
|
likeAsync = like_async
|
|
|
|
|
#: Псевдоним для :attr:`dislike_async`
|
|
|
|
|
dislike_async = dislike_async
|
|
|
|
|
#: Псевдоним для :attr:`download_async`
|
|
|
|
|
downloadAsync = download_async
|