deezer-python-gql 0.8.2__tar.gz → 0.9.0__tar.gz

{deezer_python_gql-0.8.2/deezer_python_gql.egg-info → deezer_python_gql-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deezer-python-gql
-Version: 0.8.2
+Version: 0.9.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
@@ -15,13 +15,13 @@ Requires-Dist: httpx>=0.27.0
 Requires-Dist: pydantic>=2.0.0
 Provides-Extra: test
 Requires-Dist: codespell==2.4.2; extra == "test"
-Requires-Dist: mypy==1.19.1; extra == "test"
+Requires-Dist: mypy==1.20.0; extra == "test"
 Requires-Dist: pre-commit==4.5.1; extra == "test"
 Requires-Dist: pre-commit-hooks==6.0.0; extra == "test"
 Requires-Dist: pytest==9.0.2; extra == "test"
 Requires-Dist: pytest-asyncio==1.3.0; extra == "test"
 Requires-Dist: pytest-cov==7.1.0; extra == "test"
-Requires-Dist: ruff==0.15.7; extra == "test"
+Requires-Dist: ruff==0.15.8; extra == "test"
 Provides-Extra: dev
 Requires-Dist: ariadne-codegen[subscriptions]; extra == "dev"
 Dynamic: license-file

{deezer_python_gql-0.8.2 → deezer_python_gql-0.9.0}/deezer_python_gql/generated/base_client.py

@@ -8,7 +8,7 @@ import json
 import logging
 import time
 from base64 import urlsafe_b64decode
-from typing import Any, ClassVar, cast
+from typing import Any, ClassVar, Self, cast
 
 import httpx
 
@@ -78,9 +78,13 @@ class DeezerBaseClient:
     Handles the ARL cookie → JWT token exchange and automatic refresh.
     This class is used as the base client for ariadne-codegen's generated client.
 
+    Manages its own httpx connection pool by default. Pass an external
+    ``http_client`` only if you need to share a pool across multiple clients.
+
     :param arl: Deezer ARL cookie value for authentication.
     :param url: GraphQL endpoint URL (defaults to Pipe API).
     :param http_client: Optional pre-configured httpx.AsyncClient.
+        If provided, the caller is responsible for closing it.
     """
 
     PIPE_URL = "https://pipe.deezer.com/api"
@@ -96,9 +100,35 @@ class DeezerBaseClient:
         self.url = url
         self._arl = arl
         self._http_client = http_client
+        self._owns_http_client = http_client is None
         self._jwt: str | None = None
         self._jwt_expires_at: float = 0
 
+    def _get_http_client(self) -> httpx.AsyncClient:
+        """Return the HTTP client, creating an internal one if needed."""
+        if self._http_client is None:
+            self._http_client = httpx.AsyncClient()
+            self._owns_http_client = True
+        return self._http_client
+
+    async def close(self) -> None:
+        """Close the internal HTTP client if we own it.
+
+        Safe to call multiple times. Does nothing if an external
+        ``http_client`` was provided at construction time.
+        """
+        if self._owns_http_client and self._http_client is not None:
+            await self._http_client.aclose()
+            self._http_client = None
+
+    async def __aenter__(self) -> Self:
+        """Enter the async context manager."""
+        return self
+
+    async def __aexit__(self, *args: object) -> None:
+        """Exit the async context manager, closing internal resources."""
+        await self.close()
+
     async def execute(
         self,
         query: str,
@@ -134,24 +164,20 @@ class DeezerBaseClient:
                 k: v for k, v in variables.items() if not isinstance(v, UnsetType)
             }
 
-        client = self._http_client or httpx.AsyncClient()
-        try:
-            resp = await client.post(
-                self.url,
-                json=payload,
-                headers=headers,
-                **kwargs,
-            )
-            logger.debug(
-                "GQL response: %s status=%s length=%s",
-                operation_name or "<unnamed>",
-                resp.status_code,
-                len(resp.content),
-            )
-            return resp
-        finally:
-            if not self._http_client:
-                await client.aclose()
+        client = self._get_http_client()
+        resp = await client.post(
+            self.url,
+            json=payload,
+            headers=headers,
+            **kwargs,
+        )
+        logger.debug(
+            "GQL response: %s status=%s length=%s",
+            operation_name or "<unnamed>",
+            resp.status_code,
+            len(resp.content),
+        )
+        return resp
 
     def get_data(self, response: httpx.Response) -> dict[str, Any]:
         """Parse a GraphQL response and return the data dict.
@@ -238,13 +264,13 @@ class DeezerBaseClient:
         logger.debug("JWT expired or missing, refreshing from ARL")
         params = {"jo": "p", "rto": "c", "i": "c"}
 
-        async with httpx.AsyncClient() as http:
-            resp = await http.post(
-                self.AUTH_URL,
-                params=params,
-                cookies={"arl": self._arl},
-            )
-            resp.raise_for_status()
+        client = self._get_http_client()
+        resp = await client.post(
+            self.AUTH_URL,
+            params=params,
+            cookies={"arl": self._arl},
+        )
+        resp.raise_for_status()
 
         # Response body is text/plain containing JSON
         data = json.loads(resp.text)

{deezer_python_gql-0.8.2 → deezer_python_gql-0.9.0}/deezer_python_gql/generated/client.py

@@ -554,9 +554,15 @@ class DeezerGQLClient(DeezerBaseClient):
             data
         ).remove_audiobook_from_favorite
 
-    async def get_album(self, album_id: str, **kwargs: Any) -> Optional[GetAlbumAlbum]:
+    async def get_album(
+        self,
+        album_id: str,
+        tracks_first: Union[Optional[int], UnsetType] = UNSET,
+        tracks_after: Union[Optional[str], UnsetType] = UNSET,
+        **kwargs: Any
+    ) -> Optional[GetAlbumAlbum]:
         query = gql("""
-            query GetAlbum($albumId: String!) {
+            query GetAlbum($albumId: String!, $tracksFirst: Int = 50, $tracksAfter: String) {
               album(albumId: $albumId) {
                 ...AlbumFields
                 duration
@@ -567,7 +573,7 @@ class DeezerGQLClient(DeezerBaseClient):
                   id
                   displayTitle
                 }
-                tracks(first: 50) {
+                tracks(first: $tracksFirst, after: $tracksAfter) {
                   edges {
                     cursor
                     node {
@@ -651,7 +657,11 @@ class DeezerGQLClient(DeezerBaseClient):
               }
             }
             """)
-        variables: dict[str, object] = {"albumId": album_id}
+        variables: dict[str, object] = {
+            "albumId": album_id,
+            "tracksFirst": tracks_first,
+            "tracksAfter": tracks_after,
+        }
         response = await self.execute(
             query=query, operation_name="GetAlbum", variables=variables, **kwargs
         )
@@ -659,10 +669,16 @@ class DeezerGQLClient(DeezerBaseClient):
         return GetAlbum.model_validate(data).album
 
     async def get_artist(
-        self, artist_id: str, **kwargs: Any
+        self,
+        artist_id: str,
+        top_tracks_first: Union[Optional[int], UnsetType] = UNSET,
+        top_tracks_after: Union[Optional[str], UnsetType] = UNSET,
+        albums_first: Union[Optional[int], UnsetType] = UNSET,
+        albums_after: Union[Optional[str], UnsetType] = UNSET,
+        **kwargs: Any
     ) -> Optional[GetArtistArtist]:
         query = gql("""
-            query GetArtist($artistId: String!) {
+            query GetArtist($artistId: String!, $topTracksFirst: Int = 50, $topTracksAfter: String, $albumsFirst: Int = 25, $albumsAfter: String) {
               artist(artistId: $artistId) {
                 ...ArtistFields
                 url {
@@ -671,7 +687,7 @@ class DeezerGQLClient(DeezerBaseClient):
                     webUrl
                   }
                 }
-                topTracks(first: 50) {
+                topTracks(first: $topTracksFirst, after: $topTracksAfter) {
                   edges {
                     cursor
                     node {
@@ -682,7 +698,12 @@ class DeezerGQLClient(DeezerBaseClient):
                     ...PageInfoFields
                   }
                 }
-                albums(types: [ALBUM, SINGLES, EP], order: RELEASE_DATE, first: 25) {
+                albums(
+                  types: [ALBUM, SINGLES, EP]
+                  order: RELEASE_DATE
+                  first: $albumsFirst
+                  after: $albumsAfter
+                ) {
                   edges {
                     cursor
                     node {
@@ -776,7 +797,13 @@ class DeezerGQLClient(DeezerBaseClient):
               }
             }
             """)
-        variables: dict[str, object] = {"artistId": artist_id}
+        variables: dict[str, object] = {
+            "artistId": artist_id,
+            "topTracksFirst": top_tracks_first,
+            "topTracksAfter": top_tracks_after,
+            "albumsFirst": albums_first,
+            "albumsAfter": albums_after,
+        }
         response = await self.execute(
             query=query, operation_name="GetArtist", variables=variables, **kwargs
         )
@@ -2221,16 +2248,20 @@ class DeezerGQLClient(DeezerBaseClient):
         return GetMusicTogetherGroups.model_validate(data).me
 
     async def get_playlist(
-        self, playlist_id: str, **kwargs: Any
+        self,
+        playlist_id: str,
+        tracks_first: Union[Optional[int], UnsetType] = UNSET,
+        tracks_after: Union[Optional[str], UnsetType] = UNSET,
+        **kwargs: Any
     ) -> Optional[GetPlaylistPlaylist]:
         query = gql("""
-            query GetPlaylist($playlistId: String!) {
+            query GetPlaylist($playlistId: String!, $tracksFirst: Int = 50, $tracksAfter: String) {
               playlist(playlistId: $playlistId) {
                 ...PlaylistFields
                 isPrivate
                 isCollaborative
                 estimatedDuration
-                tracks(first: 50) {
+                tracks(first: $tracksFirst, after: $tracksAfter) {
                   edges {
                     cursor
                     node {
@@ -2299,7 +2330,11 @@ class DeezerGQLClient(DeezerBaseClient):
               }
             }
             """)
-        variables: dict[str, object] = {"playlistId": playlist_id}
+        variables: dict[str, object] = {
+            "playlistId": playlist_id,
+            "tracksFirst": tracks_first,
+            "tracksAfter": tracks_after,
+        }
         response = await self.execute(
             query=query, operation_name="GetPlaylist", variables=variables, **kwargs
         )

{deezer_python_gql-0.8.2 → deezer_python_gql-0.9.0/deezer_python_gql.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deezer-python-gql
-Version: 0.8.2
+Version: 0.9.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
@@ -15,13 +15,13 @@ Requires-Dist: httpx>=0.27.0
 Requires-Dist: pydantic>=2.0.0
 Provides-Extra: test
 Requires-Dist: codespell==2.4.2; extra == "test"
-Requires-Dist: mypy==1.19.1; extra == "test"
+Requires-Dist: mypy==1.20.0; extra == "test"
 Requires-Dist: pre-commit==4.5.1; extra == "test"
 Requires-Dist: pre-commit-hooks==6.0.0; extra == "test"
 Requires-Dist: pytest==9.0.2; extra == "test"
 Requires-Dist: pytest-asyncio==1.3.0; extra == "test"
 Requires-Dist: pytest-cov==7.1.0; extra == "test"
-Requires-Dist: ruff==0.15.7; extra == "test"
+Requires-Dist: ruff==0.15.8; extra == "test"
 Provides-Extra: dev
 Requires-Dist: ariadne-codegen[subscriptions]; extra == "dev"
 Dynamic: license-file

{deezer_python_gql-0.8.2 → deezer_python_gql-0.9.0}/deezer_python_gql.egg-info/requires.txt

@@ -6,10 +6,10 @@ ariadne-codegen[subscriptions]
 
 [test]
 codespell==2.4.2
-mypy==1.19.1
+mypy==1.20.0
 pre-commit==4.5.1
 pre-commit-hooks==6.0.0
 pytest==9.0.2
 pytest-asyncio==1.3.0
 pytest-cov==7.1.0
-ruff==0.15.7
+ruff==0.15.8

{deezer_python_gql-0.8.2 → deezer_python_gql-0.9.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "deezer-python-gql"
-version = "0.8.2"
+version = "0.9.0"
 description = "Async typed Python client for Deezer's Pipe GraphQL API."
 readme = "README.md"
 requires-python = ">=3.12"
@@ -23,13 +23,13 @@ text = "Apache-2.0"
 [project.optional-dependencies]
 test = [
     "codespell==2.4.2",
-    "mypy==1.19.1",
+    "mypy==1.20.0",
     "pre-commit==4.5.1",
     "pre-commit-hooks==6.0.0",
     "pytest==9.0.2",
     "pytest-asyncio==1.3.0",
     "pytest-cov==7.1.0",
-    "ruff==0.15.7",
+    "ruff==0.15.8",
 ]
 dev = [
     "ariadne-codegen[subscriptions]",