2019-05-11 17:37:47 +09:00
|
|
|
|
from yandex_music import YandexMusicObject
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Artist(YandexMusicObject):
|
|
|
|
|
def __init__(self,
|
|
|
|
|
id,
|
|
|
|
|
name,
|
|
|
|
|
various,
|
|
|
|
|
composer,
|
|
|
|
|
cover,
|
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
|
|
|
|
genres=None,
|
2019-05-11 17:37:47 +09:00
|
|
|
|
op_image=None,
|
|
|
|
|
no_pictures_from_search=None,
|
|
|
|
|
counts=None,
|
|
|
|
|
available=None,
|
|
|
|
|
ratings=None,
|
|
|
|
|
links=None,
|
|
|
|
|
tickets_available=None,
|
Добавлен метод получения информации об артисте (Brief Info https://github.com/MarshalX/yandex-music-api/issues/9).
Добавлены следующие классы: BriefInfo, Description, Vinyl, PlaylistId.
Класс Video вынесен из пакета Search в корень.
Добавлен de_list в Cover.
Добавлены следующие поля в класс Artist: likes_count, full_names, description, countries, en_wikipedia_link, db_aliases, aliases, init_date, end_date.
Добавлено поле track_id в класс Chart.
Добавлено поле available_full_without_permission в класс Track.
Класс Video расширен для поддержки второго типа (используется в brief info, спасибо яндух) видео (добавлены необязательные поля cover, embed_url, provider, provider_video_id).
Обновлена документация.
2019-09-13 00:32:43 +09:00
|
|
|
|
likes_count=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
|
|
|
|
popular_tracks=None,
|
|
|
|
|
regions=None,
|
|
|
|
|
decomposed=None,
|
Добавлен метод получения информации об артисте (Brief Info https://github.com/MarshalX/yandex-music-api/issues/9).
Добавлены следующие классы: BriefInfo, Description, Vinyl, PlaylistId.
Класс Video вынесен из пакета Search в корень.
Добавлен de_list в Cover.
Добавлены следующие поля в класс Artist: likes_count, full_names, description, countries, en_wikipedia_link, db_aliases, aliases, init_date, end_date.
Добавлено поле track_id в класс Chart.
Добавлено поле available_full_without_permission в класс Track.
Класс Video расширен для поддержки второго типа (используется в brief info, спасибо яндух) видео (добавлены необязательные поля cover, embed_url, provider, provider_video_id).
Обновлена документация.
2019-09-13 00:32:43 +09:00
|
|
|
|
full_names=None,
|
|
|
|
|
description=None,
|
|
|
|
|
countries=None,
|
|
|
|
|
en_wikipedia_link=None,
|
|
|
|
|
db_aliases=None,
|
|
|
|
|
aliases=None,
|
|
|
|
|
init_date=None,
|
|
|
|
|
end_date=None,
|
2019-05-11 17:37:47 +09:00
|
|
|
|
client=None,
|
|
|
|
|
**kwargs):
|
|
|
|
|
self.id = id
|
|
|
|
|
self.name = name
|
|
|
|
|
self.various = various
|
|
|
|
|
self.composer = composer
|
|
|
|
|
self.cover = cover
|
|
|
|
|
|
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.genres = genres
|
2019-05-11 17:37:47 +09:00
|
|
|
|
self.op_image = op_image
|
|
|
|
|
self.no_pictures_from_search = no_pictures_from_search
|
|
|
|
|
self.counts = counts
|
|
|
|
|
self.available = available
|
|
|
|
|
self.ratings = ratings
|
|
|
|
|
self.links = links
|
|
|
|
|
self.tickets_available = tickets_available
|
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.decomposed = decomposed
|
|
|
|
|
self.popular_tracks = popular_tracks
|
Добавлен метод получения информации об артисте (Brief Info https://github.com/MarshalX/yandex-music-api/issues/9).
Добавлены следующие классы: BriefInfo, Description, Vinyl, PlaylistId.
Класс Video вынесен из пакета Search в корень.
Добавлен de_list в Cover.
Добавлены следующие поля в класс Artist: likes_count, full_names, description, countries, en_wikipedia_link, db_aliases, aliases, init_date, end_date.
Добавлено поле track_id в класс Chart.
Добавлено поле available_full_without_permission в класс Track.
Класс Video расширен для поддержки второго типа (используется в brief info, спасибо яндух) видео (добавлены необязательные поля cover, embed_url, provider, provider_video_id).
Обновлена документация.
2019-09-13 00:32:43 +09:00
|
|
|
|
self.likes_count = likes_count
|
|
|
|
|
self.full_names = full_names
|
|
|
|
|
self.description = description
|
|
|
|
|
self.countries = countries
|
|
|
|
|
self.en_wikipedia_link = en_wikipedia_link
|
|
|
|
|
self.db_aliases = db_aliases
|
|
|
|
|
self.aliases = aliases
|
|
|
|
|
|
|
|
|
|
# Оставлено строкой потому что может прийти конкретная дата или просто год
|
|
|
|
|
self.init_date = init_date
|
|
|
|
|
self.end_date = end_date
|
2019-05-11 17:37:47 +09:00
|
|
|
|
|
|
|
|
|
self.client = client
|
Добавлены основные тесты для следующих классов: Album, Artist, Chart, Counts, Genre, Label, PermissionAlerts, PromoCodeStatus, Restrictions, Settings, Station, StatuonResult, Status, Track.
Исправлены фикстуры и сравнения для вышеперечисленных классов.
Отрефакторен restrictions.py.
Исправлен баг в .to_dict() методе, связанный с десериализцией объектов списков и словарей.
2019-11-09 00:24:54 +09:00
|
|
|
|
self._id_attrs = (self.id, self.name, self.various, self.composer, self.cover)
|
2019-05-11 17:37:47 +09:00
|
|
|
|
|
2019-08-18 23:44:46 +09:00
|
|
|
|
def download_op_image(self, filename, size='200x200'):
|
|
|
|
|
"""Загрузка обложки.
|
|
|
|
|
|
|
|
|
|
Используйте это только когда нет self.cover!
|
|
|
|
|
|
|
|
|
|
Args:
|
|
|
|
|
filename (:obj:`str`): Путь для сохранения файла с названием и расширением.
|
|
|
|
|
size (:obj:`str`, optional): Размер обложки.
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
self.client.request.download(f'https://{self.op_image.replace("%%", size)}', filename)
|
|
|
|
|
|
2019-10-07 02:06:28 +09:00
|
|
|
|
def like(self, *args, **kwargs):
|
|
|
|
|
"""Сокращение для::
|
|
|
|
|
|
|
|
|
|
client.users_likes_artists_add(artist.id, user.id *args, **kwargs)
|
|
|
|
|
"""
|
|
|
|
|
return self.client.users_likes_artists_add(self.id, self.client.account.uid, *args, **kwargs)
|
|
|
|
|
|
|
|
|
|
def dislike(self, *args, **kwargs):
|
|
|
|
|
"""Сокращение для::
|
|
|
|
|
|
|
|
|
|
client.users_likes_artists_remove(artist.id, user.id *args, **kwargs)
|
|
|
|
|
"""
|
|
|
|
|
return self.client.users_likes_artists_remove(self.id, self.client.account.uid, *args, **kwargs)
|
|
|
|
|
|
2019-10-27 23:14:11 +09:00
|
|
|
|
def get_tracks(self, page=0, page_size=20, *args, **kwargs):
|
|
|
|
|
"""Сокращение для::
|
2019-10-22 00:08:24 +09:00
|
|
|
|
|
2019-10-27 23:14:11 +09:00
|
|
|
|
client.artists_tracks(artist.id, page, page_size, *args, **kwargs)
|
2019-10-22 00:08:24 +09:00
|
|
|
|
"""
|
2019-10-21 23:47:31 +09:00
|
|
|
|
return self.client.artists_tracks(self.id, page, page_size, *args, **kwargs)
|
|
|
|
|
|
2019-11-20 02:30:07 +09:00
|
|
|
|
def get_albums(self, page=0, page_size=20, sort_by='year', *args, **kwargs):
|
2019-11-20 02:52:17 +09:00
|
|
|
|
"""Сокращение для::
|
|
|
|
|
|
|
|
|
|
client.artists_albums(artist.id, page, page_size, sort_by, *args, **kwargs)
|
|
|
|
|
"""
|
2019-11-20 02:30:07 +09:00
|
|
|
|
return self.client.artists_albums(self.id, page, page_size, sort_by, *args, **kwargs)
|
|
|
|
|
|
2019-05-11 17:37:47 +09:00
|
|
|
|
@classmethod
|
|
|
|
|
def de_json(cls, data, client):
|
|
|
|
|
if not data:
|
|
|
|
|
return None
|
|
|
|
|
|
|
|
|
|
data = super(Artist, cls).de_json(data, client)
|
Добавлен метод получения информации об артисте (Brief Info https://github.com/MarshalX/yandex-music-api/issues/9).
Добавлены следующие классы: BriefInfo, Description, Vinyl, PlaylistId.
Класс Video вынесен из пакета Search в корень.
Добавлен de_list в Cover.
Добавлены следующие поля в класс Artist: likes_count, full_names, description, countries, en_wikipedia_link, db_aliases, aliases, init_date, end_date.
Добавлено поле track_id в класс Chart.
Добавлено поле available_full_without_permission в класс Track.
Класс Video расширен для поддержки второго типа (используется в brief info, спасибо яндух) видео (добавлены необязательные поля cover, embed_url, provider, provider_video_id).
Обновлена документация.
2019-09-13 00:32:43 +09:00
|
|
|
|
from yandex_music import Cover, Ratings, Counts, Link, Track, Description
|
2019-05-11 17:37:47 +09:00
|
|
|
|
data['cover'] = Cover.de_json(data.get('cover'), client)
|
|
|
|
|
data['ratings'] = Ratings.de_json(data.get('ratings'), client)
|
|
|
|
|
data['counts'] = Counts.de_json(data.get('counts'), client)
|
|
|
|
|
data['links'] = Link.de_list(data.get('links'), client)
|
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
|
|
|
|
data['popular_tracks'] = Track.de_list(data.get('popular_tracks'), client)
|
Добавлен метод получения информации об артисте (Brief Info https://github.com/MarshalX/yandex-music-api/issues/9).
Добавлены следующие классы: BriefInfo, Description, Vinyl, PlaylistId.
Класс Video вынесен из пакета Search в корень.
Добавлен de_list в Cover.
Добавлены следующие поля в класс Artist: likes_count, full_names, description, countries, en_wikipedia_link, db_aliases, aliases, init_date, end_date.
Добавлено поле track_id в класс Chart.
Добавлено поле available_full_without_permission в класс Track.
Класс Video расширен для поддержки второго типа (используется в brief info, спасибо яндух) видео (добавлены необязательные поля cover, embed_url, provider, provider_video_id).
Обновлена документация.
2019-09-13 00:32:43 +09:00
|
|
|
|
data['description'] = Description.de_json(data.get('description'), client)
|
2019-07-05 02:21:54 +09:00
|
|
|
|
# TODO add "decomposed" deserialization
|
2019-05-11 17:37:47 +09:00
|
|
|
|
|
|
|
|
|
return cls(client=client, **data)
|
|
|
|
|
|
|
|
|
|
@classmethod
|
|
|
|
|
def de_list(cls, data, client):
|
|
|
|
|
if not data:
|
|
|
|
|
return []
|
|
|
|
|
|
|
|
|
|
artists = list()
|
|
|
|
|
for artist in data:
|
|
|
|
|
artists.append(cls.de_json(artist, client))
|
|
|
|
|
|
|
|
|
|
return artists
|
2019-08-18 23:44:46 +09:00
|
|
|
|
|
|
|
|
|
# camelCase псевдонимы
|
|
|
|
|
|
2019-10-19 17:55:45 +09:00
|
|
|
|
#: Псевдоним для :attr:`download_op_image`
|
2019-08-18 23:44:46 +09:00
|
|
|
|
downloadOpImage = download_op_image
|
2019-10-22 00:29:02 +09:00
|
|
|
|
#: Псевдоним для :attr:`get_tracks`
|
|
|
|
|
getTracks = get_tracks
|
2019-11-20 02:30:07 +09:00
|
|
|
|
#: Псевдоним для :attr:`get_albums`
|
|
|
|
|
getAlbums = get_albums
|