deezer-python-gql 0.17.1__tar.gz → 0.18.0__tar.gz

{deezer_python_gql-0.17.1/deezer_python_gql.egg-info → deezer_python_gql-0.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deezer-python-gql
-Version: 0.17.1
+Version: 0.18.0
 Summary: Async typed Python client for Deezer's Pipe GraphQL API.
 Author-email: Julian Daberkow <jdaberkow@users.noreply.github.com>
 License: Apache-2.0
@@ -13,15 +13,16 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: aiohttp>=3.13.5
 Requires-Dist: pydantic>=2.0.0
+Requires-Dist: yarl>=1.22.0
 Provides-Extra: test
-Requires-Dist: codespell==2.4.2; extra == "test"
-Requires-Dist: mypy==2.1.0; extra == "test"
-Requires-Dist: pre-commit==4.6.0; extra == "test"
+Requires-Dist: codespell==2.4.3; extra == "test"
+Requires-Dist: mypy==2.3.1; extra == "test"
+Requires-Dist: pre-commit==4.6.2; extra == "test"
 Requires-Dist: pre-commit-hooks==6.0.0; extra == "test"
 Requires-Dist: pytest==9.1.1; extra == "test"
 Requires-Dist: pytest-asyncio==1.4.0; extra == "test"
 Requires-Dist: pytest-cov==7.1.0; extra == "test"
-Requires-Dist: ruff==0.15.20; extra == "test"
+Requires-Dist: ruff==0.16.8; extra == "test"
 Provides-Extra: dev
 Requires-Dist: ariadne-codegen[subscriptions]; extra == "dev"
 Dynamic: license-file
@@ -47,6 +48,7 @@ import asyncio
 
 from deezer_python_gql import DeezerGQLClient
 
+
 async def main():
     client = DeezerGQLClient(arl="YOUR_ARL_COOKIE")
 
@@ -74,6 +76,7 @@ async def main():
     results = await client.search(query="Daft Punk")
     print(len(results.tracks.edges), "tracks found")
 
+
 asyncio.run(main())
 ```
 
@@ -252,6 +255,10 @@ The Pipe API uses short-lived JWTs obtained from an ARL cookie. The base client
 handles token acquisition and refresh automatically — you only need to supply a
 valid ARL value.
 
+An external `aiohttp.ClientSession` may be shared by clients for different Deezer
+accounts. Each client keeps Deezer's response cookies locally and masks cookies from
+the shared session jar, so authentication state cannot cross between those accounts.
+
 If the ARL is rejected (bad or expired), the client raises
 `GraphQLClientAuthError` — catch it to prompt for a new ARL instead of retrying.
 Transient server errors raise `GraphQLClientHttpError` instead.

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/README.md

@@ -19,6 +19,7 @@ import asyncio
 
 from deezer_python_gql import DeezerGQLClient
 
+
 async def main():
     client = DeezerGQLClient(arl="YOUR_ARL_COOKIE")
 
@@ -46,6 +47,7 @@ async def main():
     results = await client.search(query="Daft Punk")
     print(len(results.tracks.edges), "tracks found")
 
+
 asyncio.run(main())
 ```
 
@@ -224,6 +226,10 @@ The Pipe API uses short-lived JWTs obtained from an ARL cookie. The base client
 handles token acquisition and refresh automatically — you only need to supply a
 valid ARL value.
 
+An external `aiohttp.ClientSession` may be shared by clients for different Deezer
+accounts. Each client keeps Deezer's response cookies locally and masks cookies from
+the shared session jar, so authentication state cannot cross between those accounts.
+
 If the ARL is rejected (bad or expired), the client raises
 `GraphQLClientAuthError` — catch it to prompt for a new ARL instead of retrying.
 Transient server errors raise `GraphQLClientHttpError` instead.

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/base_client.py

@@ -8,9 +8,13 @@ import logging
 import time
 from base64 import urlsafe_b64decode
 from dataclasses import dataclass
-from typing import Any, ClassVar, Self, cast
+from typing import TYPE_CHECKING, Any, ClassVar, Self, cast
 
 from aiohttp import ClientSession, ClientTimeout
+from yarl import URL
+
+if TYPE_CHECKING:
+    from aiohttp import ClientResponse
 
 logger = logging.getLogger(__name__)
 
@@ -137,6 +141,9 @@ class DeezerBaseClient:
         self._arl = arl
         self._session = session
         self._owns_session = session is None
+        # An external session may be shared by clients for different Deezer accounts.
+        # Keep Deezer's response cookies per client instead of trusting that shared jar.
+        self._cookies: dict[str, str] = {}
         self._jwt: str | None = None
         self._jwt_expires_at: float = 0
         self._jwt_lock = asyncio.Lock()
@@ -167,6 +174,21 @@ class DeezerBaseClient:
         """Exit the async context manager, closing internal resources."""
         await self.close()
 
+    def _request_cookies(self, url: str, *, include_arl: bool = False) -> dict[str, str]:
+        """Return account-local cookies while neutralizing a shared session's jar."""
+        session = self._get_session()
+        blanked = dict.fromkeys(session.cookie_jar.filter_cookies(URL(url)), "")
+        cookies = blanked | self._cookies
+        if include_arl:
+            cookies["arl"] = self._arl
+        return cookies
+
+    def _store_cookies(self, response: ClientResponse) -> None:
+        """Remember response cookies for this client instead of relying on the session jar."""
+        self._cookies.update(
+            {name: morsel.value for name, morsel in response.cookies.items() if name != "arl"}
+        )
+
     async def execute(
         self,
         query: str,
@@ -189,6 +211,8 @@ class DeezerBaseClient:
         headers["Authorization"] = f"Bearer {jwt}"
         headers["Content-Type"] = "application/json"
         kwargs.setdefault("timeout", ClientTimeout(total=self.REQUEST_TIMEOUT_SECONDS))
+        request_cookies = self._request_cookies(self.url)
+        request_cookies.update(kwargs.pop("cookies", None) or {})
 
         payload: dict[str, Any] = {"query": query}
         if operation_name:
@@ -203,7 +227,14 @@ class DeezerBaseClient:
             }
 
         session = self._get_session()
-        async with session.post(self.url, json=payload, headers=headers, **kwargs) as resp:
+        async with session.post(
+            self.url,
+            json=payload,
+            headers=headers,
+            cookies=request_cookies,
+            **kwargs,
+        ) as resp:
+            self._store_cookies(resp)
             body = await resp.read()
             gql_response = GQLResponse(
                 status=resp.status,
@@ -321,9 +352,10 @@ class DeezerBaseClient:
             async with session.post(
                 self.AUTH_URL,
                 params=params,
-                cookies={"arl": self._arl},
+                cookies=self._request_cookies(self.AUTH_URL, include_arl=True),
                 timeout=ClientTimeout(total=10),
             ) as resp:
+                self._store_cookies(resp)
                 status = resp.status
                 is_success = resp.ok
                 # Response body is text/plain containing JSON

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/add_audiobook_to_favorite.py

@@ -1,8 +1,6 @@
 # Generated by ariadne-codegen
 # Source: queries
 
-from typing import Any
-
 from pydantic import Field
 
 from .base_model import BaseModel
@@ -16,7 +14,7 @@ class AddAudiobookToFavorite(BaseModel):
 
 class AddAudiobookToFavoriteAddAudiobookToFavorite(BaseModel):
     id: str
-    favorited_at: Any = Field(alias="favoritedAt")
+    favorited_at: str = Field(alias="favoritedAt")
 
 
 AddAudiobookToFavorite.model_rebuild()

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/add_podcast_to_favorite.py

@@ -1,8 +1,6 @@
 # Generated by ariadne-codegen
 # Source: queries
 
-from typing import Any
-
 from pydantic import Field
 
 from .base_model import BaseModel
@@ -16,7 +14,7 @@ class AddPodcastToFavorite(BaseModel):
 
 class AddPodcastToFavoriteAddPodcastToFavorite(BaseModel):
     podcast: "AddPodcastToFavoriteAddPodcastToFavoritePodcast"
-    favorited_at: Any = Field(alias="favoritedAt")
+    favorited_at: str = Field(alias="favoritedAt")
 
 
 class AddPodcastToFavoriteAddPodcastToFavoritePodcast(BaseModel):

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/base_client.py

@@ -10,9 +10,13 @@ import logging
 import time
 from base64 import urlsafe_b64decode
 from dataclasses import dataclass
-from typing import Any, ClassVar, Self, cast
+from typing import TYPE_CHECKING, Any, ClassVar, Self, cast
 
 from aiohttp import ClientSession, ClientTimeout
+from yarl import URL
+
+if TYPE_CHECKING:
+    from aiohttp import ClientResponse
 
 logger = logging.getLogger(__name__)
 
@@ -139,6 +143,9 @@ class DeezerBaseClient:
         self._arl = arl
         self._session = session
         self._owns_session = session is None
+        # An external session may be shared by clients for different Deezer accounts.
+        # Keep Deezer's response cookies per client instead of trusting that shared jar.
+        self._cookies: dict[str, str] = {}
         self._jwt: str | None = None
         self._jwt_expires_at: float = 0
         self._jwt_lock = asyncio.Lock()
@@ -169,6 +176,21 @@ class DeezerBaseClient:
         """Exit the async context manager, closing internal resources."""
         await self.close()
 
+    def _request_cookies(self, url: str, *, include_arl: bool = False) -> dict[str, str]:
+        """Return account-local cookies while neutralizing a shared session's jar."""
+        session = self._get_session()
+        blanked = dict.fromkeys(session.cookie_jar.filter_cookies(URL(url)), "")
+        cookies = blanked | self._cookies
+        if include_arl:
+            cookies["arl"] = self._arl
+        return cookies
+
+    def _store_cookies(self, response: ClientResponse) -> None:
+        """Remember response cookies for this client instead of relying on the session jar."""
+        self._cookies.update(
+            {name: morsel.value for name, morsel in response.cookies.items() if name != "arl"}
+        )
+
     async def execute(
         self,
         query: str,
@@ -191,6 +213,8 @@ class DeezerBaseClient:
         headers["Authorization"] = f"Bearer {jwt}"
         headers["Content-Type"] = "application/json"
         kwargs.setdefault("timeout", ClientTimeout(total=self.REQUEST_TIMEOUT_SECONDS))
+        request_cookies = self._request_cookies(self.url)
+        request_cookies.update(kwargs.pop("cookies", None) or {})
 
         payload: dict[str, Any] = {"query": query}
         if operation_name:
@@ -205,7 +229,14 @@ class DeezerBaseClient:
             }
 
         session = self._get_session()
-        async with session.post(self.url, json=payload, headers=headers, **kwargs) as resp:
+        async with session.post(
+            self.url,
+            json=payload,
+            headers=headers,
+            cookies=request_cookies,
+            **kwargs,
+        ) as resp:
+            self._store_cookies(resp)
             body = await resp.read()
             gql_response = GQLResponse(
                 status=resp.status,
@@ -323,9 +354,10 @@ class DeezerBaseClient:
             async with session.post(
                 self.AUTH_URL,
                 params=params,
-                cookies={"arl": self._arl},
+                cookies=self._request_cookies(self.AUTH_URL, include_arl=True),
                 timeout=ClientTimeout(total=10),
             ) as resp:
+                self._store_cookies(resp)
                 status = resp.status
                 is_success = resp.ok
                 # Response body is text/plain containing JSON

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/bookmark_podcast_episode.py

@@ -1,7 +1,7 @@
 # Generated by ariadne-codegen
 # Source: queries
 
-from typing import Any, Optional
+from typing import Optional
 
 from pydantic import Field
 
@@ -22,7 +22,7 @@ class BookmarkPodcastEpisodeBookmarkPodcastEpisode(BaseModel):
 class BookmarkPodcastEpisodeBookmarkPodcastEpisodeBookmark(BaseModel):
     position: int
     is_played: bool = Field(alias="isPlayed")
-    bookmarked_at: Any = Field(alias="bookmarkedAt")
+    bookmarked_at: str = Field(alias="bookmarkedAt")
 
 
 BookmarkPodcastEpisode.model_rebuild()

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/client.py

@@ -2414,6 +2414,7 @@ class DeezerGQLClient(DeezerBaseClient):
                 tracks(first: $tracksFirst, after: $tracksAfter) {
                   edges {
                     cursor
+                    addedAt
                     node {
                       ...TrackFields
                     }

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/fragments.py

@@ -1,7 +1,7 @@
 # Generated by ariadne-codegen
 # Source: queries
 
-from typing import Any, Literal, Optional, Union
+from typing import Literal, Optional, Union
 
 from pydantic import Field
 
@@ -20,7 +20,7 @@ class AlbumFields(BaseModel):
     type_: AlbumType = Field(alias="type")
     cover: Optional["AlbumFieldsCover"]
     contributors: "AlbumFieldsContributors"
-    release_date: Optional[Any] = Field(alias="releaseDate")
+    release_date: Optional[str] = Field(alias="releaseDate")
     is_explicit: Optional[bool] = Field(alias="isExplicit")
     is_favorite: Optional[bool] = Field(alias="isFavorite")
     fans_count: int = Field(alias="fansCount")
@@ -88,7 +88,7 @@ class AudiobookFields(BaseModel):
     cover: Optional["AudiobookFieldsCover"]
     description: Optional[str]
     duration: int
-    release_date: Optional[Any] = Field(alias="releaseDate")
+    release_date: Optional[str] = Field(alias="releaseDate")
     fans_count: int = Field(alias="fansCount")
     is_explicit: bool = Field(alias="isExplicit")
     is_favorite: Optional[bool] = Field(alias="isFavorite")
@@ -179,7 +179,7 @@ class PodcastEpisodeFields(BaseModel):
     description: Optional[str]
     duration: int
     cover: Optional["PodcastEpisodeFieldsCover"]
-    publication_date: Optional[Any] = Field(alias="publicationDate")
+    publication_date: Optional[str] = Field(alias="publicationDate")
     media: "PodcastEpisodeFieldsMedia"
 
 

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/get_audiobook_chapter.py

@@ -1,7 +1,7 @@
 # Generated by ariadne-codegen
 # Source: queries
 
-from typing import Any, Optional
+from typing import Optional
 
 from pydantic import Field
 
@@ -37,7 +37,7 @@ class GetAudiobookChapterAudiobookChapterMedia(BaseModel):
 
 class GetAudiobookChapterAudiobookChapterMediaToken(BaseModel):
     payload: str
-    expires_at: Any = Field(alias="expiresAt")
+    expires_at: str = Field(alias="expiresAt")
 
 
 class GetAudiobookChapterAudiobookChapterMediaEstimatedSizes(BaseModel):

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/get_favorite_albums.py

@@ -1,7 +1,7 @@
 # Generated by ariadne-codegen
 # Source: queries
 
-from typing import Any, Optional
+from typing import Optional
 
 from pydantic import Field
 
@@ -30,7 +30,7 @@ class GetFavoriteAlbumsMeUserFavoritesAlbums(BaseModel):
 
 class GetFavoriteAlbumsMeUserFavoritesAlbumsEdges(BaseModel):
     cursor: str
-    favorited_at: Any = Field(alias="favoritedAt")
+    favorited_at: str = Field(alias="favoritedAt")
     node: Optional["GetFavoriteAlbumsMeUserFavoritesAlbumsEdgesNode"]
 
 

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/get_favorite_artists.py

@@ -1,7 +1,7 @@
 # Generated by ariadne-codegen
 # Source: queries
 
-from typing import Any, Optional
+from typing import Optional
 
 from pydantic import Field
 
@@ -30,7 +30,7 @@ class GetFavoriteArtistsMeUserFavoritesArtists(BaseModel):
 
 class GetFavoriteArtistsMeUserFavoritesArtistsEdges(BaseModel):
     cursor: str
-    favorited_at: Any = Field(alias="favoritedAt")
+    favorited_at: str = Field(alias="favoritedAt")
     node: Optional["GetFavoriteArtistsMeUserFavoritesArtistsEdgesNode"]
 
 

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/get_favorite_audiobooks.py

@@ -1,7 +1,7 @@
 # Generated by ariadne-codegen
 # Source: queries
 
-from typing import Any, Optional
+from typing import Optional
 
 from pydantic import Field
 
@@ -24,7 +24,7 @@ class GetFavoriteAudiobooksMeFavorites(BaseModel):
 
 class GetFavoriteAudiobooksMeFavoritesRawAudiobooks(BaseModel):
     id: str
-    favorited_at: Any = Field(alias="favoritedAt")
+    favorited_at: str = Field(alias="favoritedAt")
 
 
 GetFavoriteAudiobooks.model_rebuild()

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/get_favorite_playlists.py

@@ -1,7 +1,7 @@
 # Generated by ariadne-codegen
 # Source: queries
 
-from typing import Any, Optional
+from typing import Optional
 
 from pydantic import Field
 
@@ -30,7 +30,7 @@ class GetFavoritePlaylistsMeUserFavoritesPlaylists(BaseModel):
 
 class GetFavoritePlaylistsMeUserFavoritesPlaylistsEdges(BaseModel):
     cursor: str
-    favorited_at: Any = Field(alias="favoritedAt")
+    favorited_at: str = Field(alias="favoritedAt")
     node: Optional["GetFavoritePlaylistsMeUserFavoritesPlaylistsEdgesNode"]
 
 

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/get_favorite_podcasts.py

@@ -1,7 +1,7 @@
 # Generated by ariadne-codegen
 # Source: queries
 
-from typing import Any, Optional
+from typing import Optional
 
 from pydantic import Field
 
@@ -30,7 +30,7 @@ class GetFavoritePodcastsMeUserFavoritesPodcasts(BaseModel):
 
 class GetFavoritePodcastsMeUserFavoritesPodcastsEdges(BaseModel):
     cursor: str
-    favorited_at: Any = Field(alias="favoritedAt")
+    favorited_at: str = Field(alias="favoritedAt")
     node: Optional["GetFavoritePodcastsMeUserFavoritesPodcastsEdgesNode"]
 
 

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/get_favorite_tracks.py

@@ -1,7 +1,7 @@
 # Generated by ariadne-codegen
 # Source: queries
 
-from typing import Any, Optional
+from typing import Optional
 
 from pydantic import Field
 
@@ -30,7 +30,7 @@ class GetFavoriteTracksMeUserFavoritesTracks(BaseModel):
 
 class GetFavoriteTracksMeUserFavoritesTracksEdges(BaseModel):
     cursor: str
-    favorited_at: Any = Field(alias="favoritedAt")
+    favorited_at: str = Field(alias="favoritedAt")
     node: Optional["GetFavoriteTracksMeUserFavoritesTracksEdgesNode"]
 
 

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/get_music_together_group.py

@@ -1,7 +1,7 @@
 # Generated by ariadne-codegen
 # Source: queries
 
-from typing import Any, Optional
+from typing import Optional
 
 from pydantic import Field
 
@@ -21,8 +21,8 @@ class GetMusicTogetherGroupMusicTogetherGroup(BaseModel):
     is_ready: bool = Field(alias="isReady")
     is_family: bool = Field(alias="isFamily")
     estimated_members_count: int = Field(alias="estimatedMembersCount")
-    created_at: Any = Field(alias="createdAt")
-    updated_at: Any = Field(alias="updatedAt")
+    created_at: str = Field(alias="createdAt")
+    updated_at: str = Field(alias="updatedAt")
     members: "GetMusicTogetherGroupMusicTogetherGroupMembers"
     suggested_tracklist: Optional[
         "GetMusicTogetherGroupMusicTogetherGroupSuggestedTracklist"
@@ -41,7 +41,7 @@ class GetMusicTogetherGroupMusicTogetherGroupMembers(BaseModel):
 
 class GetMusicTogetherGroupMusicTogetherGroupMembersEdges(BaseModel):
     cursor: str
-    joined_at: Any = Field(alias="joinedAt")
+    joined_at: str = Field(alias="joinedAt")
     node: Optional["GetMusicTogetherGroupMusicTogetherGroupMembersEdgesNode"]
     affinity: Optional["GetMusicTogetherGroupMusicTogetherGroupMembersEdgesAffinity"]
 

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/get_music_together_groups.py

@@ -1,7 +1,7 @@
 # Generated by ariadne-codegen
 # Source: queries
 
-from typing import Any, Optional
+from typing import Optional
 
 from pydantic import Field
 
@@ -38,8 +38,8 @@ class GetMusicTogetherGroupsMeMusicTogetherGroupsEdgesNode(BaseModel):
     is_ready: bool = Field(alias="isReady")
     is_family: bool = Field(alias="isFamily")
     estimated_members_count: int = Field(alias="estimatedMembersCount")
-    created_at: Any = Field(alias="createdAt")
-    updated_at: Any = Field(alias="updatedAt")
+    created_at: str = Field(alias="createdAt")
+    updated_at: str = Field(alias="updatedAt")
     members: "GetMusicTogetherGroupsMeMusicTogetherGroupsEdgesNodeMembers"
 
 
@@ -52,7 +52,7 @@ class GetMusicTogetherGroupsMeMusicTogetherGroupsEdgesNodeMembers(BaseModel):
 
 class GetMusicTogetherGroupsMeMusicTogetherGroupsEdgesNodeMembersEdges(BaseModel):
     cursor: str
-    joined_at: Any = Field(alias="joinedAt")
+    joined_at: str = Field(alias="joinedAt")
     node: Optional[
         "GetMusicTogetherGroupsMeMusicTogetherGroupsEdgesNodeMembersEdgesNode"
     ]

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/get_playlist.py

@@ -27,6 +27,7 @@ class GetPlaylistPlaylistTracks(BaseModel):
 
 class GetPlaylistPlaylistTracksEdges(BaseModel):
     cursor: str
+    added_at: str = Field(alias="addedAt")
     node: Optional["GetPlaylistPlaylistTracksEdgesNode"]
 
 

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/get_podcast_episode_bookmarks.py

@@ -1,7 +1,7 @@
 # Generated by ariadne-codegen
 # Source: queries
 
-from typing import Any, Optional
+from typing import Optional
 
 from pydantic import Field
 
@@ -35,7 +35,7 @@ class GetPodcastEpisodeBookmarksMePodcastEpisodeBookmarksEdgesNode(BaseModel):
     episode: "GetPodcastEpisodeBookmarksMePodcastEpisodeBookmarksEdgesNodeEpisode"
     position: int
     is_played: bool = Field(alias="isPlayed")
-    bookmarked_at: Any = Field(alias="bookmarkedAt")
+    bookmarked_at: str = Field(alias="bookmarkedAt")
 
 
 class GetPodcastEpisodeBookmarksMePodcastEpisodeBookmarksEdgesNodeEpisode(

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/get_track.py

@@ -1,7 +1,7 @@
 # Generated by ariadne-codegen
 # Source: queries
 
-from typing import Any, Literal, Optional, Union
+from typing import Literal, Optional, Union
 
 from pydantic import Field
 
@@ -25,7 +25,7 @@ class GetTrackTrack(BaseModel):
     album: Optional["GetTrackTrackAlbum"]
     contributors: "GetTrackTrackContributors"
     is_atmos: bool = Field(alias="isAtmos")
-    release_date: Optional[Any] = Field(alias="releaseDate")
+    release_date: Optional[str] = Field(alias="releaseDate")
     media: Optional["GetTrackTrackMedia"]
     lyrics: Optional["GetTrackTrackLyrics"]
 
@@ -73,7 +73,7 @@ class GetTrackTrackMedia(BaseModel):
 
 class GetTrackTrackMediaToken(BaseModel):
     payload: str
-    expires_at: Any = Field(alias="expiresAt")
+    expires_at: str = Field(alias="expiresAt")
 
 
 class GetTrackTrackMediaEstimatedSizes(BaseModel):

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/mark_as_played_podcast_episode.py

@@ -1,7 +1,7 @@
 # Generated by ariadne-codegen
 # Source: queries
 
-from typing import Any, Optional
+from typing import Optional
 
 from pydantic import Field
 
@@ -22,7 +22,7 @@ class MarkAsPlayedPodcastEpisodeMarkAsPlayedPodcastEpisode(BaseModel):
 class MarkAsPlayedPodcastEpisodeMarkAsPlayedPodcastEpisodeBookmark(BaseModel):
     position: int
     is_played: bool = Field(alias="isPlayed")
-    bookmarked_at: Any = Field(alias="bookmarkedAt")
+    bookmarked_at: str = Field(alias="bookmarkedAt")
 
 
 MarkAsPlayedPodcastEpisode.model_rebuild()

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/music_together_create_group.py

@@ -1,7 +1,7 @@
 # Generated by ariadne-codegen
 # Source: queries
 
-from typing import Any, Literal, Optional, Union
+from typing import Literal, Optional, Union
 
 from pydantic import Field
 
@@ -30,7 +30,7 @@ class MusicTogetherCreateGroupMusicTogetherCreateGroupMusicTogetherCreateGroupOu
     is_ready: bool = Field(alias="isReady")
     is_family: bool = Field(alias="isFamily")
     estimated_members_count: int = Field(alias="estimatedMembersCount")
-    created_at: Any = Field(alias="createdAt")
+    created_at: str = Field(alias="createdAt")
 
 
 class MusicTogetherCreateGroupMusicTogetherCreateGroupMusicTogetherCreateGroupError(

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql/generated/search.py

@@ -1,7 +1,7 @@
 # Generated by ariadne-codegen
 # Source: queries
 
-from typing import Any, Literal, Optional, Union
+from typing import Literal, Optional, Union
 
 from pydantic import Field
 
@@ -108,7 +108,7 @@ class SearchSearchResultsAlbumsEdgesNode(BaseModel):
     type_: AlbumType = Field(alias="type")
     cover: Optional["SearchSearchResultsAlbumsEdgesNodeCover"]
     contributors: "SearchSearchResultsAlbumsEdgesNodeContributors"
-    release_date: Optional[Any] = Field(alias="releaseDate")
+    release_date: Optional[str] = Field(alias="releaseDate")
     is_explicit: Optional[bool] = Field(alias="isExplicit")
     is_favorite: Optional[bool] = Field(alias="isFavorite")
 

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0/deezer_python_gql.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deezer-python-gql
-Version: 0.17.1
+Version: 0.18.0
 Summary: Async typed Python client for Deezer's Pipe GraphQL API.
 Author-email: Julian Daberkow <jdaberkow@users.noreply.github.com>
 License: Apache-2.0
@@ -13,15 +13,16 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: aiohttp>=3.13.5
 Requires-Dist: pydantic>=2.0.0
+Requires-Dist: yarl>=1.22.0
 Provides-Extra: test
-Requires-Dist: codespell==2.4.2; extra == "test"
-Requires-Dist: mypy==2.1.0; extra == "test"
-Requires-Dist: pre-commit==4.6.0; extra == "test"
+Requires-Dist: codespell==2.4.3; extra == "test"
+Requires-Dist: mypy==2.3.1; extra == "test"
+Requires-Dist: pre-commit==4.6.2; extra == "test"
 Requires-Dist: pre-commit-hooks==6.0.0; extra == "test"
 Requires-Dist: pytest==9.1.1; extra == "test"
 Requires-Dist: pytest-asyncio==1.4.0; extra == "test"
 Requires-Dist: pytest-cov==7.1.0; extra == "test"
-Requires-Dist: ruff==0.15.20; extra == "test"
+Requires-Dist: ruff==0.16.8; extra == "test"
 Provides-Extra: dev
 Requires-Dist: ariadne-codegen[subscriptions]; extra == "dev"
 Dynamic: license-file
@@ -47,6 +48,7 @@ import asyncio
 
 from deezer_python_gql import DeezerGQLClient
 
+
 async def main():
     client = DeezerGQLClient(arl="YOUR_ARL_COOKIE")
 
@@ -74,6 +76,7 @@ async def main():
     results = await client.search(query="Daft Punk")
     print(len(results.tracks.edges), "tracks found")
 
+
 asyncio.run(main())
 ```
 
@@ -252,6 +255,10 @@ The Pipe API uses short-lived JWTs obtained from an ARL cookie. The base client
 handles token acquisition and refresh automatically — you only need to supply a
 valid ARL value.
 
+An external `aiohttp.ClientSession` may be shared by clients for different Deezer
+accounts. Each client keeps Deezer's response cookies locally and masks cookies from
+the shared session jar, so authentication state cannot cross between those accounts.
+
 If the ARL is rejected (bad or expired), the client raises
 `GraphQLClientAuthError` — catch it to prompt for a new ARL instead of retrying.
 Transient server errors raise `GraphQLClientHttpError` instead.

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/deezer_python_gql.egg-info/requires.txt

@@ -1,15 +1,16 @@
 aiohttp>=3.13.5
 pydantic>=2.0.0
+yarl>=1.22.0
 
 [dev]
 ariadne-codegen[subscriptions]
 
 [test]
-codespell==2.4.2
-mypy==2.1.0
-pre-commit==4.6.0
+codespell==2.4.3
+mypy==2.3.1
+pre-commit==4.6.2
 pre-commit-hooks==6.0.0
 pytest==9.1.1
 pytest-asyncio==1.4.0
 pytest-cov==7.1.0
-ruff==0.15.20
+ruff==0.16.8

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "deezer-python-gql"
-version = "0.17.1"
+version = "0.18.0"
 description = "Async typed Python client for Deezer's Pipe GraphQL API."
 readme = "README.md"
 requires-python = ">=3.12"
@@ -15,6 +15,7 @@ classifiers = [
 dependencies = [
     "aiohttp>=3.13.5",
     "pydantic>=2.0.0",
+    "yarl>=1.22.0",
 ]
 
 [project.license]
@@ -22,14 +23,14 @@ text = "Apache-2.0"
 
 [project.optional-dependencies]
 test = [
-    "codespell==2.4.2",
-    "mypy==2.1.0",
-    "pre-commit==4.6.0",
+    "codespell==2.4.3",
+    "mypy==2.3.1",
+    "pre-commit==4.6.2",
     "pre-commit-hooks==6.0.0",
     "pytest==9.1.1",
     "pytest-asyncio==1.4.0",
     "pytest-cov==7.1.0",
-    "ruff==0.15.20",
+    "ruff==0.16.8",
 ]
 dev = [
     "ariadne-codegen[subscriptions]",
@@ -67,6 +68,9 @@ plugins = [
     "ariadne_codegen.contrib.shorter_results.ShorterResultsPlugin",
 ]
 
+[tool.ariadne-codegen.scalars.Date]
+type = "str"
+
 [tool.codespell]
 skip = "*.json,schema.graphql"
 
@@ -99,6 +103,7 @@ ignore = [
     "TD004",
     "TRY003",
     "COM812",
+    "CPY001",
     "ISC001",
 ]
 select = [

{deezer_python_gql-0.17.1 → deezer_python_gql-0.18.0}/tests/test_client.py

@@ -13,11 +13,15 @@ import asyncio
 import base64
 import json
 import time
+from http.cookies import SimpleCookie
 from pathlib import Path
-from typing import Any
+from typing import Any, Self, cast
 from unittest.mock import AsyncMock, MagicMock, patch
 
 import pytest
+from aiohttp import ClientSession, CookieJar
+from pydantic import ValidationError
+from yarl import URL
 
 from deezer_python_gql import DeezerGQLClient
 from deezer_python_gql.base_client import (
@@ -124,7 +128,7 @@ def _load_fixture(name: str) -> dict[str, Any]:
     return result
 
 
-def _make_jwt(exp: float | None = None) -> str:
+def _make_jwt(exp: float | None = None, subject: str | None = None) -> str:
     """
     Build a fake JWT with a configurable expiration timestamp.
 
@@ -133,13 +137,10 @@ def _make_jwt(exp: float | None = None) -> str:
     if exp is None:
         exp = time.time() + 360  # 6 min, matching Deezer's real TTL
     header = base64.urlsafe_b64encode(b'{"alg":"ES256"}').rstrip(b"=").decode()
-    payload = (
-        base64.urlsafe_b64encode(
-            json.dumps({"exp": exp}).encode(),
-        )
-        .rstrip(b"=")
-        .decode()
-    )
+    payload_data: dict[str, float | str] = {"exp": exp}
+    if subject is not None:
+        payload_data["sub"] = subject
+    payload = base64.urlsafe_b64encode(json.dumps(payload_data).encode()).rstrip(b"=").decode()
     return f"{header}.{payload}.fake_signature"
 
 
@@ -156,6 +157,7 @@ def _mock_post_context_manager(response_body: bytes, status: int = 200) -> Async
     mock_resp.read = AsyncMock(return_value=response_body)
     mock_resp.text = AsyncMock(return_value=response_body.decode())
     mock_resp.raise_for_status = MagicMock()
+    mock_resp.cookies = SimpleCookie()
 
     cm = AsyncMock()
     cm.__aenter__ = AsyncMock(return_value=mock_resp)
@@ -171,6 +173,86 @@ def _mock_auth_cm(jwt: str | None = None) -> AsyncMock:
     return _mock_post_context_manager(body)
 
 
+class _FakeCookieResponse:
+    """Small aiohttp response stand-in for the shared-cookie regression test."""
+
+    def __init__(
+        self,
+        body: bytes,
+        response_cookies: SimpleCookie | None = None,
+    ) -> None:
+        self.status = 200
+        self.ok = True
+        self._body = body
+        self.cookies = response_cookies or SimpleCookie()
+
+    async def __aenter__(self) -> Self:
+        return self
+
+    async def __aexit__(self, *args: object) -> None:
+        return None
+
+    async def read(self) -> bytes:
+        return self._body
+
+    async def text(self) -> str:
+        return self._body.decode()
+
+
+class _FakeSharedSession:
+    """Model Deezer preferring an existing refresh cookie over a new ARL."""
+
+    def __init__(self) -> None:
+        self.cookie_jar = CookieJar()
+        self._arl_accounts = {"arl-a": "1001", "arl-b": "2002"}
+        self._refresh_accounts = {"refresh-a": "1001", "refresh-b": "2002"}
+        self._account_refresh = {value: key for key, value in self._refresh_accounts.items()}
+        self._account_cookies = {
+            account: {
+                "refresh-token": refresh,
+                "sid": f"sid-{account}",
+                "dzr_uniq_id": f"unique-{account}",
+                "_abck": f"abck-{account}",
+                "bm_sz": f"bm-{account}",
+            }
+            for account, refresh in self._account_refresh.items()
+        }
+        self._account_jwt = {
+            account: _make_jwt(subject=account) for account in self._arl_accounts.values()
+        }
+        self._jwt_account = {jwt: account for account, jwt in self._account_jwt.items()}
+        self.requests: list[tuple[str, dict[str, str]]] = []
+
+    def post(self, url: str, **kwargs: Any) -> _FakeCookieResponse:
+        """Resolve the request identity and update the shared response-cookie jar."""
+        request_cookies = {
+            name: morsel.value for name, morsel in self.cookie_jar.filter_cookies(URL(url)).items()
+        }
+        request_cookies.update(kwargs.get("cookies") or {})
+        self.requests.append((url, request_cookies))
+
+        if url == DeezerBaseClient.AUTH_URL:
+            if refresh := request_cookies.get("refresh-token"):
+                account = self._refresh_accounts[refresh]
+            else:
+                account = self._arl_accounts[request_cookies["arl"]]
+            response_cookies = SimpleCookie()
+            for name, value in self._account_cookies[account].items():
+                response_cookies[name] = value
+                response_cookies[name]["domain"] = ".deezer.com"
+                response_cookies[name]["path"] = "/"
+            self.cookie_jar.update_cookies(response_cookies, response_url=URL(url))
+            return _FakeCookieResponse(
+                json.dumps({"jwt": self._account_jwt[account]}).encode(),
+                response_cookies,
+            )
+
+        authorization = cast("dict[str, str]", kwargs["headers"])["Authorization"]
+        jwt = authorization.removeprefix("Bearer ")
+        account = self._jwt_account[jwt]
+        return _FakeCookieResponse(json.dumps({"data": {"me": {"id": account}}}).encode())
+
+
 # ---------------------------------------------------------------------------
 # 1. Client setup
 # ---------------------------------------------------------------------------
@@ -413,6 +495,40 @@ async def test_auth_sends_arl_cookie_to_correct_domain() -> None:
     assert auth_call.kwargs["cookies"] == {"arl": "my_secret_arl"}
 
 
+@pytest.mark.parametrize(("first_arl", "second_arl"), [("arl-a", "arl-b"), ("arl-b", "arl-a")])
+@pytest.mark.asyncio
+async def test_shared_session_keeps_account_cookies_isolated(
+    first_arl: str, second_arl: str
+) -> None:
+    """Verify a shared jar cannot make the first authenticated account win."""
+    session = _FakeSharedSession()
+    expected = session._arl_accounts  # noqa: SLF001
+    first = DeezerGQLClient(arl=first_arl, session=cast("ClientSession", session))
+    second = DeezerGQLClient(arl=second_arl, session=cast("ClientSession", session))
+
+    first_me = await first.get_me()
+    second_me = await second.get_me()
+
+    assert first_me is not None
+    assert second_me is not None
+    assert first_me.id == expected[first_arl]
+    assert second_me.id == expected[second_arl]
+
+    auth_requests = [cookies for url, cookies in session.requests if url == first.AUTH_URL]
+    pipe_requests = [cookies for url, cookies in session.requests if url == first.url]
+    assert auth_requests == [
+        {"arl": first_arl},
+        {
+            **dict.fromkeys(session._account_cookies[first_me.id], ""),  # noqa: SLF001
+            "arl": second_arl,
+        },
+    ]
+    assert pipe_requests == [
+        session._account_cookies[first_me.id],  # noqa: SLF001
+        session._account_cookies[second_me.id],  # noqa: SLF001
+    ]
+
+
 @pytest.mark.asyncio
 async def test_auth_parses_text_plain_response() -> None:
     """Verify the client handles auth.deezer.com's text/plain JSON response."""
@@ -845,7 +961,7 @@ def test_smoke_get_artist() -> None:
 
 
 def test_smoke_get_playlist() -> None:
-    """Verify GetPlaylist fixture parses with owner and paginated tracks."""
+    """Verify GetPlaylist fixture parses with owner, paginated tracks and add dates."""
     data = _load_fixture("get_playlist.json")
     playlist = GetPlaylist.model_validate(data).playlist
     assert playlist is not None
@@ -853,6 +969,7 @@ def test_smoke_get_playlist() -> None:
     assert playlist.title
     assert playlist.owner is not None
     assert len(playlist.tracks.edges) > 0
+    assert playlist.tracks.edges[0].added_at == "2026-09-18T07:30:12.000Z"
 
 
 def test_smoke_search() -> None:
@@ -1077,6 +1194,14 @@ def test_smoke_get_favorite_tracks() -> None:
     assert tracks.page_info.has_next_page is True
 
 
+def test_date_scalar_rejects_non_strings() -> None:
+    """Date scalar fields are typed as ISO 8601 strings, so other values fail validation."""
+    data = _load_fixture("get_favorite_tracks.json")
+    data["me"]["userFavorites"]["tracks"]["edges"][0]["favoritedAt"] = 1749945600
+    with pytest.raises(ValidationError, match="favoritedAt"):
+        GetFavoriteTracks.model_validate(data)
+
+
 def test_smoke_get_favorite_playlists() -> None:
     """Verify GetFavoritePlaylists fixture parses with pagination."""
     data = _load_fixture("get_favorite_playlists.json")