feat: add User.add_artist method

src/deezer/resources/user.py

@@ -111,6 +111,15 @@ def get_artists(self, **kwargs) -> PaginatedList[Artist]:
         """
         return self.get_paginated_list("artists", **kwargs)
 
+    def add_artist(self, artist: Artist | int):
+        """
+        Add an artist to user's favorite artists.
+
+        :param artist: an :class:`~deezer.Artist` instance or its ID
+        :returns: a boolean that tells if the operation was successful
+        """
+        return self.post_relation("artists", artist_id=get_id(artist))
+
     def get_followers(self, **kwargs) -> PaginatedList[User]:
         """
         Get user's followers.

tests/resources/cassettes/TestUser.test_add_artist_id.yaml

@@ -0,0 +1,56 @@
+interactions:
+  - request:
+      body: null
+      headers:
+        Accept:
+          - "*/*"
+        Accept-Encoding:
+          - identity
+        Connection:
+          - keep-alive
+        Content-Length:
+          - "0"
+        User-Agent:
+          - python-requests/2.30.0
+      method: POST
+      uri: https://api.deezer.com/user/me/artists?access_token=dummy&artist_id=27
+    response:
+      body:
+        string: "true"
+      headers:
+        Access-Control-Allow-Credentials:
+          - "true"
+        Access-Control-Allow-Headers:
+          - X-Requested-With, Content-Type, Authorization, Origin, Accept, Accept-Encoding
+        Access-Control-Allow-Methods:
+          - POST, GET, OPTIONS, DELETE, PUT
+        Access-Control-Expose-Headers:
+          - Location
+        Access-Control-Max-Age:
+          - "86400"
+        Cache-Control:
+          - no-store, no-cache, must-revalidate
+        Connection:
+          - keep-alive
+        Content-Length:
+          - "4"
+        Content-Type:
+          - application/json; charset=utf-8
+        Expires:
+          - Thu, 19 Nov 1981 08:52:00 GMT
+        Pragma:
+          - no-cache
+        Server:
+          - Apache
+        Strict-Transport-Security:
+          - max-age=31536000; includeSubDomains
+        X-Content-Type-Options:
+          - nosniff
+        X-Host:
+          - blm-web-200
+        x-org:
+          - FR
+      status:
+        code: 200
+        message: OK
+version: 1

tests/resources/cassettes/TestUser.test_add_artist_obj.yaml

@@ -0,0 +1,56 @@
+interactions:
+  - request:
+      body: null
+      headers:
+        Accept:
+          - "*/*"
+        Accept-Encoding:
+          - identity
+        Connection:
+          - keep-alive
+        Content-Length:
+          - "0"
+        User-Agent:
+          - python-requests/2.30.0
+      method: POST
+      uri: https://api.deezer.com/user/me/artists?access_token=dummy&artist_id=27
+    response:
+      body:
+        string: "true"
+      headers:
+        Access-Control-Allow-Credentials:
+          - "true"
+        Access-Control-Allow-Headers:
+          - X-Requested-With, Content-Type, Authorization, Origin, Accept, Accept-Encoding
+        Access-Control-Allow-Methods:
+          - POST, GET, OPTIONS, DELETE, PUT
+        Access-Control-Expose-Headers:
+          - Location
+        Access-Control-Max-Age:
+          - "86400"
+        Cache-Control:
+          - no-store, no-cache, must-revalidate
+        Connection:
+          - keep-alive
+        Content-Length:
+          - "4"
+        Content-Type:
+          - application/json; charset=utf-8
+        Expires:
+          - Thu, 19 Nov 1981 08:52:00 GMT
+        Pragma:
+          - no-cache
+        Server:
+          - Apache
+        Strict-Transport-Security:
+          - max-age=31536000; includeSubDomains
+        X-Content-Type-Options:
+          - nosniff
+        X-Host:
+          - blm-web-174
+        x-org:
+          - FR
+      status:
+        code: 200
+        message: OK
+version: 1

tests/resources/test_user.py

@@ -101,3 +101,13 @@ def test_remove_track_obj(self, current_user: deezer.User):
             json={"id": 3135556, "type": "track"},
         )
         assert current_user.remove_track(track) is True
+
+    def test_add_artist_id(self, current_user: deezer.User):
+        assert current_user.add_artist(27) is True
+
+    def test_add_artist_obj(self, current_user: deezer.User):
+        artist = deezer.Artist(
+            current_user.client,
+            json={"id": 27, "type": "artist"},
+        )
+        assert current_user.add_artist(artist) is True