Skip to content

Первый стабильный релиз библиотеки
Compare
Choose a tag to compare
@MarshalX MarshalX released this 06 Feb 12:54
· 147 commits to main since this release
v1.0.0
dcb012f

Переломные изменения

  • Поле error класса Artist теперь называется reason.
  • Метод users_playlists класса Client теперь возвращает один объект плейлиста, когда был передан один kind. При
    передаче списка в kind вернётся список плейлистов (#318).
  • Поле labels класса Album теперь может содержать список из строк, а не только список объектов класса Label.

Крупные изменения

  • Добавлены примеры в папку examples.
  • Добавлена поддержка рекомендаций для плейлистов (#324):
    • Добавлен класс PlaylistRecommendations.
    • Добавлен метод клиента для получения рекомендаций
      (users_playlists_recommendations).
    • Добавлен метод get_recommendations классу Playlist для получения рекомендаций.
  • Добавлено получение чартов (#294):
    • Добавлены новые классы: ChartInfo, ChartInfoMenu,
      ChartInfoMenuItem.
    • Добавлен метод клиента для получения чарта (chart).
  • Добавлена поддержка тегов/подборок (#192):
    • Добавлены новые классы: TagResult, Tag.
    • Добавлен новый метод клиента для получения тегов (tags).
  • Добавлено присоединение к коллективному плейлисту (#317):
    • Добавлен новый метод клиента для присоединения
      (playlists_collective_join).
  • Добавлена поддержка очередей прослушивания (#246):
    • Добавлены новые классы: Context, Queue, QueueItem.
    • Добавлены новые методы в Client: queues_list, queue,
      queue_update_position, queue_create.
    • Добавлены поля track_id и from_ в класс TrackId.
    • Добавлена возможность смены языка у клиента для ответов от API.
    • Добавлена десериализация любого объекта в JSON пригодного для отправки в запросе на Яндекс API.
  • Добавлены следующие методы для Client:
    • new_releases – получение полного списка всех новых релизов.
    • new_playlists – получение полного списка всех новый плейлистов.
    • podcasts – получение подкаста с лендинга.
  • Добавлены новые сокращения в модели:
    • download_cover_white, download_cover_uri в MixLink.
    • download_image в Promotion.
    • artists_name в Album и Track.
    • fetch_track, track_full_id в TrackId.
    • fetch_tracks в TracksList.
    • insert_track, delete_tracks, delete в Playlist.
    • playlist_id, fetch_playlist в PlaylistId.
    • get_current_track в Queue.
    • fetch_queue в QueueItem.
    • next_page, get_page, prev_page в Search.
    • и другие...
  • Добавлена поддержка новых типов поиска: подкасты, выпуски, пользователи.
  • Добавлен коллбек для обработки новых полей.
  • Добавлена информацию по поводу запуска потока по треку, плейлисту и др.
  • Добавлена десериализация decomposed у Artist (#10).
  • Добавлен __len__ для TracksList (#380).
  • Добавлены __iter__, __len__ и __getitem__ для классов представляющих список каких-либо объектов.
  • Добавлено сокращение fetch_tracks классу Playlist для получения треков плейлиста.
  • Добавлен метод get_url классу Icon для получения прямой ссылки на изображение.
  • Класс User расширен для поддержки поля user_info из Track
    (поля full_name, display_name).
  • Добавлены новые классы по отчётам с Telegram бота (#306, #398):
    • LandingList.
    • RenewableRemainder.
    • Alert.
    • AlertButton.
    • StationData.
    • Brand.
    • Contest.
      • OpenGraphData.
      • NonAutoRenewable.
      • Operator.
      • Deactivation.
      • PoetryLoverMatch.
      • Deprecation.
  • Добавлены новые поля классам по отчётам с Telegram бота (#306, #398):
    • plus в Product.
    • non_auto_renewable_remainder в Subscription.
    • og_image в Artist.
    • meta_type в Album.
    • advertisement в Status.
    • best в Track.
    • offer_id и artist_ids в Vinyl.
    • playlists в BriefInfo.
    • is_custom в Cover.
    • play_count, recent, chart, track в TrackShort.
    • url_part, og_title, image, cover_without_text,
      background_color, text_color, id_for_from,
      similar_playlists, last_owner_playlists в Playlist.
    • bg_color в Chart.
    • error в Artist.
    • substituted, matched_track, can_publish, state,
      desired_visibility, filename, user_info, meta_data в
      Track.
    • copyright_name, copyright_cline в Cover.
    • direct в DownloadInfo.
    • cheapest, title, family_sub, fb_image, fb_name,
      family, intro_period_duration, intro_price,
      start_period_duration, start_price, licence_text_parts в
      Product.
    • storage_dir, duplicates в Album.
    • subscribed в ArtistEvent.
    • description в GeneratedPlaylist.
    • genre в Event.
    • show_in_regions в Genre.
    • cover_uri в MixLink.
    • og_description, top_artist в Playlist.
    • full_image_url, mts_full_image_url в Station.
    • coauthors и recent_tracks в Playlist.
    • regions в User.
    • users, podcasts, podcast_episodes, type_, page,
      per_page в Search.
    • short_description, description, is_premiere, is_banner в
      Like.
    • master_info в AutoRenewable.
    • station_data и bar_below в Status.
    • family_auto_renewable в Subscription.
    • misspell_result и misspell_original в Search.
    • experiment в класс Status.
    • operator и non_auto_renewable в Subscription.
    • text_color, short_description, description, is_premiere
      и is_banner в Album.
    • hand_made_description в Artist.
    • metrika_id в Playlist.
    • og_image в Tag.
    • url в Lyrics.
    • number, genre в MetaData.
    • poetry_lover_matches в Track.
    • contest, dummy_description, dummy_page_description,
      dummy_cover, dummy_rollover_cover, og_data, branding в
      Playlist.
    • available_as_rbt, lyrics_available, remember_position,
      albums, duration_ms, explicit, start_date,
      likes_count, deprecation в Album.
    • lyricist, version, composer в MetaData.
    • last_releases в BriefInfo.
    • ya_money_id в Artist (#351, #370).
    • playlist_uuid в Playlist.
    • sync_queue_enabled в UserSettings.
    • background_video_uri, short_description,
      is_suitable_for_children в Track (#376).
    • meta_type, likes_count в Album (#386).
    • deprecation в Album.
    • available_regions в Album.
    • type, ready в Playlist.
    • description в Supplement.

Незначительные изменения и/или исправления

  • Добавлена опциональность следующим полям:
    • все поля в MetaData.
    • advertisement в Status.
    • text_language в Lyrics.
    • provider_video_id в VideoSupplement.
    • title в VideoSupplement (#403).
    • instructions в Deactivation (#402).
    • id в Album (#401).
  • Исправлена десериализация подкастов, эпизодов подкастов и пользователей в лучшем результате поиска.
  • Исправлена десериализация альбомов. В зависимости от запроса содержимое лейблов может быть списком объектом или
    списком строк (в поиске).
  • Исправлен выбор настроек радио.
  • Исправлены ошибки в документации.
  • Протестирована работа на Python 3.9.
Assets 2
Loading