feat: add get_similar_artists query and remove deprecated bio.summary

- Add GetSimilarArtists query using Artist.relatedArtist with ArtistFields fragment
- Remove deprecated 'summary' field from ArtistBiography (use 'full' instead)
- Add smoke test and fixture for similar artists
- Update existing fixtures to remove summary field

Author: jdaberkow

deezer_python_gql/generated/__init__.py

@@ -423,6 +423,14 @@
     GetRecommendationsMeRecommendationsPlaylistsEdgesNode,
     GetRecommendationsMeRecommendationsPlaylistsPageInfo,
 )
+from .get_similar_artists import (
+    GetSimilarArtists,
+    GetSimilarArtistsArtist,
+    GetSimilarArtistsArtistRelatedArtist,
+    GetSimilarArtistsArtistRelatedArtistEdges,
+    GetSimilarArtistsArtistRelatedArtistEdgesNode,
+    GetSimilarArtistsArtistRelatedArtistPageInfo,
+)
 from .get_similar_tracks import (
     GetSimilarTracks,
     GetSimilarTracksTrack,
@@ -945,6 +953,12 @@
     "GetRecommendationsMeRecommendationsPlaylistsEdges",
     "GetRecommendationsMeRecommendationsPlaylistsEdgesNode",
     "GetRecommendationsMeRecommendationsPlaylistsPageInfo",
+    "GetSimilarArtists",
+    "GetSimilarArtistsArtist",
+    "GetSimilarArtistsArtistRelatedArtist",
+    "GetSimilarArtistsArtistRelatedArtistEdges",
+    "GetSimilarArtistsArtistRelatedArtistEdgesNode",
+    "GetSimilarArtistsArtistRelatedArtistPageInfo",
     "GetSimilarTracks",
     "GetSimilarTracksTrack",
     "GetSimilarTracksTrackRecommendedTracks",

deezer_python_gql/generated/client.py

@@ -90,6 +90,7 @@
 )
 from .get_recently_played import GetRecentlyPlayed, GetRecentlyPlayedMe
 from .get_recommendations import GetRecommendations, GetRecommendationsMe
+from .get_similar_artists import GetSimilarArtists, GetSimilarArtistsArtist
 from .get_similar_tracks import GetSimilarTracks, GetSimilarTracksTrack
 from .get_smart_tracklist import GetSmartTracklist, GetSmartTracklistSmartTracklist
 from .get_track import GetTrack, GetTrackTrack
@@ -755,7 +756,6 @@ async def get_artist(
               fansCount
               isFavorite
               bio {
-                summary
                 full
               }
             }
@@ -1146,7 +1146,6 @@ async def get_charts(
               fansCount
               isFavorite
               bio {
-                summary
                 full
               }
             }
@@ -1322,7 +1321,6 @@ async def get_favorite_artists(
               fansCount
               isFavorite
               bio {
-                summary
                 full
               }
             }
@@ -1978,7 +1976,6 @@ async def get_music_together_affinity(
               fansCount
               isFavorite
               bio {
-                summary
                 full
               }
             }
@@ -2773,7 +2770,6 @@ async def get_recently_played(
               fansCount
               isFavorite
               bio {
-                summary
                 full
               }
             }
@@ -2910,7 +2906,6 @@ async def get_recommendations(
               fansCount
               isFavorite
               bio {
-                summary
                 full
               }
             }
@@ -2986,6 +2981,57 @@ async def get_recommendations(
         data = self.get_data(response)
         return GetRecommendations.model_validate(data).me
 
+    async def get_similar_artists(
+        self,
+        artist_id: str,
+        first: Union[Optional[int], UnsetType] = UNSET,
+        **kwargs: Any,
+    ) -> Optional[GetSimilarArtistsArtist]:
+        query = gql("""
+            query GetSimilarArtists($artistId: String!, $first: Int = 25) {
+              artist(artistId: $artistId) {
+                relatedArtist(first: $first) {
+                  edges {
+                    node {
+                      ...ArtistFields
+                    }
+                  }
+                  pageInfo {
+                    ...PageInfoFields
+                  }
+                }
+              }
+            }
+
+            fragment ArtistFields on Artist {
+              id
+              name
+              picture {
+                id
+                urls(pictureRequest: {width: 264, height: 264})
+              }
+              fansCount
+              isFavorite
+              bio {
+                full
+              }
+            }
+
+            fragment PageInfoFields on PageInfo {
+              hasNextPage
+              endCursor
+            }
+            """)
+        variables: dict[str, object] = {"artistId": artist_id, "first": first}
+        response = await self.execute(
+            query=query,
+            operation_name="GetSimilarArtists",
+            variables=variables,
+            **kwargs,
+        )
+        data = self.get_data(response)
+        return GetSimilarArtists.model_validate(data).artist
+
     async def get_similar_tracks(
         self, track_id: str, nb: Union[Optional[int], UnsetType] = UNSET, **kwargs: Any
     ) -> Optional[GetSimilarTracksTrack]:
@@ -3357,7 +3403,6 @@ async def get_user_charts(
               fansCount
               isFavorite
               bio {
-                summary
                 full
               }
             }

deezer_python_gql/generated/fragments.py

@@ -64,7 +64,6 @@ class ArtistFieldsPicture(BaseModel):
 
 
 class ArtistFieldsBio(BaseModel):
-    summary: Optional[str]
     full: str
 
 

deezer_python_gql/generated/get_similar_artists.py

@@ -0,0 +1,42 @@
+# Generated by ariadne-codegen
+# Source: queries
+
+from typing import Optional
+
+from pydantic import Field
+
+from .base_model import BaseModel
+from .fragments import ArtistFields, PageInfoFields
+
+
+class GetSimilarArtists(BaseModel):
+    artist: Optional["GetSimilarArtistsArtist"]
+
+
+class GetSimilarArtistsArtist(BaseModel):
+    related_artist: Optional["GetSimilarArtistsArtistRelatedArtist"] = Field(
+        alias="relatedArtist"
+    )
+
+
+class GetSimilarArtistsArtistRelatedArtist(BaseModel):
+    edges: list["GetSimilarArtistsArtistRelatedArtistEdges"]
+    page_info: "GetSimilarArtistsArtistRelatedArtistPageInfo" = Field(alias="pageInfo")
+
+
+class GetSimilarArtistsArtistRelatedArtistEdges(BaseModel):
+    node: Optional["GetSimilarArtistsArtistRelatedArtistEdgesNode"]
+
+
+class GetSimilarArtistsArtistRelatedArtistEdgesNode(ArtistFields):
+    pass
+
+
+class GetSimilarArtistsArtistRelatedArtistPageInfo(PageInfoFields):
+    pass
+
+
+GetSimilarArtists.model_rebuild()
+GetSimilarArtistsArtist.model_rebuild()
+GetSimilarArtistsArtistRelatedArtist.model_rebuild()
+GetSimilarArtistsArtistRelatedArtistEdges.model_rebuild()

queries/fragments.graphql

@@ -51,7 +51,6 @@ fragment ArtistFields on Artist {
   fansCount
   isFavorite
   bio {
-    summary
     full
   }
 }

queries/get_similar_artists.graphql

@@ -0,0 +1,16 @@
+# Get artists related/similar to a given artist.
+
+query GetSimilarArtists($artistId: String!, $first: Int = 25) {
+  artist(artistId: $artistId) {
+    relatedArtist(first: $first) {
+      edges {
+        node {
+          ...ArtistFields
+        }
+      }
+      pageInfo {
+        ...PageInfoFields
+      }
+    }
+  }
+}

tests/fixtures/get_artist.json

@@ -10,7 +10,6 @@
         ]
       },
       "bio": {
-        "summary": "Schoolmates Thomas and Guy-Manuel began their career in 1992 with the indie rock trio Darlin' (named after The Beach Boys song) but were scathingly dismissed by Melody Maker magazine as \"daft punk.\" Turning to house-inspired electronica, they used the put down as a name for their DJ-ing partnership and became a hugely successful and influential dance act. First major single “Da Funk” was accompanied by a Spike Jonze-directed video and more success followed with global dance floor anthem “Around the World,” “One More Time,” and “Harder, Faster, Better, Stronger” - which was sampled by Kanye West for his hit “Stronger.” Albums Homework (1997), Discovery (2001) and Human After All (2005) all made the UK Top 10 establishing a style of simple, Chicago house-inspired grooves exploding into a robotic, rave sound. Disguising their faces with masks, crash helmets and robot heads, the duo cultivated an air of mystique, but they've been sampled by Janet Jackson, appeared in TV commercials, and performed at the 2008 Grammy Awards. In the following years, they appeared alongside Kanye West at the 50th Grammy Awards and then pivoted to film music, composing the entire soundtrack of the sci-fi movie Tron: Legacy (2010), which spawned a collection of remixes under the name Tron: Legacy Reconfigured in 2011. The disco and funk-oriented Random Access Memories, their fourth full-length, arrived in 2013 and soon Daft Punk found themselves reaping the fruits of their labor, winning a Grammy for Best Dance/Electronica Album and Best Pop Duo/Group Performance for the Number 1 hit single “Get Lucky,” featuring Pharrell Williams and Chic’s Nile Rodgers. Despite not releasing any new material of their own, Daft Punk continued to collaborate with some of the biggest stars in pop music, scoring production credits on Kanye West’s Yeezus (2013) and an appearance on The Weeknd’s Starboy (2016). After years of radio silence, the duo announced their breakup in 2021 through their video streaming channel.",
         "full": "<p>Schoolmates Thomas and Guy-Manuel began their career in 1992 with the indie rock trio Darlin' (named after The Beach Boys song) but were scathingly dismissed by Melody Maker magazine as \"daft punk.\" Turning to house-inspired electronica, they used the put down as a name for their DJ-ing partnership and became a hugely successful and influential dance act. First major single <em>“Da Funk”</em> was accompanied by a Spike Jonze-directed video and more success followed with global dance floor anthem <em>“Around the World,” “One More Time,”</em> and <em>“Harder, Faster, Better, Stronger”</em> - which was sampled by Kanye West for his hit <em>“Stronger.”</em> Albums <em>Homework</em> (1997), <em>Discovery</em> (2001) and <em>Human After All</em> (2005) all made the UK Top 10 establishing a style of simple, Chicago house-inspired grooves exploding into a robotic, rave sound. Disguising their faces with masks, crash helmets and robot heads, the duo cultivated an air of mystique, but they've been sampled by Janet Jackson, appeared in TV commercials, and performed at the 2008 Grammy Awards. In the following years, they appeared alongside Kanye West at the 50th Grammy Awards and then pivoted to film music, composing the entire soundtrack of the sci-fi movie <em>Tron: Legacy</em> (2010), which spawned a collection of remixes under the name <em>Tron: Legacy Reconfigured</em> in 2011. The disco and funk-oriented <em>Random Access Memories</em>, their fourth full-length, arrived in 2013 and soon Daft Punk found themselves reaping the fruits of their labor, winning a Grammy for Best Dance/Electronica Album and Best Pop Duo/Group Performance for the Number 1 hit single <em>“Get Lucky,”</em> featuring Pharrell Williams and Chic’s Nile Rodgers. Despite not releasing any new material of their own, Daft Punk continued to collaborate with some of the biggest stars in pop music, scoring production credits on Kanye West’s <em>Yeezus</em> (2013) and an appearance on The Weeknd’s <em>Starboy</em> (2016). After years of radio silence, the duo announced their breakup in 2021 through their video streaming channel.</p>"
       },
       "fansCount": 5114536,

tests/fixtures/get_music_together_affinity.json

@@ -65,7 +65,6 @@
               "fansCount": 5000000,
               "isFavorite": true,
               "bio": {
-                "summary": "French electronic music duo.",
                 "full": "Daft Punk was a French electronic music duo..."
               }
             }

tests/fixtures/get_similar_artists.json

@@ -0,0 +1,57 @@
+{
+  "data": {
+    "artist": {
+      "relatedArtist": {
+        "edges": [
+          {
+            "node": {
+              "__typename": "Artist",
+              "id": "101",
+              "name": "Related Artist One",
+              "picture": {
+                "id": "pic_101",
+                "urls": ["https://cdn.deezer.com/artist/101/264x264.jpg"]
+              },
+              "fansCount": 500000,
+              "isFavorite": false,
+              "bio": {
+                "full": "Full biography of Related Artist One"
+              }
+            }
+          },
+          {
+            "node": {
+              "__typename": "Artist",
+              "id": "102",
+              "name": "Related Artist Two",
+              "picture": null,
+              "fansCount": 250000,
+              "isFavorite": true,
+              "bio": null
+            }
+          },
+          {
+            "node": {
+              "__typename": "Artist",
+              "id": "103",
+              "name": "Related Artist Three",
+              "picture": {
+                "id": "pic_103",
+                "urls": ["https://cdn.deezer.com/artist/103/264x264.jpg"]
+              },
+              "fansCount": 100000,
+              "isFavorite": false,
+              "bio": {
+                "full": "Full bio text here"
+              }
+            }
+          }
+        ],
+        "pageInfo": {
+          "hasNextPage": false,
+          "endCursor": "cursor_3"
+        }
+      }
+    }
+  }
+}

tests/test_client.py

@@ -73,6 +73,7 @@
 )
 from deezer_python_gql.generated.get_recently_played import GetRecentlyPlayed
 from deezer_python_gql.generated.get_recommendations import GetRecommendations
+from deezer_python_gql.generated.get_similar_artists import GetSimilarArtists
 from deezer_python_gql.generated.get_similar_tracks import GetSimilarTracks
 from deezer_python_gql.generated.get_smart_tracklist import GetSmartTracklist
 from deezer_python_gql.generated.get_track import GetTrack
@@ -226,6 +227,7 @@ def test_client_has_generated_methods() -> None:
         "get_artist_mix",
         "get_track_mix",
         "get_similar_tracks",
+        "get_similar_artists",
         "get_audiobook",
         "get_audiobook_chapter",
         "get_favorite_audiobooks",
@@ -1290,6 +1292,22 @@ def test_smoke_get_similar_tracks() -> None:
     assert recs[2].contributors.edges[0].node.name == "Third Artist"
 
 
+def test_smoke_get_similar_artists() -> None:
+    """Verify GetSimilarArtists fixture parses with ArtistFields."""
+    data = _load_fixture("get_similar_artists.json")
+    artist = GetSimilarArtists.model_validate(data).artist
+    assert artist is not None
+    assert artist.related_artist is not None
+    nodes = [e.node for e in artist.related_artist.edges if e.node is not None]
+    assert len(nodes) == 3
+    assert nodes[0].id == "101"
+    assert nodes[0].name == "Related Artist One"
+    assert nodes[0].fans_count == 500000
+    assert nodes[1].is_favorite is True
+    assert nodes[2].bio is not None
+    assert nodes[2].bio.full == "Full bio text here"
+
+
 def test_smoke_get_favorite_audiobooks() -> None:
     """Verify GetFavoriteAudiobooks fixture parses with raw audiobook IDs."""
     data = _load_fixture("get_favorite_audiobooks.json")