yandex-music-api/yandex_music/track/tracks_similar.py

from typing import TYPE_CHECKING, Optional, List

if TYPE_CHECKING:
    from yandex_music import Client, Track

from yandex_music import YandexMusicObject


class TracksSimilar(YandexMusicObject):
    """Класс, представляющий список похожих треков на другой трек.

    Attributes:
        track (:obj:`yandex_music.Track`): Объект класса :class:`yandex_music.Track` представляющий трек.
        similar_tracks (:obj:`list` из :obj:`yandex_music.Track`): Список объектов класса
            :class:`yandex_music.Track` представляющие похожие треки на `track`.
        client (:obj:`yandex_music.Client`): Объект класса :class:`yandex_music.Client` представляющий клиент Yandex
            Music.

    Args:
        track (:obj:`yandex_music.Track`): Объект класса :class:`yandex_music.Track` представляющий трек.
        similar_tracks (:obj:`list` из :obj:`yandex_music.Track`): Список объектов класса
            :class:`yandex_music.Track` представляющие похожие треки на `track`.
        client (:obj:`yandex_music.Client`, optional): Объект класса :class:`yandex_music.Client` представляющий клиент
            Yandex Music.
        **kwargs: Произвольные ключевые аргументы полученные от API.
    """

    def __init__(self,
                 track: Optional['Track'],
                 similar_tracks: List['Track'],
                 client: Optional['Client'] = None,
                 **kwargs) -> None:
        self.track = track
        self.similar_tracks = similar_tracks

        self.client = client
        self._id_attrs = (self.track, self.similar_tracks)

    @classmethod
    def de_json(cls, data: dict, client: 'Client') -> Optional['TracksSimilar']:
        if not data:
            return None

        data = super(TracksSimilar, cls).de_json(data, client)
        from yandex_music import Track
        data['track'] = Track.de_json(data.get('track'), client)
        data['similar_tracks'] = Track.de_list(data.get('similar_tracks'), client)

        return cls(client=client, **data)