deezer-python-gql 0.1.0__tar.gz → 0.3.0__tar.gz

{deezer_python_gql-0.1.0/deezer_python_gql.egg-info → deezer_python_gql-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deezer-python-gql
-Version: 0.1.0
+Version: 0.3.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
@@ -14,14 +14,14 @@ License-File: LICENSE
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: pydantic>=2.0.0
 Provides-Extra: test
-Requires-Dist: codespell==2.4.1; extra == "test"
+Requires-Dist: codespell==2.4.2; extra == "test"
 Requires-Dist: mypy==1.19.1; 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.0.0; extra == "test"
-Requires-Dist: ruff==0.15.1; extra == "test"
+Requires-Dist: pytest-cov==7.1.0; extra == "test"
+Requires-Dist: ruff==0.15.7; extra == "test"
 Provides-Extra: dev
 Requires-Dist: ariadne-codegen[subscriptions]; extra == "dev"
 Dynamic: license-file
@@ -79,14 +79,26 @@ asyncio.run(main())
 
 ## Available Queries
 
-| Method                      | Description                                                   |
-| --------------------------- | ------------------------------------------------------------- |
-| `get_me()`                  | Current authenticated user                                    |
-| `get_track(track_id)`       | Full track details — ISRC, media tokens, lyrics, contributors |
-| `get_album(album_id)`       | Album with cover, label, paginated tracks, fallback           |
-| `get_artist(artist_id)`     | Artist with bio, top tracks, albums (ordered by release date) |
-| `get_playlist(playlist_id)` | Playlist with owner, picture, paginated tracks                |
-| `search(query, ...)`        | Unified search across tracks, albums, artists, playlists      |
+| Method                                           | Description                                                   |
+| ------------------------------------------------ | ------------------------------------------------------------- |
+| `get_me()`                                       | Current authenticated user                                    |
+| `get_track(track_id)`                            | Full track details — ISRC, media tokens, lyrics, contributors |
+| `get_album(album_id)`                            | Album with cover, label, paginated tracks, fallback           |
+| `get_artist(artist_id)`                          | Artist with bio, top tracks, albums (ordered by release date) |
+| `get_playlist(playlist_id)`                      | Playlist with owner, picture, paginated tracks                |
+| `search(query, ...)`                             | Unified search across tracks, albums, artists, playlists      |
+| `get_flow()`                                     | User's default Flow with tracks                               |
+| `get_flow_configs(moods_first, genres_first)`    | Mood & genre flow config lists for discovery                  |
+| `get_flow_config_tracks(flow_config_id)`         | Tracks for a specific mood/genre flow config                  |
+| `get_made_for_me(first)`                         | "Made For You" SmartTracklist & Flow items                    |
+| `get_smart_tracklist(smart_tracklist_id, first)` | Smart tracklist with paginated tracks                         |
+| `get_charts(country_code, ...)`                  | Country charts — tracks, albums, artists, playlists           |
+| `get_recommendations(playlists_first, ...)`      | Personalized recommendations across categories                |
+| `get_recently_played(first)`                     | Recently played mixed content (albums, playlists, artists...) |
+| `get_favorite_artists(first, after)`             | Paginated favorite artists                                    |
+| `get_favorite_albums(first, after)`              | Paginated favorite albums                                     |
+| `get_favorite_tracks(first, after)`              | Paginated favorite tracks                                     |
+| `get_favorite_playlists(first, after)`           | Paginated favorite playlists                                  |
 
 All methods return fully-typed Pydantic models generated from the GraphQL schema.
 

{deezer_python_gql-0.1.0 → deezer_python_gql-0.3.0}/README.md

@@ -51,14 +51,26 @@ asyncio.run(main())
 
 ## Available Queries
 
-| Method                      | Description                                                   |
-| --------------------------- | ------------------------------------------------------------- |
-| `get_me()`                  | Current authenticated user                                    |
-| `get_track(track_id)`       | Full track details — ISRC, media tokens, lyrics, contributors |
-| `get_album(album_id)`       | Album with cover, label, paginated tracks, fallback           |
-| `get_artist(artist_id)`     | Artist with bio, top tracks, albums (ordered by release date) |
-| `get_playlist(playlist_id)` | Playlist with owner, picture, paginated tracks                |
-| `search(query, ...)`        | Unified search across tracks, albums, artists, playlists      |
+| Method                                           | Description                                                   |
+| ------------------------------------------------ | ------------------------------------------------------------- |
+| `get_me()`                                       | Current authenticated user                                    |
+| `get_track(track_id)`                            | Full track details — ISRC, media tokens, lyrics, contributors |
+| `get_album(album_id)`                            | Album with cover, label, paginated tracks, fallback           |
+| `get_artist(artist_id)`                          | Artist with bio, top tracks, albums (ordered by release date) |
+| `get_playlist(playlist_id)`                      | Playlist with owner, picture, paginated tracks                |
+| `search(query, ...)`                             | Unified search across tracks, albums, artists, playlists      |
+| `get_flow()`                                     | User's default Flow with tracks                               |
+| `get_flow_configs(moods_first, genres_first)`    | Mood & genre flow config lists for discovery                  |
+| `get_flow_config_tracks(flow_config_id)`         | Tracks for a specific mood/genre flow config                  |
+| `get_made_for_me(first)`                         | "Made For You" SmartTracklist & Flow items                    |
+| `get_smart_tracklist(smart_tracklist_id, first)` | Smart tracklist with paginated tracks                         |
+| `get_charts(country_code, ...)`                  | Country charts — tracks, albums, artists, playlists           |
+| `get_recommendations(playlists_first, ...)`      | Personalized recommendations across categories                |
+| `get_recently_played(first)`                     | Recently played mixed content (albums, playlists, artists...) |
+| `get_favorite_artists(first, after)`             | Paginated favorite artists                                    |
+| `get_favorite_albums(first, after)`              | Paginated favorite albums                                     |
+| `get_favorite_tracks(first, after)`              | Paginated favorite tracks                                     |
+| `get_favorite_playlists(first, after)`           | Paginated favorite playlists                                  |
 
 All methods return fully-typed Pydantic models generated from the GraphQL schema.
 

{deezer_python_gql-0.1.0 → deezer_python_gql-0.3.0}/deezer_python_gql/base_client.py

@@ -3,12 +3,15 @@
 from __future__ import annotations
 
 import json
+import logging
 import time
 from base64 import urlsafe_b64decode
-from typing import Any, cast
+from typing import Any, ClassVar, cast
 
 import httpx
 
+logger = logging.getLogger(__name__)
+
 
 class GraphQLClientError(Exception):
     """Base exception for GraphQL client errors."""
@@ -110,6 +113,7 @@ class DeezerBaseClient:
         :param variables: Optional query variables.
         :param kwargs: Additional keyword arguments passed to httpx.
         """
+        logger.debug("GQL execute: %s (variables=%s)", operation_name or "<unnamed>", variables)
         jwt = await self._ensure_jwt()
 
         headers: dict[str, str] = kwargs.pop("headers", None) or {}
@@ -120,16 +124,29 @@ class DeezerBaseClient:
         if operation_name:
             payload["operationName"] = operation_name
         if variables:
-            payload["variables"] = variables
+            # Filter out UNSET sentinel values that are not JSON-serializable.
+            # Inline import avoids depending on generated code at module level.
+            from deezer_python_gql.generated.base_model import UnsetType  # noqa: PLC0415
+
+            payload["variables"] = {
+                k: v for k, v in variables.items() if not isinstance(v, UnsetType)
+            }
 
         client = self._http_client or httpx.AsyncClient()
         try:
-            return await client.post(
+            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()
@@ -159,10 +176,52 @@ class DeezerBaseClient:
         errors = response_json.get("errors")
 
         if errors:
-            raise GraphQLClientGraphQLMultiError.from_errors_dicts(errors_dicts=errors, data=data)
+            if data:
+                # Partial success — some items failed (e.g. deleted albums in favorites).
+                # Log the errors but return the valid data.
+                logger.warning(
+                    "GraphQL response contained %d error(s): %s",
+                    len(errors),
+                    [e.get("message", "Unknown error") for e in errors],
+                )
+            else:
+                raise GraphQLClientGraphQLMultiError.from_errors_dicts(
+                    errors_dicts=errors, data=data
+                )
+
+        # The Deezer API omits __typename for single-member union types
+        # (e.g. Contributor = Artist). Pydantic discriminated unions require it,
+        # so we inject the missing field before model validation.
+        self._inject_missing_typenames(data)
 
         return cast("dict[str, Any]", data)
 
+    # Map of parent key → child key → __typename value for single-member unions
+    # where the Deezer API omits the discriminator.
+    _TYPENAME_PATCHES: ClassVar[dict[str, dict[str, str]]] = {
+        "contributors": {"node": "Artist"},
+    }
+
+    @classmethod
+    def _inject_missing_typenames(cls, obj: Any) -> None:
+        """Recursively inject __typename into nodes where the API omits it."""
+        if isinstance(obj, dict):
+            for parent_key, patches in cls._TYPENAME_PATCHES.items():
+                if parent_key in obj:
+                    container = obj[parent_key]
+                    if isinstance(container, dict) and "edges" in container:
+                        for edge in container["edges"]:
+                            if isinstance(edge, dict):
+                                for child_key, typename in patches.items():
+                                    node = edge.get(child_key)
+                                    if isinstance(node, dict) and "__typename" not in node:
+                                        node["__typename"] = typename
+            for value in obj.values():
+                cls._inject_missing_typenames(value)
+        elif isinstance(obj, list):
+            for item in obj:
+                cls._inject_missing_typenames(item)
+
     async def _ensure_jwt(self) -> str:
         """Acquire or refresh the JWT token from ARL cookie.
 
@@ -174,6 +233,7 @@ class DeezerBaseClient:
         if self._jwt and now < (self._jwt_expires_at - self.JWT_REFRESH_MARGIN_SECONDS):
             return self._jwt
 
+        logger.debug("JWT expired or missing, refreshing from ARL")
         params = {"jo": "p", "rto": "c", "i": "c"}
 
         async with httpx.AsyncClient() as http:
@@ -194,5 +254,6 @@ class DeezerBaseClient:
         padded = payload_segment + "=" * (-len(payload_segment) % 4)
         payload = json.loads(urlsafe_b64decode(padded))
         self._jwt_expires_at = float(payload["exp"])
+        logger.debug("JWT acquired, expires at %s", self._jwt_expires_at)
 
         return self._jwt

{deezer_python_gql-0.1.0 → deezer_python_gql-0.3.0/deezer_python_gql.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deezer-python-gql
-Version: 0.1.0
+Version: 0.3.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
@@ -14,14 +14,14 @@ License-File: LICENSE
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: pydantic>=2.0.0
 Provides-Extra: test
-Requires-Dist: codespell==2.4.1; extra == "test"
+Requires-Dist: codespell==2.4.2; extra == "test"
 Requires-Dist: mypy==1.19.1; 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.0.0; extra == "test"
-Requires-Dist: ruff==0.15.1; extra == "test"
+Requires-Dist: pytest-cov==7.1.0; extra == "test"
+Requires-Dist: ruff==0.15.7; extra == "test"
 Provides-Extra: dev
 Requires-Dist: ariadne-codegen[subscriptions]; extra == "dev"
 Dynamic: license-file
@@ -79,14 +79,26 @@ asyncio.run(main())
 
 ## Available Queries
 
-| Method                      | Description                                                   |
-| --------------------------- | ------------------------------------------------------------- |
-| `get_me()`                  | Current authenticated user                                    |
-| `get_track(track_id)`       | Full track details — ISRC, media tokens, lyrics, contributors |
-| `get_album(album_id)`       | Album with cover, label, paginated tracks, fallback           |
-| `get_artist(artist_id)`     | Artist with bio, top tracks, albums (ordered by release date) |
-| `get_playlist(playlist_id)` | Playlist with owner, picture, paginated tracks                |
-| `search(query, ...)`        | Unified search across tracks, albums, artists, playlists      |
+| Method                                           | Description                                                   |
+| ------------------------------------------------ | ------------------------------------------------------------- |
+| `get_me()`                                       | Current authenticated user                                    |
+| `get_track(track_id)`                            | Full track details — ISRC, media tokens, lyrics, contributors |
+| `get_album(album_id)`                            | Album with cover, label, paginated tracks, fallback           |
+| `get_artist(artist_id)`                          | Artist with bio, top tracks, albums (ordered by release date) |
+| `get_playlist(playlist_id)`                      | Playlist with owner, picture, paginated tracks                |
+| `search(query, ...)`                             | Unified search across tracks, albums, artists, playlists      |
+| `get_flow()`                                     | User's default Flow with tracks                               |
+| `get_flow_configs(moods_first, genres_first)`    | Mood & genre flow config lists for discovery                  |
+| `get_flow_config_tracks(flow_config_id)`         | Tracks for a specific mood/genre flow config                  |
+| `get_made_for_me(first)`                         | "Made For You" SmartTracklist & Flow items                    |
+| `get_smart_tracklist(smart_tracklist_id, first)` | Smart tracklist with paginated tracks                         |
+| `get_charts(country_code, ...)`                  | Country charts — tracks, albums, artists, playlists           |
+| `get_recommendations(playlists_first, ...)`      | Personalized recommendations across categories                |
+| `get_recently_played(first)`                     | Recently played mixed content (albums, playlists, artists...) |
+| `get_favorite_artists(first, after)`             | Paginated favorite artists                                    |
+| `get_favorite_albums(first, after)`              | Paginated favorite albums                                     |
+| `get_favorite_tracks(first, after)`              | Paginated favorite tracks                                     |
+| `get_favorite_playlists(first, after)`           | Paginated favorite playlists                                  |
 
 All methods return fully-typed Pydantic models generated from the GraphQL schema.
 

{deezer_python_gql-0.1.0 → deezer_python_gql-0.3.0}/deezer_python_gql.egg-info/requires.txt

@@ -5,11 +5,11 @@ pydantic>=2.0.0
 ariadne-codegen[subscriptions]
 
 [test]
-codespell==2.4.1
+codespell==2.4.2
 mypy==1.19.1
 pre-commit==4.5.1
 pre-commit-hooks==6.0.0
 pytest==9.0.2
 pytest-asyncio==1.3.0
-pytest-cov==7.0.0
-ruff==0.15.1
+pytest-cov==7.1.0
+ruff==0.15.7

{deezer_python_gql-0.1.0 → deezer_python_gql-0.3.0}/pyproject.toml

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