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
|
2021-09-19 22:47:19 +09:00
|
|
|
|
from yandex_music.utils import model
|
2020-01-26 21:19:22 +09:00
|
|
|
|
|
2019-12-27 18:14:51 +09:00
|
|
|
|
if TYPE_CHECKING:
|
|
|
|
|
from yandex_music import Client
|
|
|
|
|
|
2019-05-11 17:37:47 +09:00
|
|
|
|
|
2021-09-19 22:47:19 +09:00
|
|
|
|
@model
|
2019-05-11 17:37:47 +09:00
|
|
|
|
class Link(YandexMusicObject):
|
2020-01-23 02:58:22 +09:00
|
|
|
|
"""Класс, представляющий ссылку на официальную страницу исполнителя.
|
|
|
|
|
|
2020-01-26 21:19:22 +09:00
|
|
|
|
Note:
|
|
|
|
|
Известные типы страниц: `official` - официальный сайт и `social` - социальная сеть.
|
2020-01-23 03:38:02 +09:00
|
|
|
|
|
2020-01-23 02:58:22 +09:00
|
|
|
|
Attributes:
|
|
|
|
|
title (:obj:`str`): Название страницы.
|
|
|
|
|
href (:obj:`str`): URL страницы.
|
2021-09-19 22:47:19 +09:00
|
|
|
|
type (:obj:`str`): Тип страницы.
|
2020-01-23 02:58:22 +09:00
|
|
|
|
social_network (:obj:`str`, 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
|
|
|
|
client (:obj:`yandex_music.Client`, optional): Клиент Yandex Music.
|
2020-01-23 02:58:22 +09:00
|
|
|
|
"""
|
|
|
|
|
|
2021-09-19 22:47:19 +09:00
|
|
|
|
title: str
|
|
|
|
|
href: str
|
|
|
|
|
type: str
|
|
|
|
|
social_network: Optional[str] = None
|
|
|
|
|
client: Optional['Client'] = None
|
2019-05-11 17:37:47 +09:00
|
|
|
|
|
2021-09-19 22:47:19 +09:00
|
|
|
|
def __post_init__(self):
|
|
|
|
|
self._id_attrs = (self.title, self.href, self.type)
|
2020-05-16 04:14:44 +09:00
|
|
|
|
|
2019-05-11 17:37:47 +09:00
|
|
|
|
@classmethod
|
Тайп хинты для Label, TrackPosition, Artist, ArtistAlbums, ArtistTracks, BriefInfo, Counts, Description, Link, Ratings, Vinyl, AlbumEvent, ArtistEvent, Day, Event, GeneratedPlaylist, TrackWithAds, Genre, Images, Title
2019-12-28 20:38:59 +09:00
|
|
|
|
def de_json(cls, data: dict, client: 'Client') -> Optional['Link']:
|
2020-01-23 02:58:22 +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-23 02:58:22 +09:00
|
|
|
|
|
|
|
|
|
Returns:
|
2020-03-22 06:29:34 +09:00
|
|
|
|
:obj:`yandex_music.Link`: Ссылка на официальную страницу исполнителя.
|
2020-01-23 02:58:22 +09:00
|
|
|
|
"""
|
2019-05-11 17:37:47 +09:00
|
|
|
|
if not data:
|
|
|
|
|
return None
|
|
|
|
|
|
|
|
|
|
data = super(Link, cls).de_json(data, client)
|
|
|
|
|
|
|
|
|
|
return cls(client=client, **data)
|
|
|
|
|
|
|
|
|
|
@classmethod
|
Тайп хинты для Label, TrackPosition, Artist, ArtistAlbums, ArtistTracks, BriefInfo, Counts, Description, Link, Ratings, Vinyl, AlbumEvent, ArtistEvent, Day, Event, GeneratedPlaylist, TrackWithAds, Genre, Images, Title
2019-12-28 20:38:59 +09:00
|
|
|
|
def de_list(cls, data: dict, client: 'Client') -> List['Link']:
|
2020-01-23 02:58:22 +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-23 02:58:22 +09:00
|
|
|
|
|
|
|
|
|
Returns:
|
2020-03-22 06:29:34 +09:00
|
|
|
|
:obj:`list` из :obj:`yandex_music.Link`: Ссылки на официальные страницы исполнителя.
|
2020-01-23 02:58:22 +09:00
|
|
|
|
"""
|
2019-05-11 17:37:47 +09:00
|
|
|
|
if not data:
|
|
|
|
|
return []
|
|
|
|
|
|
|
|
|
|
links = list()
|
|
|
|
|
for link in data:
|
|
|
|
|
links.append(cls.de_json(link, client))
|
|
|
|
|
|
|
|
|
|
return links
|