Add support for fetching an artist (#314)

Author: joostlek

src/spotifyaio/spotify.py

@@ -14,6 +14,7 @@
 from spotifyaio.exceptions import SpotifyConnectionError, SpotifyError
 from spotifyaio.models import (
     Album,
+    Artist,
     ArtistResponse,
     BasePlaylist,
     BaseUserProfile,
@@ -45,7 +46,7 @@
 )
 
 if TYPE_CHECKING:
-    from spotifyaio import Artist, SimplifiedAlbum, Track
+    from spotifyaio import SimplifiedAlbum, Track
 
 
 @dataclass
@@ -148,6 +149,12 @@ async def get_album(self, album_id: str) -> Album:
         response = await self._get(f"v1/albums/{album_id}")
         return Album.from_json(response)
 
+    async def get_artist(self, artist_id: str) -> Artist:
+        """Get artist."""
+        identifier = artist_id.split(":")[-1]
+        response = await self._get(f"v1/artists/{identifier}")
+        return Artist.from_json(response)
+
     async def get_playback(self) -> PlaybackState | None:
         """Get playback state."""
         response = await self._get(

tests/__snapshots__/test_spotify.ambr

@@ -366,6 +366,13 @@
     'uri': 'spotify:album:3IqzqH6ShrRtie9Yd2ODyG',
   })
 # ---
+# name: test_get_artist
+  dict({
+    'artist_id': '0TnOYISbd1XYRBk9myaseg',
+    'name': 'Pitbull',
+    'uri': 'spotify:artist:0TnOYISbd1XYRBk9myaseg',
+  })
+# ---
 # name: test_get_category
   dict({
     'category_id': '0JQ5DAqbMKFRY5ok2pxXJ0',

tests/fixtures/artist.json

@@ -0,0 +1,37 @@
+{
+  "external_urls": {
+    "spotify": "https://open.spotify.com/artist/0TnOYISbd1XYRBk9myaseg"
+  },
+  "followers": {
+    "href": null,
+    "total": 10817055
+  },
+  "genres": [
+    "dance pop",
+    "miami hip hop",
+    "pop"
+  ],
+  "href": "https://api.spotify.com/v1/artists/0TnOYISbd1XYRBk9myaseg?locale=en-US%2Cen%3Bq%3D0.5",
+  "id": "0TnOYISbd1XYRBk9myaseg",
+  "images": [
+    {
+      "url": "https://i.scdn.co/image/ab6761610000e5ebee07b5820dd91d15d397e29c",
+      "height": 640,
+      "width": 640
+    },
+    {
+      "url": "https://i.scdn.co/image/ab67616100005174ee07b5820dd91d15d397e29c",
+      "height": 320,
+      "width": 320
+    },
+    {
+      "url": "https://i.scdn.co/image/ab6761610000f178ee07b5820dd91d15d397e29c",
+      "height": 160,
+      "width": 160
+    }
+  ],
+  "name": "Pitbull",
+  "popularity": 85,
+  "type": "artist",
+  "uri": "spotify:artist:0TnOYISbd1XYRBk9myaseg"
+}

tests/test_spotify.py

@@ -1026,3 +1026,25 @@ async def test_get_category(
         params=None,
         data=None,
     )
+
+
+async def test_get_artist(
+    responses: aioresponses,
+    snapshot: SnapshotAssertion,
+    authenticated_client: SpotifyClient,
+) -> None:
+    """Test retrieving an artist."""
+    responses.get(
+        f"{SPOTIFY_URL}/v1/artists/0TnOYISbd1XYRBk9myaseg",
+        status=200,
+        body=load_fixture("artist.json"),
+    )
+    response = await authenticated_client.get_artist("0TnOYISbd1XYRBk9myaseg")
+    assert response == snapshot
+    responses.assert_called_once_with(
+        f"{SPOTIFY_URL}/v1/artists/0TnOYISbd1XYRBk9myaseg",
+        METH_GET,
+        headers=HEADERS,
+        params=None,
+        data=None,
+    )