diff --git a/yandex_music/playlist/user.py b/yandex_music/playlist/user.py index 0604936..f6b06df 100644 --- a/yandex_music/playlist/user.py +++ b/yandex_music/playlist/user.py @@ -2,6 +2,25 @@ from yandex_music import YandexMusicObject class User(YandexMusicObject): + """Класс представляющий пользователя. + + Attributes: + uid (:obj:'int'): Идентификатор пользователя. + login (:obj:'str'): Логин пользователя. + name (:obj:'str'): Имя пользователя. + sex (:obj:'str'): Пол пользователя. + verified (:obj:'bool'): Является ли пользователь подтвержденным. + client (:obj:'yandex_music.Client'): Объект класса :class:`yandex_music.Client` представляющий клиент Yandex Music. + + Args: + uid (:obj:'int'): Идентификатор пользователя. + login (:obj:'str'): Логин пользователя. + name (:obj:'str'): Имя пользователя. + sex (:obj:'str'): Пол пользователя. + verified (:obj:'bool'): Является ли пользователь подтвержденным. + client (:obj:'yandex_music.Client', optional): Объект класса :class:`yandex_music.Client` представляющий клиент Yandex Music. + **kwargs: Произвольные ключевые аргументы полученные от API. + """ def __init__(self, uid, login, @@ -24,13 +43,23 @@ class User(YandexMusicObject): Args: filename (:obj:`str`): Путь для сохранения файла с названием и расширением. - format (:obj:`str`): Формат желаемого изображения (normal, orig, small, big). + format (:obj:`str`, optional): Формат желаемого изображения (normal, orig, small, big). """ self.client.request.download(f'https://upics.yandex.net/{self.uid}/{format}', filename) @classmethod def de_json(cls, data, client): + """Десериализация объекта. + + Args: + data (:obj:`dict`): Поля и значения десериализуемого объекта. + client (:obj:`yandex_music.Client`): Объект класса :class:`yandex_music.Client` представляющий клиент Yandex + Music. + + Returns: + :obj:`yandex_music.User`: Объект класса :class:`yandex_music.User`. + """ if not data: return None