feat: add music playlist

src/client/response/music_playlist.rs

@@ -0,0 +1,107 @@
+use serde::Deserialize;
+use serde_with::serde_as;
+use serde_with::VecSkipError;
+
+use crate::serializer::{
+    text::{Text, TextComponents},
+    MapResult, VecLogError,
+};
+
+use super::music_item::{MusicContentsRenderer, MusicItem, MusicThumbnailRenderer};
+use super::{ContentRenderer, ContentsRenderer, MusicContinuation};
+
+#[derive(Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct MusicPlaylist {
+    pub contents: Contents,
+    pub header: Header,
+}
+
+#[derive(Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct MusicPlaylistCont {
+    pub continuation_contents: ContinuationContents,
+}
+
+#[derive(Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct Contents {
+    pub single_column_browse_results_renderer: ContentsRenderer<Tab>,
+}
+
+#[derive(Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct Tab {
+    pub tab_renderer: ContentRenderer<SectionList>,
+}
+
+#[derive(Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct SectionList {
+    /// Includes a continuation token for fetching recommendations
+    pub section_list_renderer: MusicContentsRenderer<ItemSection>,
+}
+
+#[derive(Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct ItemSection {
+    #[serde(alias = "musicPlaylistShelfRenderer")]
+    pub music_shelf_renderer: MusicShelf,
+}
+
+#[serde_as]
+#[derive(Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct MusicShelf {
+    /// Playlist ID (only for playlists)
+    pub playlist_id: Option<String>,
+    #[serde_as(as = "VecLogError<_>")]
+    pub contents: MapResult<Vec<MusicItem>>,
+    /// Continuation token for fetching more (>100) playlist items
+    #[serde(default)]
+    #[serde_as(as = "VecSkipError<_>")]
+    pub continuations: Vec<MusicContinuation>,
+}
+
+#[derive(Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct Header {
+    pub music_detail_header_renderer: HeaderRenderer,
+}
+
+#[serde_as]
+#[derive(Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct HeaderRenderer {
+    #[serde_as(as = "Text")]
+    pub title: String,
+    /// Content type + Channel/Artist + Year.
+    /// Missing on artist_tracks view.
+    ///
+    /// `"Playlist", " • ", <"Best Music">, " • ", "2022"`
+    ///
+    /// `"Album", " • ", <"Helene Fischer">, " • ", "2021"`
+    #[serde(default)]
+    pub subtitle: TextComponents,
+    /// Playlist description. May contain hashtags which are
+    /// displayed as search links on the YouTube website.
+    #[serde_as(as = "Option<Text>")]
+    pub description: Option<String>,
+    /// Playlist thumbnail / album cover.
+    /// Missing on artist_tracks view.
+    #[serde(default)]
+    pub thumbnail: MusicThumbnailRenderer,
+    /// Number of tracks + playtime.
+    /// Missing on artist_tracks view.
+    ///
+    /// `"64 songs", " • ", "3 hours, 40 minutes"`
+    #[serde(default)]
+    #[serde_as(as = "Text")]
+    pub second_subtitle: Vec<String>,
+}
+
+#[derive(Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct ContinuationContents {
+    pub music_playlist_shelf_continuation: MusicShelf,
+}