diff --git a/yandex_music/artist/link.py b/yandex_music/artist/link.py index 8aaed24..585ca22 100644 --- a/yandex_music/artist/link.py +++ b/yandex_music/artist/link.py @@ -7,6 +7,27 @@ from yandex_music import YandexMusicObject class Link(YandexMusicObject): + """Класс, представляющий ссылку на официальную страницу исполнителя. + + Известные типы страниц: `official` - официальный сайт и `social` - социальная сеть. + + Attributes: + title (:obj:`str`): Название страницы. + href (:obj:`str`): URL страницы. + type_ (:obj:`str`): Тип страницы. + social_network (:obj:`str`): Название социальной сети. + client (:obj:`yandex_music.Client`): Объект класса :class:`yandex_music.Client` представляющий клиент Yandex + Music. + + Args: + title (:obj:`str`): Название страницы. + href (:obj:`str`): URL страницы. + type_ (:obj:`str`): Тип страницы. + social_network (:obj:`str`, optional): Название социальной сети. + client (:obj:`yandex_music.Client`, optional): Объект класса :class:`yandex_music.Client` представляющий клиент + Yandex Music. + """ + def __init__(self, title: str, href: str, @@ -25,6 +46,16 @@ class Link(YandexMusicObject): @classmethod def de_json(cls, data: dict, client: 'Client') -> Optional['Link']: + """Десериализация объекта. + + Args: + data (:obj:`dict`): Поля и значения десериализуемого объекта. + client (:obj:`yandex_music.Client`): Объект класса :class:`yandex_music.Client` представляющий клиент Yandex + Music. + + Returns: + :obj:`yandex_music.Link`: Объект класса :class:`yandex_music.Link`. + """ if not data: return None @@ -34,6 +65,16 @@ class Link(YandexMusicObject): @classmethod def de_list(cls, data: dict, client: 'Client') -> List['Link']: + """Десериализация списка объектов. + + Args: + data (:obj:`list`): Список словарей с полями и значениями десериализуемого объекта. + client (:obj:`yandex_music.Client`): Объект класса :class:`yandex_music.Client` представляющий клиент Yandex + Music. + + Returns: + :obj:`list` из :obj:`yandex_music.Link`: Список объектов класса :class:`yandex_music.Link`. + """ if not data: return []