deezer-python 7.2.0__py3-none-any.whl → 7.3.0__py3-none-any.whl

deezer/asyncio/resources/track.py

@@ -0,0 +1,56 @@
+from __future__ import annotations
+
+import datetime as dt
+from typing import TYPE_CHECKING
+
+from deezer.dates import parse_date
+
+from .artist import AsyncArtist
+from .resource import AsyncResource
+
+if TYPE_CHECKING:
+    from .album import AsyncAlbum
+
+
+class AsyncTrack(AsyncResource):
+    """Async track resource."""
+
+    id: int
+    readable: bool
+    title: str
+    title_short: str
+    title_version: str
+    unseen: bool
+    isrc: str
+    link: str
+    share: str
+    duration: int
+    track_position: int
+    disk_number: int
+    rank: int
+    release_date: dt.date
+    explicit_lyrics: bool
+    explicit_content_lyrics: int
+    explicit_content_cover: int
+    preview: str
+    bpm: float
+    gain: float
+    available_countries: list[str]
+    alternative: AsyncTrack
+    contributors: list[AsyncArtist]
+    md5_image: str
+    artist: AsyncArtist
+    album: AsyncAlbum
+
+    _parse_release_date = staticmethod(parse_date)
+
+    def _parse_contributors(self, raw_value):
+        return [AsyncArtist(client=self.client, json=val) for val in raw_value]
+
+    async def get_artist(self) -> AsyncArtist:
+        """Get the artist of the Track."""
+        return await self.client.request("GET", f"artist/{self.artist.id}")
+
+    async def get_album(self) -> AsyncAlbum:
+        """Get the album of the Track."""
+        return await self.client.request("GET", f"album/{self.album.id}")

deezer/asyncio/resources/user.py

@@ -0,0 +1,110 @@
+from __future__ import annotations
+
+import datetime as dt
+from typing import TYPE_CHECKING
+
+from deezer.dates import parse_date
+from deezer.utils import get_id
+
+from .resource import AsyncResource
+
+if TYPE_CHECKING:
+    from deezer.asyncio.pagination import AsyncPaginatedList
+
+
+class AsyncUser(AsyncResource):
+    """Async user resource."""
+
+    id: int
+    name: str
+    lastname: str | None
+    firstname: str | None
+    email: str | None
+    status: int | None
+    birthday: dt.date | None
+    inscription_date: dt.date
+    gender: str | None
+    link: str
+    picture: str
+    picture_small: str
+    picture_medium: str
+    picture_big: str
+    picture_xl: str
+    country: str
+    lang: str | None
+    is_kid: bool | None
+    explicit_content_level: str | None
+    explicit_content_levels_available: list[str] | None
+    tracklist: str
+
+    _parse_birthday = staticmethod(parse_date)
+    _parse_inscription_date = staticmethod(parse_date)
+
+    async def get_albums(self, **kwargs) -> AsyncPaginatedList:
+        """Get user's favorite albums."""
+        return await self.get_paginated_list("albums", **kwargs)
+
+    async def add_album(self, album) -> bool:
+        """Add an album to user's favorite albums."""
+        return await self.post_relation("albums", params={"album_id": get_id(album)})
+
+    async def remove_album(self, album) -> bool:
+        """Remove an album from user's favorite albums."""
+        return await self.delete_relation("albums", params={"album_id": get_id(album)})
+
+    async def get_tracks(self, **kwargs) -> AsyncPaginatedList:
+        """Get user's favorite tracks."""
+        return await self.get_paginated_list("tracks", **kwargs)
+
+    async def add_track(self, track) -> bool:
+        """Add a track to user's favorite tracks."""
+        return await self.post_relation("tracks", params={"track_id": get_id(track)})
+
+    async def remove_track(self, track) -> bool:
+        """Remove a track from user's favorite tracks."""
+        return await self.delete_relation("tracks", params={"track_id": get_id(track)})
+
+    async def get_artists(self, **kwargs) -> AsyncPaginatedList:
+        """Get user's favorite artists."""
+        return await self.get_paginated_list("artists", **kwargs)
+
+    async def add_artist(self, artist) -> bool:
+        """Add an artist to user's favorite artists."""
+        return await self.post_relation("artists", params={"artist_id": get_id(artist)})
+
+    async def remove_artist(self, artist) -> bool:
+        """Remove an artist from user's favorite artists."""
+        return await self.delete_relation("artists", params={"artist_id": get_id(artist)})
+
+    async def get_followers(self, **kwargs) -> AsyncPaginatedList:
+        """Get user's followers."""
+        return await self.get_paginated_list("followers", **kwargs)
+
+    async def get_followings(self, **kwargs) -> AsyncPaginatedList:
+        """Get user's followings."""
+        return await self.get_paginated_list("followings", **kwargs)
+
+    async def follow(self, user) -> bool:
+        """Follow a user."""
+        return await self.post_relation("followings", params={"user_id": get_id(user)})
+
+    async def unfollow(self, user) -> bool:
+        """Unfollow a user."""
+        return await self.delete_relation("followings", params={"user_id": get_id(user)})
+
+    async def get_playlists(self, **kwargs) -> AsyncPaginatedList:
+        """Get user's public playlists."""
+        return await self.get_paginated_list("playlists", **kwargs)
+
+    async def add_playlist(self, playlist) -> bool:
+        """Add a playlist to user's public playlists."""
+        return await self.post_relation("playlists", params={"playlist_id": get_id(playlist)})
+
+    async def remove_playlist(self, playlist) -> bool:
+        """Remove a playlist from user's public playlists."""
+        return await self.delete_relation("playlists", params={"playlist_id": get_id(playlist)})
+
+    async def create_playlist(self, title: str) -> int:
+        """Create a playlist."""
+        result = await self.post_relation("playlists", params={"title": title})
+        return result.id

deezer/auth.py

@@ -16,7 +16,7 @@ class DeezerQueryAuth(httpx.Auth):
     def __init__(self, access_token: str):
         self.access_token = access_token
 
-    def auth_flow(self, request: httpx.Request) -> typing.Generator[httpx.Request, None, None]:
+    def auth_flow(self, request: httpx.Request) -> typing.Generator[httpx.Request, httpx.Response, None]:
         """
         Add authentication query parameter to the request.
 

deezer/client.py

@@ -1,15 +1,13 @@
 from __future__ import annotations
 
-from typing import Any, ClassVar
-
 import httpx
 from httpx._types import HeaderTypes
 
+from deezer._mixin import DeezerMixin
 from deezer.auth import DeezerQueryAuth
 from deezer.exceptions import (
     DeezerErrorResponse,
     DeezerHTTPError,
-    DeezerUnknownResource,
 )
 from deezer.pagination import PaginatedList
 from deezer.resources import (
@@ -28,7 +26,7 @@ from deezer.resources import (
 )
 
 
-class Client(httpx.Client):
+class Client(DeezerMixin, httpx.Client):
     """
     A client to retrieve some basic infos about Deezer resources.
 
@@ -51,22 +49,6 @@ class Client(httpx.Client):
     :param headers: a dictionary of headers to be used.
     """
 
-    objects_types: ClassVar[dict[str, type[Resource] | None]] = {
-        "album": Album,
-        "artist": Artist,
-        "chart": Chart,
-        "editorial": Editorial,
-        "episode": Episode,
-        # 'folder': None, # need identification
-        "genre": Genre,
-        "playlist": Playlist,
-        "podcast": Podcast,
-        "radio": Radio,
-        "search": None,
-        "track": Track,
-        "user": User,
-    }
-
     def __init__(
         self,
         access_token: str | None = None,
@@ -82,57 +64,7 @@ class Client(httpx.Client):
             headers=headers,
         )
 
-    def _process_json(
-        self,
-        item: dict[str, Any],
-        parent: Resource | None = None,
-        resource_type: type[Resource] | None = None,
-        resource_id: int | None = None,
-        paginate_list=False,
-    ):
-        """
-        Recursively convert dictionary to :class:`~deezer.Resource` object.
-
-        :param item: the JSON response as dict.
-        :param parent: A reference to the parent resource, to avoid fetching again.
-        :param resource_type: The resource class to use as top level.
-        :param resource_id: The resource id to use as top level.
-        :param paginate_list: Whether to wrap list into a pagination object.
-        :returns: instance of :class:`~deezer.Resource`
-        """
-        if "data" in item:
-            parsed_data = [self._process_json(i, parent, paginate_list=False) for i in item["data"]]
-            if not paginate_list:
-                return parsed_data
-            item["data"] = parsed_data
-            return item
-
-        result = {}
-        for key, value in item.items():
-            if isinstance(value, dict) and ("type" in value or "data" in value):
-                value = self._process_json(value, parent)
-            result[key] = value
-        if parent is not None:
-            result[parent.type] = parent
-
-        if "id" not in result and resource_id is not None:
-            result["id"] = resource_id
-
-        if "type" in result and result["type"] in self.objects_types:
-            object_class = self.objects_types[result["type"]]
-        elif "type" in result or (not resource_type and "id" in result):
-            # in case any new types are introduced by the API
-            object_class = Resource
-        elif resource_type:
-            object_class = resource_type
-        elif item.get("results") is True:
-            return True
-        else:
-            raise DeezerUnknownResource(f"Unable to find resource type for {result!r}")
-        assert object_class is not None  # noqa S101
-        return object_class(self, result)
-
-    def request(
+    def request(  # ty: ignore[invalid-method-override]
         self,
         method: str,
         path: str,

{deezer_python-7.2.0.dist-info → deezer_python-7.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deezer-python
-Version: 7.2.0
+Version: 7.3.0
 Summary: A friendly wrapper library for the Deezer API
 Author-email: Bruno Alla <alla.brunoo@gmail.com>
 License-Expression: MIT

deezer_python-7.3.0.dist-info/RECORD

@@ -0,0 +1,42 @@
+deezer/__init__.py,sha256=ydHiQL-4BdOfDFdLMQEbFMOxsn5WIncR2RKs4kjr6e8,556
+deezer/_mixin.py,sha256=Q5B96yjP2_jnlMp0VSmK038CH72bvd57YTGeU8xbLAo,2822
+deezer/auth.py,sha256=dtOC3_0tjtCPP8_5nFpsqDYDIsxfMlNW_0A2itQ9p5s,701
+deezer/client.py,sha256=SDKEeMG4NvzKOOxI5jtO7GueibmYCdhDXnUjOkS6w-8,22343
+deezer/dates.py,sha256=raTeUAAOkajl0TTzM2cupzieTY0amzTeZCaaT3gp_iU,648
+deezer/exceptions.py,sha256=fDLZ63QllqaTwX83cJm1czwEz39ysAcKPB4ie_rAhYI,2004
+deezer/pagination.py,sha256=iufsEnRqjXvtwWDLMnhf_Adptw1dvb8pk3dRsjTHnu8,4108
+deezer/utils.py,sha256=uXCAnEZR0ulro9lz3YHlwsMgjC1_6_twqDVzGgCuuhM,610
+deezer/asyncio/__init__.py,sha256=V42lzmLFsk5K3FpRyTFuz2n_BGpentYQ4ve5MojwzdI,634
+deezer/asyncio/client.py,sha256=C-TWu20XuOlbSqvhsKyP78eEewp3qOi4GmnsrLnuGBM,16299
+deezer/asyncio/pagination.py,sha256=TGKpx9VpRrrnC0ZA62jCZ81H9JZgfAVdqdhrg3AxgcQ,4943
+deezer/asyncio/resources/__init__.py,sha256=46roTlKPH6DpSRYWApuA54XNVMFuHFNgnNEEBHk2-P0,669
+deezer/asyncio/resources/album.py,sha256=0tJWBrk8jYJ3GQUlYvyCRlGx0HlsdmNEEf7jqQqHN_M,1620
+deezer/asyncio/resources/artist.py,sha256=MyebbObCP-HyJPqv5bas1m_nNfZjfsEp4GBxgVHoF_A,1433
+deezer/asyncio/resources/chart.py,sha256=hPWDSRPgOZC7Fx04TyVnsKkTkruS0L0_ifI6AjiLZtg,1169
+deezer/asyncio/resources/editorial.py,sha256=knyGIku3tPMQTo7csusBFXiqBQAHpZXcOP96vMUb-mg,977
+deezer/asyncio/resources/episode.py,sha256=icYxes7Aq4GAuoxw9R2dBz3Cz5F869pDezfgKjB7XHQ,1063
+deezer/asyncio/resources/genre.py,sha256=Zwli7xR1Wz6P0hSgC12lHVc_X698YRHA-mBCpN4WGB8,870
+deezer/asyncio/resources/playlist.py,sha256=YAX0Gur2TExjM0uipwVqcU6ldXCaqz2ZrkLKqwvDwlI,2042
+deezer/asyncio/resources/podcast.py,sha256=dlkcMcUlEvOGrmuzk16s8f1KGO8g9APO2cpbFKbF0hI,651
+deezer/asyncio/resources/radio.py,sha256=srNkXBvkf0kz0BHSLjQMV-vpEuAaGghgNl3mx5vhSPA,484
+deezer/asyncio/resources/resource.py,sha256=pz0g-mJwqg7Z_meSWgKF3Q73YK4GPUPcR8o2kzs8rIQ,3343
+deezer/asyncio/resources/track.py,sha256=QShZGIoVUIIqibyvKub9jZd7ThrfxXMYIYQ31NNBodk,1382
+deezer/asyncio/resources/user.py,sha256=0zfzMePsx9vHdStefHVNdCUSqz5MmZJ8g86tDrEAk2o,4095
+deezer/resources/__init__.py,sha256=WLHWGhV5rLyzZe9IjAtVWUsLvNJDWoldgE2JIADC0L4,549
+deezer/resources/album.py,sha256=83PXZNSSkxY7qVVgyvgyHceaV4IMoQxfqcbTR5v-l38,1734
+deezer/resources/artist.py,sha256=bWt4QmKK6Ywzc5JoekcSHpV7uysy_wM61bjKJMkZnBo,2239
+deezer/resources/chart.py,sha256=l4l5M7bYcW1-lFKZl874CGWi-gjOVBcskJ-zL5DMcXE,2193
+deezer/resources/editorial.py,sha256=eD2W9BctUSdUMo3VTMHEFkzGIRkvolLLz20ZD_pWclw,1373
+deezer/resources/episode.py,sha256=1dOBQeNQeKofO_HaMFCg-rKYaPxyqgIm2eMTw0RA-vk,1722
+deezer/resources/genre.py,sha256=CDWyNyFT3fXQM7jPkz3UtGr8gNtVn9430h11Jl0ZwAc,1355
+deezer/resources/playlist.py,sha256=lC06LGRTpJKWxsDJHnreaWFUhYuX_ssb44sAlQZYIKU,3242
+deezer/resources/podcast.py,sha256=FwfOe-m4xI1iRwauZpMjKzXKfLDryDz9Y5cVVzP8wVo,915
+deezer/resources/radio.py,sha256=moOdlSJABqCcluInvgbHSwIzSIhDvBQaVyDGdgeVr_0,805
+deezer/resources/resource.py,sha256=4ma_lH6S0ZljBQ24MNdOxotGJFL3rGThLSnea-RSweg,5259
+deezer/resources/track.py,sha256=e3DPTsYWq5yNCjMRQhGTrFQHfQUe3xn0mEVYbpL3O_0,1546
+deezer/resources/user.py,sha256=kCgMUEbKt1QJzzBEpYxPNM3IbojMlm1fYYTSgqa4Sug,6899
+deezer_python-7.3.0.dist-info/licenses/LICENSE.txt,sha256=lGqKEubFaPBoiJVRoHOxg1LYlte1e5kLoq6zWUSRQzQ,1054
+deezer_python-7.3.0.dist-info/METADATA,sha256=WAE62eDS85oKzo5OAUcMFIcon8b7nAPy2oAA2yLO8Bw,14059
+deezer_python-7.3.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+deezer_python-7.3.0.dist-info/top_level.txt,sha256=yEWpBI2w2sX3SpyAi-ZGzg-lpP8apYE6uEgvnnb7S44,7
+deezer_python-7.3.0.dist-info/RECORD,,

{deezer_python-7.2.0.dist-info → deezer_python-7.3.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (82.0.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

deezer_python-7.2.0.dist-info/RECORD

@@ -1,25 +0,0 @@
-deezer/__init__.py,sha256=aSzufMLPkXLHs04TaE7KpzQmcVfE9qRqG66U77RioUw,556
-deezer/auth.py,sha256=mKnPDiNBJKEq7Qo0CDu2kW_agviGpTdCbj_duFpYWco,691
-deezer/client.py,sha256=SmHZtjvd6F6okjoCF5tnkaoIDD_RzqztfbIeP6dyI3E,24782
-deezer/dates.py,sha256=raTeUAAOkajl0TTzM2cupzieTY0amzTeZCaaT3gp_iU,648
-deezer/exceptions.py,sha256=fDLZ63QllqaTwX83cJm1czwEz39ysAcKPB4ie_rAhYI,2004
-deezer/pagination.py,sha256=iufsEnRqjXvtwWDLMnhf_Adptw1dvb8pk3dRsjTHnu8,4108
-deezer/utils.py,sha256=uXCAnEZR0ulro9lz3YHlwsMgjC1_6_twqDVzGgCuuhM,610
-deezer/resources/__init__.py,sha256=WLHWGhV5rLyzZe9IjAtVWUsLvNJDWoldgE2JIADC0L4,549
-deezer/resources/album.py,sha256=83PXZNSSkxY7qVVgyvgyHceaV4IMoQxfqcbTR5v-l38,1734
-deezer/resources/artist.py,sha256=bWt4QmKK6Ywzc5JoekcSHpV7uysy_wM61bjKJMkZnBo,2239
-deezer/resources/chart.py,sha256=l4l5M7bYcW1-lFKZl874CGWi-gjOVBcskJ-zL5DMcXE,2193
-deezer/resources/editorial.py,sha256=eD2W9BctUSdUMo3VTMHEFkzGIRkvolLLz20ZD_pWclw,1373
-deezer/resources/episode.py,sha256=1dOBQeNQeKofO_HaMFCg-rKYaPxyqgIm2eMTw0RA-vk,1722
-deezer/resources/genre.py,sha256=CDWyNyFT3fXQM7jPkz3UtGr8gNtVn9430h11Jl0ZwAc,1355
-deezer/resources/playlist.py,sha256=lC06LGRTpJKWxsDJHnreaWFUhYuX_ssb44sAlQZYIKU,3242
-deezer/resources/podcast.py,sha256=FwfOe-m4xI1iRwauZpMjKzXKfLDryDz9Y5cVVzP8wVo,915
-deezer/resources/radio.py,sha256=moOdlSJABqCcluInvgbHSwIzSIhDvBQaVyDGdgeVr_0,805
-deezer/resources/resource.py,sha256=4ma_lH6S0ZljBQ24MNdOxotGJFL3rGThLSnea-RSweg,5259
-deezer/resources/track.py,sha256=e3DPTsYWq5yNCjMRQhGTrFQHfQUe3xn0mEVYbpL3O_0,1546
-deezer/resources/user.py,sha256=kCgMUEbKt1QJzzBEpYxPNM3IbojMlm1fYYTSgqa4Sug,6899
-deezer_python-7.2.0.dist-info/licenses/LICENSE.txt,sha256=lGqKEubFaPBoiJVRoHOxg1LYlte1e5kLoq6zWUSRQzQ,1054
-deezer_python-7.2.0.dist-info/METADATA,sha256=REeREdrSYkRozH2GQfcfwCjjBjkHHjPEmvE3cKnOGGc,14059
-deezer_python-7.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-deezer_python-7.2.0.dist-info/top_level.txt,sha256=yEWpBI2w2sX3SpyAi-ZGzg-lpP8apYE6uEgvnnb7S44,7
-deezer_python-7.2.0.dist-info/RECORD,,