2019-12-27 18:14:51 +09:00
|
|
|
|
from typing import TYPE_CHECKING, Optional, List
|
|
|
|
|
|
|
|
|
|
if TYPE_CHECKING:
|
2019-12-27 21:32:50 +09:00
|
|
|
|
from yandex_music import Client, Artist, Label, TrackPosition, Track
|
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
|
|
|
|
from yandex_music import YandexMusicObject
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Album(YandexMusicObject):
|
2020-01-26 05:13:40 +09:00
|
|
|
|
"""Класс, представляющий альбом.
|
|
|
|
|
|
|
|
|
|
Известные типы альбома: `single` - сингл, `compilation` - сборник.
|
|
|
|
|
|
|
|
|
|
Известные предупреждения о содержимом: `explicit` - ненормативная лексика.
|
|
|
|
|
|
|
|
|
|
Известные ошибки: `not-found` - альбом с таким ID не существует.
|
|
|
|
|
|
|
|
|
|
Attributes:
|
|
|
|
|
id (:obj:`int`): Идентификатор альбома.
|
|
|
|
|
error (:obj:`str`): Ошибка получения альбома.
|
|
|
|
|
title (:obj:`str`): Название альбома.
|
|
|
|
|
track_count (:obj:`int`): Количество треков.
|
|
|
|
|
artists (:obj:`list` из :obj:`yandex_music.Artist`): Список объектов класса
|
|
|
|
|
:class:`yandex_music.Artist` представляющие артистов.
|
|
|
|
|
labels (:obj:`list` из :obj:`yandex_music.Label`): Список объектов класса
|
|
|
|
|
:class:`yandex_music.Label` представляющие лейблы.
|
|
|
|
|
available (:obj:`bool`): Доступен ли альбом.
|
|
|
|
|
available_for_premium_users (:obj:`bool`): Доступен ли альбом для пользователей с подпиской.
|
|
|
|
|
version (:obj:`str`): Дополнительная информация об альбоме.
|
|
|
|
|
cover_uri (:obj:`str`): Ссылка на обложку.
|
|
|
|
|
content_warning (:obj:`str`): Предупреждение о содержимом альбома.
|
|
|
|
|
genre (:obj:`str`): Жанр музыки.
|
|
|
|
|
og_image (:obj:`str`): Ссылка на превью Open Graph.
|
|
|
|
|
recent (:obj:`bool`): Является ли альбом новым.
|
|
|
|
|
very_important (:obj:`bool`): Популярен ли альбом у слушателей.
|
|
|
|
|
available_for_mobile (:obj:`bool`): Доступен ли альбом из приложения для телефона.
|
|
|
|
|
available_partially (:obj:`bool`): Доступен ли альбом частично для пользователей без подписки.
|
|
|
|
|
bests (:obj:`list` из :obj:`int`): ID лучших треков альбома.
|
|
|
|
|
volumes (:obj:`list` из :obj:`list` из :obj:`Track`): Треки альбома, разделенные по дискам.
|
|
|
|
|
year (:obj:`int`): Год релиза.
|
|
|
|
|
release_date (:obj:`str`): Дата релиза в формате ISO 8601.
|
|
|
|
|
type (:obj:`str`): Тип альбома.
|
|
|
|
|
track_position (:obj:`yandex_music.TrackPosition`): Объект класса :class:`yandex_music.TrackPosition`
|
|
|
|
|
представляющий позицию трека. Возвращается при получении альбома в составе трека.
|
|
|
|
|
client (:obj:`yandex_music.Client`): Объект класса :class:`yandex_music.Client` представляющий клиент
|
|
|
|
|
Yandex Music.
|
|
|
|
|
|
|
|
|
|
Args:
|
|
|
|
|
id_ (:obj:`int`): Идентификатор альбома.
|
|
|
|
|
error (:obj:`str`, optional): Ошибка получения альбома.
|
|
|
|
|
title (:obj:`str`, optional): Название альбома.
|
|
|
|
|
track_count (:obj:`int`, optional): Количество треков.
|
|
|
|
|
artists (:obj:`list` из :obj:`yandex_music.Artist`, optional): Список объектов класса
|
|
|
|
|
:class:`yandex_music.Artist` представляющие артистов.
|
|
|
|
|
labels (:obj:`list` из :obj:`yandex_music.Label`, optional): Список объектов класса
|
|
|
|
|
:class:`yandex_music.Label` представляющие лейблы.
|
|
|
|
|
available (:obj:`bool`, optional): Доступен ли альбом.
|
|
|
|
|
available_for_premium_users (:obj:`bool`, optional): Доступен ли альбом для пользователей с подпиской.
|
|
|
|
|
version (:obj:`str`, optional): Дополнительная информация об альбоме.
|
|
|
|
|
cover_uri (:obj:`str`, optional): Ссылка на обложку.
|
|
|
|
|
content_warning (:obj:`str`, optional): Предупреждение о содержимом альбома.
|
|
|
|
|
genre (:obj:`str`, optional): Жанр музыки.
|
|
|
|
|
og_image (:obj:`str`, optional): Ссылка на превью Open Graph.
|
|
|
|
|
recent (:obj:`bool`, optional): Является ли альбом новым.
|
|
|
|
|
very_important (:obj:`bool`, optional): Популярен ли альбом у слушателей.
|
|
|
|
|
available_for_mobile (:obj:`bool`, optional): Доступен ли альбом из приложения для телефона.
|
|
|
|
|
available_partially (:obj:`bool`, optional): Доступен ли альбом частично для пользователей без подписки.
|
|
|
|
|
bests (:obj:`list` из :obj:`int`, optional): ID лучших треков альбома.
|
|
|
|
|
volumes (:obj:`list` из :obj:`list` из :obj:`Track`, optional): Треки альбома, разделенные по дискам.
|
|
|
|
|
year (:obj:`int`, optional): Год релиза.
|
|
|
|
|
release_date (:obj:`str`, optional): Дата релиза в формате ISO 8601.
|
|
|
|
|
type_ (:obj:`str`, optional): Тип альбома.
|
|
|
|
|
track_position (:obj:`yandex_music.TrackPosition`, optional): Объект класса :class:`yandex_music.TrackPosition`
|
|
|
|
|
представляющий позицию трека. Возвращается при получении альбома в составе трека.
|
|
|
|
|
client (:obj:`yandex_music.Client`, optional): Объект класса :class:`yandex_music.Client` представляющий клиент
|
|
|
|
|
Yandex Music.
|
|
|
|
|
**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-28 22:25:09 +09:00
|
|
|
|
id_: int,
|
2020-01-23 22:51:01 +09:00
|
|
|
|
error: Optional[str] = None,
|
|
|
|
|
title: Optional[str] = None,
|
|
|
|
|
track_count: Optional[int] = None,
|
|
|
|
|
artists: List['Artist'] = None,
|
|
|
|
|
labels: List['Label'] = None,
|
|
|
|
|
available: Optional[bool] = None,
|
|
|
|
|
available_for_premium_users: Optional[bool] = None,
|
2020-01-14 02:24:52 +09:00
|
|
|
|
version: Optional[str] = None,
|
2019-12-28 22:25:09 +09:00
|
|
|
|
cover_uri: Optional[str] = None,
|
2020-01-26 05:13:40 +09:00
|
|
|
|
content_warning: Optional[str] = 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
|
|
|
|
original_release_year=None,
|
2019-12-28 22:25:09 +09:00
|
|
|
|
genre: Optional[str] = None,
|
|
|
|
|
og_image: Optional[str] = None,
|
|
|
|
|
buy: Optional[list] = None,
|
|
|
|
|
recent: Optional[bool] = None,
|
|
|
|
|
very_important: Optional[bool] = None,
|
|
|
|
|
available_for_mobile: Optional[bool] = None,
|
|
|
|
|
available_partially: Optional[bool] = None,
|
|
|
|
|
bests: Optional[List[int]] = None,
|
|
|
|
|
prerolls: Optional[list] = None,
|
2020-01-26 05:13:40 +09:00
|
|
|
|
volumes: Optional[List[List['Track']]] = None,
|
2019-12-28 22:25:09 +09:00
|
|
|
|
year: Optional[int] = None,
|
|
|
|
|
release_date: Optional[str] = None,
|
|
|
|
|
type_: Optional[str] = None,
|
2019-12-27 21:32:50 +09:00
|
|
|
|
track_position: Optional['TrackPosition'] = 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:
|
2019-12-27 04:51:29 +09:00
|
|
|
|
self.id = id_
|
2020-01-23 22:51:01 +09:00
|
|
|
|
|
|
|
|
|
self.error = error
|
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.title = title
|
|
|
|
|
self.track_count = track_count
|
|
|
|
|
self.artists = artists
|
|
|
|
|
self.labels = labels
|
|
|
|
|
self.available_for_premium_users = available_for_premium_users
|
|
|
|
|
self.available = available
|
2020-01-14 02:24:52 +09:00
|
|
|
|
self.version = version
|
2019-11-08 06:37:53 +09:00
|
|
|
|
self.cover_uri = cover_uri
|
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.genre = genre
|
|
|
|
|
self.year = year
|
2019-11-08 04:52:26 +09:00
|
|
|
|
self.release_date = release_date
|
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.bests = bests
|
2019-08-28 04:07:42 +09:00
|
|
|
|
self.prerolls = prerolls
|
|
|
|
|
self.volumes = volumes
|
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.og_image = og_image
|
|
|
|
|
self.buy = buy
|
|
|
|
|
self.recent = recent
|
|
|
|
|
self.very_important = very_important
|
|
|
|
|
self.available_for_mobile = available_for_mobile
|
|
|
|
|
self.available_partially = available_partially
|
2019-12-27 04:51:29 +09:00
|
|
|
|
self.type = type_
|
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.track_position = track_position
|
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
|
|
|
|
|
self.original_release_year = original_release_year
|
|
|
|
|
self.content_warning = content_warning
|
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
|
2020-01-23 22:51:01 +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-27 21:32:50 +09:00
|
|
|
|
def with_tracks(self, *args, **kwargs) -> Optional['Album']:
|
2019-08-28 04:07:42 +09:00
|
|
|
|
"""Сокращение для::
|
|
|
|
|
|
|
|
|
|
client.albums_with_tracks(album.id, *args, **kwargs)
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
return self.client.albums_with_tracks(self.id, *args, **kwargs)
|
|
|
|
|
|
2019-12-27 21:32:50 +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)
|
|
|
|
|
|
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.download_cover().
|
|
|
|
|
|
|
|
|
|
Args:
|
|
|
|
|
filename (:obj:`str`): Путь для сохранения файла с названием и расширением.
|
|
|
|
|
size (:obj:`str`, optional): Размер обложки.
|
|
|
|
|
"""
|
|
|
|
|
|
2019-12-28 22:25:09 +09:00
|
|
|
|
self.client.request.download(f'https://{self.og_image.replace("%%", size)}', filename)
|
2019-08-18 23:44:46 +09:00
|
|
|
|
|
2019-12-27 21:32:50 +09:00
|
|
|
|
def like(self, *args, **kwargs) -> bool:
|
2019-10-07 02:06:28 +09:00
|
|
|
|
"""Сокращение для::
|
|
|
|
|
|
|
|
|
|
client.users_likes_albums_add(album.id, user.id *args, **kwargs)
|
|
|
|
|
"""
|
2019-12-24 06:20:07 +09:00
|
|
|
|
return self.client.users_likes_albums_add(self.id, self.client.me.account.uid, *args, **kwargs)
|
2019-10-07 02:06:28 +09:00
|
|
|
|
|
2019-12-27 21:32:50 +09:00
|
|
|
|
def dislike(self, *args, **kwargs) -> bool:
|
2019-10-07 02:06:28 +09:00
|
|
|
|
"""Сокращение для::
|
|
|
|
|
|
|
|
|
|
client.users_likes_albums_remove(album.id, user.id *args, **kwargs)
|
|
|
|
|
"""
|
2019-12-24 06:20:07 +09:00
|
|
|
|
return self.client.users_likes_albums_remove(self.id, self.client.me.account.uid, *args, **kwargs)
|
2019-10-07 02:06:28 +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
|
|
|
|
@classmethod
|
2019-12-27 21:32:50 +09:00
|
|
|
|
def de_json(cls, data: dict, client: 'Client') -> Optional['Album']:
|
2020-01-26 05:13:40 +09:00
|
|
|
|
"""Десериализация объекта.
|
|
|
|
|
|
|
|
|
|
Args:
|
|
|
|
|
data (:obj:`dict`): Поля и значения десериализуемого объекта.
|
|
|
|
|
client (:obj:`yandex_music.Client`): Объект класса :class:`yandex_music.Client` представляющий клиент Yandex
|
|
|
|
|
Music.
|
|
|
|
|
|
|
|
|
|
Returns:
|
|
|
|
|
:obj:`yandex_music.Album`: Объект класса :class:`yandex_music.Album`.
|
|
|
|
|
"""
|
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(Album, cls).de_json(data, client)
|
2019-08-28 04:07:42 +09:00
|
|
|
|
from yandex_music import Artist, Label, TrackPosition, Track
|
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['artists'] = Artist.de_list(data.get('artists'), client)
|
|
|
|
|
data['labels'] = Label.de_list(data.get('labels'), client)
|
|
|
|
|
data['track_position'] = TrackPosition.de_json(data.get('track_position'), client)
|
2019-08-28 04:07:42 +09:00
|
|
|
|
if data.get('volumes'):
|
|
|
|
|
data['volumes'] = [Track.de_list(i, client) for i in data['volumes']]
|
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 21:32:50 +09:00
|
|
|
|
def de_list(cls, data: dict, client: 'Client') -> List['Album']:
|
2020-01-26 05:13:40 +09:00
|
|
|
|
"""Десериализация списка объектов.
|
|
|
|
|
|
|
|
|
|
Args:
|
|
|
|
|
data (:obj:`list`): Список словарей с полями и значениями десериализуемого объекта.
|
|
|
|
|
client (:obj:`yandex_music.Client`): Объект класса :class:`yandex_music.Client` представляющий клиент Yandex
|
|
|
|
|
Music.
|
|
|
|
|
|
|
|
|
|
Returns:
|
|
|
|
|
:obj:`list` из :obj:`yandex_music.Album`: Список объектов класса :class:`yandex_music.Album`.
|
|
|
|
|
"""
|
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 []
|
|
|
|
|
|
|
|
|
|
albums = list()
|
|
|
|
|
for album in data:
|
|
|
|
|
albums.append(cls.de_json(album, client))
|
|
|
|
|
|
|
|
|
|
return albums
|
2019-08-18 23:44:46 +09:00
|
|
|
|
|
|
|
|
|
# camelCase псевдонимы
|
|
|
|
|
|
2019-10-19 17:55:45 +09:00
|
|
|
|
#: Псевдоним для :attr:`with_tracks`
|
2019-08-28 04:07:42 +09:00
|
|
|
|
withTracks = with_tracks
|
2019-10-19 17:55:45 +09:00
|
|
|
|
#: Псевдоним для :attr:`download_cover`
|
2019-08-18 23:44:46 +09:00
|
|
|
|
downloadCover = download_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
|