deezer-python-gql 0.6.0__tar.gz → 0.7.0__tar.gz

{deezer_python_gql-0.6.0/deezer_python_gql.egg-info → deezer_python_gql-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deezer-python-gql
-Version: 0.6.0
+Version: 0.7.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
@@ -184,6 +184,12 @@ asyncio.run(main())
 | `music_together_update_group_settings(...)`       | Update group settings (name, family mode)   |
 | `music_together_generate_group_name()`            | Generate a random group name                |
 
+### Utilities
+
+| Method                           | Description                                                      |
+| -------------------------------- | ---------------------------------------------------------------- |
+| `check_audiobook_ids(album_ids)` | Batch-check which album IDs are audiobooks (single GraphQL call) |
+
 All methods return fully-typed Pydantic models generated from the GraphQL schema.
 
 ## Development

{deezer_python_gql-0.6.0 → deezer_python_gql-0.7.0}/README.md

@@ -156,6 +156,12 @@ asyncio.run(main())
 | `music_together_update_group_settings(...)`       | Update group settings (name, family mode)   |
 | `music_together_generate_group_name()`            | Generate a random group name                |
 
+### Utilities
+
+| Method                           | Description                                                      |
+| -------------------------------- | ---------------------------------------------------------------- |
+| `check_audiobook_ids(album_ids)` | Batch-check which album IDs are audiobooks (single GraphQL call) |
+
 All methods return fully-typed Pydantic models generated from the GraphQL schema.
 
 ## Development

{deezer_python_gql-0.6.0 → deezer_python_gql-0.7.0}/deezer_python_gql/base_client.py

@@ -257,3 +257,35 @@ class DeezerBaseClient:
         logger.debug("JWT acquired, expires at %s", self._jwt_expires_at)
 
         return self._jwt
+
+    async def check_audiobook_ids(self, album_ids: list[str]) -> set[str]:
+        """Check which album IDs are also valid audiobooks on Deezer.
+
+        Uses GraphQL aliases to batch-check many IDs in a single request.
+        Returns the subset of IDs that are audiobooks (i.e., the audiobook
+        query returns non-null for them).
+
+        :param album_ids: List of Deezer album/audiobook IDs to check.
+        """
+        if not album_ids:
+            return set()
+
+        # Query displayTitle alongside id — querying only { id } echoes back the
+        # input without validating that the ID is actually an audiobook.
+        parts = [
+            f'a{i}: audiobook(audiobookId: "{aid}") {{ id displayTitle }}'
+            for i, aid in enumerate(album_ids)
+        ]
+        query = "{ " + " ".join(parts) + " }"
+
+        resp = await self.execute(query)
+        data = self.get_data(resp)
+
+        audiobook_ids: set[str] = set()
+        for i, aid in enumerate(album_ids):
+            node = data.get(f"a{i}")
+            # The API echoes back {id} for any valid album, so we must check
+            # a real audiobook field like displayTitle to distinguish.
+            if node is not None and node.get("displayTitle") is not None:
+                audiobook_ids.add(aid)
+        return audiobook_ids

{deezer_python_gql-0.6.0 → deezer_python_gql-0.7.0/deezer_python_gql.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deezer-python-gql
-Version: 0.6.0
+Version: 0.7.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
@@ -184,6 +184,12 @@ asyncio.run(main())
 | `music_together_update_group_settings(...)`       | Update group settings (name, family mode)   |
 | `music_together_generate_group_name()`            | Generate a random group name                |
 
+### Utilities
+
+| Method                           | Description                                                      |
+| -------------------------------- | ---------------------------------------------------------------- |
+| `check_audiobook_ids(album_ids)` | Batch-check which album IDs are audiobooks (single GraphQL call) |
+
 All methods return fully-typed Pydantic models generated from the GraphQL schema.
 
 ## Development

{deezer_python_gql-0.6.0 → deezer_python_gql-0.7.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "deezer-python-gql"
-version = "0.6.0"
+version = "0.7.0"
 description = "Async typed Python client for Deezer's Pipe GraphQL API."
 readme = "README.md"
 requires-python = ">=3.12"

{deezer_python_gql-0.6.0 → deezer_python_gql-0.7.0}/tests/test_client.py

@@ -67,6 +67,9 @@ from deezer_python_gql.generated.get_podcast_episode import GetPodcastEpisode
 from deezer_python_gql.generated.get_podcast_episode_bookmarks import (
     GetPodcastEpisodeBookmarks,
 )
+from deezer_python_gql.generated.get_podcast_episodes_by_ids import (
+    GetPodcastEpisodesByIds,
+)
 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_tracks import GetSimilarTracks
@@ -209,6 +212,7 @@ def test_client_has_generated_methods() -> None:
         "remove_tracks_from_playlist",
         "get_podcast",
         "get_podcast_episode",
+        "get_podcast_episodes_by_ids",
         "get_favorite_podcasts",
         "get_podcast_episode_bookmarks",
         "add_podcast_to_favorite",
@@ -467,7 +471,51 @@ def test_get_data_returns_data_on_success() -> None:
 
 
 # ---------------------------------------------------------------------------
-# 4. Model smoke tests (one per query — fixture-based)
+# 4a. check_audiobook_ids tests
+# ---------------------------------------------------------------------------
+
+
+@pytest.mark.asyncio
+async def test_check_audiobook_ids_returns_matching() -> None:
+    """Verify check_audiobook_ids returns IDs that are valid audiobooks."""
+    client = DeezerBaseClient(arl="test_arl")
+    client._jwt = _make_jwt(exp=time.time() + 600)  # noqa: SLF001
+    client._jwt_expires_at = time.time() + 600  # noqa: SLF001
+
+    # a0 is an audiobook (has displayTitle), a1 is not (displayTitle is null)
+    gql_response = httpx.Response(
+        200,
+        json={
+            "data": {
+                "a0": {"id": "111", "displayTitle": "Test Book"},
+                "a1": {"id": "222", "displayTitle": None},
+            }
+        },
+        request=httpx.Request("POST", DeezerBaseClient.PIPE_URL),
+    )
+
+    with patch("deezer_python_gql.base_client.httpx.AsyncClient") as mock_client_cls:
+        mock_instance = AsyncMock()
+        mock_instance.post = AsyncMock(return_value=gql_response)
+        mock_instance.__aenter__ = AsyncMock(return_value=mock_instance)
+        mock_instance.__aexit__ = AsyncMock(return_value=False)
+        mock_client_cls.return_value = mock_instance
+
+        result = await client.check_audiobook_ids(["111", "222"])
+
+    assert result == {"111"}
+
+
+@pytest.mark.asyncio
+async def test_check_audiobook_ids_empty_input() -> None:
+    """Verify check_audiobook_ids returns empty set for empty input."""
+    client = DeezerBaseClient(arl="test_arl")
+    result = await client.check_audiobook_ids([])
+    assert result == set()
+
+
+# ---------------------------------------------------------------------------
+# 5. Model smoke tests (one per query — fixture-based)
 # ---------------------------------------------------------------------------
 
 
@@ -995,6 +1043,20 @@ def test_smoke_get_podcast_episode() -> None:
     assert ep.podcast.display_title == "Tech Weekly"
 
 
+def test_smoke_get_podcast_episodes_by_ids() -> None:
+    """Verify GetPodcastEpisodesByIds fixture parses with nullable entries."""
+    data = _load_fixture("get_podcast_episodes_by_ids.json")
+    episodes = GetPodcastEpisodesByIds.model_validate(data).podcast_episodes_by_ids
+    assert len(episodes) == 3
+    assert episodes[0] is not None
+    assert episodes[0].id == "ep_100"
+    assert episodes[0].title == "Episode 100: AI Revolution"
+    assert episodes[0].duration == 2400
+    assert episodes[1] is not None
+    assert episodes[1].id == "ep_099"
+    assert episodes[2] is None
+
+
 def test_smoke_get_favorite_podcasts() -> None:
     """Verify GetFavoritePodcasts fixture parses with pagination."""
     data = _load_fixture("get_favorite_podcasts.json")