Add method to get saved audiobooks (#477)

Author: joostlek

src/spotifyaio/models.py

@@ -172,6 +172,19 @@ def __pre_deserialize__(cls, d: dict[str, Any]) -> dict[str, Any]:
         return {"items": items}
 
 
+@dataclass
+class SavedAudiobookResponse(DataClassORJSONMixin):
+    """Saved audiobook response model."""
+
+    items: list[SimplifiedAudiobook]
+
+    @classmethod
+    def __pre_deserialize__(cls, d: dict[str, Any]) -> dict[str, Any]:
+        """Pre deserialize hook."""
+        items = [item for item in d["items"] if item is not None]
+        return {"items": items}
+
+
 @dataclass
 class NewReleasesResponse(DataClassORJSONMixin):
     """NewReleases response model."""
@@ -670,25 +683,31 @@ class Narrator(DataClassORJSONMixin):
 
 
 @dataclass
-class Audiobook(DataClassORJSONMixin):
-    """Audiobook model."""
+class SimplifiedAudiobook(DataClassORJSONMixin):
+    """SimplifiedAudiobook model."""
 
     authors: list[Author]
-    chapters: list[Chapter]
     description: str
     edition: str
+    html_description: str
     external_urls: dict[str, str]
     explicit: bool
-    html_description: str
     audiobook_id: str = field(metadata=field_options(alias="id"))
     images: list[Image]
-    languages: list[str]
     name: str
+    uri: str
+    languages: list[str]
     narrators: list[Narrator]
     publisher: str
     total_chapters: int
     type: str
-    uri: str
+
+
+@dataclass
+class Audiobook(SimplifiedAudiobook):
+    """Audiobook model."""
+
+    chapters: list[Chapter]
 
     @classmethod
     def __pre_deserialize__(cls, d: dict[str, Any]) -> dict[str, Any]:

src/spotifyaio/spotify.py

@@ -46,12 +46,14 @@
     RepeatMode,
     SavedAlbum,
     SavedAlbumResponse,
+    SavedAudiobookResponse,
     SavedShow,
     SavedShowResponse,
     SavedTrack,
     SavedTrackResponse,
     Show,
     ShowEpisodesResponse,
+    SimplifiedAudiobook,
     SimplifiedEpisode,
     TopArtistsResponse,
     TopTracksResponse,
@@ -298,7 +300,11 @@ async def get_audiobook_chapters(self, audiobook_id: str) -> list[Chapter]:
         )
         return AudiobookChapterResponse.from_json(response).items
 
-    # Get saved audiobooks
+    async def get_saved_audiobooks(self) -> list[SimplifiedAudiobook]:
+        """Get saved audiobooks."""
+        params: dict[str, Any] = {"limit": 48}
+        response = await self._get("v1/me/audiobooks", params=params)
+        return SavedAudiobookResponse.from_json(response).items
 
     # Save an audiobook
 

tests/__snapshots__/test_spotify.ambr

@@ -19622,6 +19622,68 @@
     }),
   ])
 # ---
+# name: test_get_saved_audiobooks
+  list([
+    dict({
+      'audiobook_id': '58cFIY8IT7yGqR3kHnKqzV',
+      'authors': list([
+        dict({
+          'name': 'Anya Niewierra',
+        }),
+      ]),
+      'description': '''
+        Author(s): Anya Niewierra
+        Narrator(s): Nienke Brinkhuis, Cees van Ede, Mattijn Hartemink<p>Na het succes van de bestsellers <i>Het bloemenmeisje</i> en <i>De Camino</i> komt Anya Niewierra met <i>De nomade</i>. Een aangrijpende thriller over vaderliefde en een verborgen verleden.</p><p>De 37-jarige documentairemaker Olga Liebke woont met haar zonderlinge vader in het Harz-gebergte. Olga heeft een innige band met de inmiddels dementerende man. Haar moeder stierf in het kraambed en ze heeft verder geen familie. Tenminste, zo is het verhaal.</p><p>Maar dan vertelt haar vader herinneringen die niet rijmen met de geschiedenis zoals zij die kent. Ze gaat twijfelen over haar achtergrond en ontdekt documenten uit de voormalige Sovjet-Unie.</p><p>Olga reist naar de driehoek Polen, Litouwen en Belarus en stuit op een huiveringwekkend geheim.</p>
+        <br>
+        <p>‘Anya Niewierra heeft met <i>De nomade</i> weer een magnifiek boek afgeleverd, dat mogelijk nog indrukwekkender is dan <i>De Camino</i>.’<br>
+        Heleen Spanjaard, <i>Margriet</i></p><p>‘Verrassend, meeslepend en bloedstollend. <i>De nomade</i> is een waardige opvolger van <i>De Camino</i>.’<br>
+        Rob Cobben, cultuurverslaggever <i>Dagblad De Limburger</i></p>
+      ''',
+      'edition': 'Unabridged',
+      'explicit': False,
+      'external_urls': dict({
+        'spotify': 'https://open.spotify.com/show/58cFIY8IT7yGqR3kHnKqzV',
+      }),
+      'html_description': 'Author(s): Anya Niewierra<br/>Narrator(s): Nienke Brinkhuis, Cees van Ede, Mattijn Hartemink<br/>&lt;p&gt;Na het succes van de bestsellers &lt;i&gt;Het bloemenmeisje&lt;/i&gt; en &lt;i&gt;De Camino&lt;/i&gt; komt Anya Niewierra met &lt;i&gt;De nomade&lt;/i&gt;. Een aangrijpende thriller over vaderliefde en een verborgen verleden.&lt;/p&gt;<br/>&lt;p&gt;De 37-jarige documentairemaker Olga Liebke woont met haar zonderlinge vader in het Harz-gebergte. Olga heeft een innige band met de inmiddels dementerende man. Haar moeder stierf in het kraambed en ze heeft verder geen familie. Tenminste, zo is het verhaal.&lt;/p&gt;<br/>&lt;p&gt;Maar dan vertelt haar vader herinneringen die niet rijmen met de geschiedenis zoals zij die kent. Ze gaat twijfelen over haar achtergrond en ontdekt documenten uit de voormalige Sovjet-Unie.&lt;/p&gt;<br/>&lt;p&gt;Olga reist naar de driehoek Polen, Litouwen en Belarus en stuit op een huiveringwekkend geheim.&lt;/p&gt;<br/>&lt;br&gt;<br/>&lt;p&gt;‘Anya Niewierra heeft met &lt;i&gt;De nomade&lt;/i&gt; weer een magnifiek boek afgeleverd, dat mogelijk nog indrukwekkender is dan &lt;i&gt;De Camino&lt;/i&gt;.’&lt;br&gt;<br/>Heleen Spanjaard, &lt;i&gt;Margriet&lt;/i&gt;&lt;/p&gt;<br/>&lt;p&gt;‘Verrassend, meeslepend en bloedstollend. &lt;i&gt;De nomade&lt;/i&gt; is een waardige opvolger van &lt;i&gt;De Camino&lt;/i&gt;.’&lt;br&gt;<br/>Rob Cobben, cultuurverslaggever &lt;i&gt;Dagblad De Limburger&lt;/i&gt;&lt;/p&gt;',
+      'images': list([
+        dict({
+          'height': 640,
+          'url': 'https://i.scdn.co/image/ab676663000022a8ecf13d909d494c02ba057feb',
+          'width': 640,
+        }),
+        dict({
+          'height': 300,
+          'url': 'https://i.scdn.co/image/ab6766630000db5becf13d909d494c02ba057feb',
+          'width': 300,
+        }),
+        dict({
+          'height': 64,
+          'url': 'https://i.scdn.co/image/ab6766630000703becf13d909d494c02ba057feb',
+          'width': 64,
+        }),
+      ]),
+      'languages': list([
+        'nl',
+      ]),
+      'name': 'De nomade',
+      'narrators': list([
+        dict({
+          'name': 'Nienke Brinkhuis',
+        }),
+        dict({
+          'name': 'Cees van Ede',
+        }),
+        dict({
+          'name': 'Mattijn Hartemink',
+        }),
+      ]),
+      'publisher': 'Anya Niewierra',
+      'total_chapters': 49,
+      'type': 'audiobook',
+      'uri': 'spotify:show:58cFIY8IT7yGqR3kHnKqzV',
+    }),
+  ])
+# ---
 # name: test_get_saved_shows
   list([
     dict({