Add support for fetching recently played tracks (#310)

Author: joostlek

src/spotifyaio/models.py

@@ -184,6 +184,22 @@ class SavedTrackResponse(DataClassORJSONMixin):
     items: list[SavedTrack]
 
 
+@dataclass
+class PlayedTrackResponse(DataClassORJSONMixin):
+    """PlayedTrack response model."""
+
+    items: list[PlayedTrack]
+
+
+@dataclass
+class PlayedTrack(DataClassORJSONMixin):
+    """Played track model."""
+
+    played_at: datetime
+    track: Track
+    context: Context
+
+
 @dataclass
 class ArtistResponse(DataClassORJSONMixin):
     """Artist response model."""

src/spotifyaio/spotify.py

@@ -24,6 +24,8 @@
     Episode,
     FeaturedPlaylistResponse,
     PlaybackState,
+    PlayedTrack,
+    PlayedTrackResponse,
     Playlist,
     PlaylistResponse,
     RepeatMode,
@@ -289,6 +291,12 @@ async def get_saved_shows(self) -> list[SavedShow]:
         response = await self._get("v1/me/shows", params=params)
         return SavedShowResponse.from_json(response).items
 
+    async def get_recently_played_tracks(self) -> list[PlayedTrack]:
+        """Get recently played tracks."""
+        params: dict[str, Any] = {"limit": 48}
+        response = await self._get("v1/me/player/recently-played", params=params)
+        return PlayedTrackResponse.from_json(response).items
+
     async def get_category_playlists(self, category_id: str) -> list[BasePlaylist]:
         """Get category playlists."""
         params: dict[str, Any] = {"limit": 48}