Add support for fetching new releases (#313)

Author: joostlek

.pre-commit-config.yaml

@@ -73,7 +73,7 @@ repos:
         exclude: ^poetry\.lock$
         entry: poetry run codespell
         args:
-          - --ignore-words-list=doen,te,ons
+          - --ignore-words-list=doen,te,ons,Racoon
       - id: detect-private-key
         name: 🕵️  Detect Private Keys
         language: system

src/spotifyaio/models.py

@@ -171,6 +171,20 @@ class SavedAlbumResponse(DataClassORJSONMixin):
     items: list[SavedAlbum]
 
 
+@dataclass
+class NewReleasesResponse(DataClassORJSONMixin):
+    """NewReleases response model."""
+
+    albums: NewReleasesResponseInner
+
+
+@dataclass
+class NewReleasesResponseInner(DataClassORJSONMixin):
+    """NewReleases response model."""
+
+    items: list[SimplifiedAlbum]
+
+
 @dataclass
 class SavedShow(DataClassORJSONMixin):
     """Saved Show model."""

src/spotifyaio/spotify.py

@@ -24,6 +24,7 @@
     Devices,
     Episode,
     FeaturedPlaylistResponse,
+    NewReleasesResponse,
     PlaybackState,
     PlayedTrack,
     PlayedTrackResponse,
@@ -44,7 +45,7 @@
 )
 
 if TYPE_CHECKING:
-    from spotifyaio import Artist, Track
+    from spotifyaio import Artist, SimplifiedAlbum, Track
 
 
 @dataclass
@@ -317,6 +318,12 @@ async def get_category_playlists(self, category_id: str) -> list[BasePlaylist]:
         )
         return CategoryPlaylistResponse.from_json(response).playlists.items
 
+    async def get_new_releases(self) -> list[SimplifiedAlbum]:
+        """Get new releases."""
+        params: dict[str, Any] = {"limit": 48}
+        response = await self._get("v1/browse/new-releases", params=params)
+        return NewReleasesResponse.from_json(response).albums.items
+
     async def get_top_artists(self) -> list[Artist]:
         """Get top artists."""
         params: dict[str, Any] = {"limit": 48}