spotifywebapiPython 1.0.106__py3-none-any.whl → 1.0.109__py3-none-any.whl

spotifywebapipython/models/playlistsimplified.py

@@ -162,12 +162,10 @@ class PlaylistSimplified:
     @property
     def ImageUrl(self) -> str:
         """
-        Gets the first image url in the `Images` list, if images are defined;
-        otherwise, null.
+        Returns the highest resolution order image from the `Images` list, if images 
+        are defined; otherwise, null.
         """
-        if len(self._Images) > 0:
-            return self._Images[0].Url
-        return None
+        return ImageObject.GetImageHighestResolution(self._Images)
             
         
     @property

spotifywebapipython/models/showsimplified.py

@@ -184,10 +184,8 @@ class ShowSimplified:
         Gets the first image url in the `Images` list, if images are defined;
         otherwise, null.
         """
-        if len(self._Images) > 0:
-            return self._Images[0].Url
-        return None
-            
+        return ImageObject.GetImageHighestResolution(self._Images)
+    
         
     @property
     def IsExternallyHosted(self) -> bool:

spotifywebapipython/models/spotifyconnectdevices.py

@@ -117,6 +117,20 @@ class SpotifyConnectDevices():
         info.Status = 101
         info.StatusString = 'OK'
         
+        # populate brand info for popular devices.
+        if (device.Name == "Web Player (Chrome)"):
+            info.BrandDisplayName = 'Google'
+            info.ModelDisplayName = 'Chrome'
+            info.ProductId = 'Web Player'
+        elif (device.Name == "Web Player (Microsoft Edge)"):
+            info.BrandDisplayName = 'Microsoft'
+            info.ModelDisplayName = 'Edge'
+            info.ProductId = 'Web Player'
+        else:
+            info.BrandDisplayName = 'unknown'
+            info.ModelDisplayName = 'unknown'
+            info.ProductId = 'unknown'
+        
         # add the device.
         scDevice:SpotifyConnectDevice = SpotifyConnectDevice()
         scDevice.Id = info.DeviceId

spotifywebapipython/models/userprofilesimplified.py

@@ -132,12 +132,10 @@ class UserProfileSimplified:
     @property
     def ImageUrl(self) -> str:
         """
-        Gets the first image url in the `Images` list, if images are defined;
-        otherwise, null.
+        Returns the highest resolution order image from the `Images` list, if images 
+        are defined; otherwise, null.
         """
-        if len(self._Images) > 0:
-            return self._Images[0].Url
-        return None
+        return ImageObject.GetImageHighestResolution(self._Images)
             
         
     @property

spotifywebapipython/spotifyclient.py

@@ -1622,12 +1622,13 @@ class SpotifyClient:
             _logsi.LeaveMethod(SILevel.Debug, apiMethodName)
 
 
-    def CheckPlaylistFollowers(self, 
-                               playlistId:str,
-                               userIds:str
-                               ) -> dict:
+    def CheckPlaylistFollowers(
+            self, 
+            playlistId:str,
+            userIds:str=None,
+            ) -> dict:
         """
-        Check to see if one or more Spotify users are following a specified playlist.
+        Check to see if the current user is following a specified playlist.
         
         Args:
             playlistId (str):  
@@ -1637,9 +1638,10 @@ class SpotifyClient:
                 A comma-separated list of Spotify User ID's to check.  
                 Maximum: 5 ID's.  
                 Example: `1kWUud3vY5ij5r62zxpTRy,2takcwOaAZWiXQijPHIx7B`  
+                Deprecated - A single item list containing current user's Spotify Username; Maximum of 1 id.
                 
         Returns:
-            A dictionary of the userIds, along with a boolean status for each that indicates 
+            Array of boolean, containing a single boolean status that indicates 
             if the user follows the playlist (True) or not (False).
                 
         Raises:
@@ -1648,6 +1650,11 @@ class SpotifyClient:
                 and the response contains error information.
             SpotifApiError: 
                 If the method fails for any other reason.
+                
+        As of (at least) 2024/10/07, Spotify has deprecated the userId's argument; 
+        only current user can be tested.  Any other id's specified on this argument will 
+        generate a `400 Bad Request` error.
+                
 
         <details>
           <summary>Sample Code</summary>
@@ -1667,6 +1674,10 @@ class SpotifyClient:
             apiMethodParms.AppendKeyValue("playlistId", playlistId)
             apiMethodParms.AppendKeyValue("userIds", userIds)
             _logsi.LogMethodParmList(SILevel.Verbose, "Check to see if users are following a playlist", apiMethodParms)
+
+            # validations.
+            if (userIds is None):
+                userIds = self.UserProfile.Id
                 
             # build spotify web api request parameters.
             urlParms:dict = \
@@ -4265,7 +4276,7 @@ class SpotifyClient:
                 Default: None (disabled)
                 
         Returns:
-            A `ChapterPageSimplified` object that contains simplified track information for the audiobookId.
+            A `ChapterPageSimplified` object that contains simplified chapter information for the audiobook Id.
                 
         Raises:
             SpotifyWebApiError: 
@@ -7653,7 +7664,7 @@ class SpotifyClient:
                 Default: None (disabled)
                 
         Returns:
-            A `Playlist` object that contains the playlist details.
+            A `PlaylistPage` object that contains the playlist items.
                 
         Raises:
             SpotifyWebApiError: 
@@ -12627,9 +12638,10 @@ class SpotifyClient:
             _logsi.LeaveMethod(SILevel.Debug, apiMethodName)
 
 
-    def RemovePlaylist(self, 
-                       playlistId:str, 
-                       ) -> None:
+    def RemovePlaylist(
+            self, 
+            playlistId:str=None, 
+            ) -> None:
         """
         Remove a user's playlist (calls the `UnfollowPlaylist` method).
         
@@ -12638,9 +12650,8 @@ class SpotifyClient:
         Args:
         
             playlistId (str):  
-                The Spotify ID of the playlist.
-                Example: `5AC9ZXA7nJ7oGWO911FuDG`
-                
+                The Spotify ID of the playlist (e.g. `5AC9ZXA7nJ7oGWO911FuDG`).
+                If null, the currently playing playlist uri id value is used.
         Raises:
             SpotifyWebApiError: 
                 If the Spotify Web API request was for a non-authorization service 
@@ -12860,22 +12871,20 @@ class SpotifyClient:
                 else:
                     raise SpotifyApiError(SAAppMessages.ARGUMENT_REQUIRED_ERROR % (apiMethodName, 'ids'), logsi=_logsi)
 
-            # build a list of all item id's.
             # remove any leading / trailing spaces in case user put a space between the items.
-            arrIds:list[str] = ids.split(',')
-            for idx in range(0, len(arrIds)):
-                arrIds[idx] = arrIds[idx].strip()
+            if (ids is not None):
+                ids = ids.replace(" ","")
                 
             # build spotify web api request parameters.
-            reqData:dict = \
+            urlParms:dict = \
             {
-                'ids': arrIds
+                'ids': ids
             }
 
             # execute spotify web api request.
             msg:SpotifyApiMessage = SpotifyApiMessage(apiMethodName, '/me/shows')
             msg.RequestHeaders[self.AuthToken.HeaderKey] = self.AuthToken.HeaderValue
-            msg.RequestJson = reqData
+            msg.UrlParameters = urlParms
             self.MakeRequest('DELETE', msg)
             
             # process results.
@@ -13511,22 +13520,20 @@ class SpotifyClient:
                 else:
                     raise SpotifyApiError(SAAppMessages.ARGUMENT_REQUIRED_ERROR % (apiMethodName, 'ids'), logsi=_logsi)
 
-            # build a list of all item id's.
             # remove any leading / trailing spaces in case user put a space between the items.
-            arrIds:list[str] = ids.split(',')
-            for idx in range(0, len(arrIds)):
-                arrIds[idx] = arrIds[idx].strip()
+            if (ids is not None):
+                ids = ids.replace(" ","")
                 
             # build spotify web api request parameters.
-            reqData:dict = \
+            urlParms:dict = \
             {
-                'ids': arrIds
+                'ids': ids
             }
 
             # execute spotify web api request.
             msg:SpotifyApiMessage = SpotifyApiMessage(apiMethodName, '/me/shows')
             msg.RequestHeaders[self.AuthToken.HeaderKey] = self.AuthToken.HeaderValue
-            msg.RequestJson = reqData
+            msg.UrlParameters = urlParms
             self.MakeRequest('PUT', msg)
             
             # process results.

spotifywebapipython/zeroconfapi/zeroconfgetinfo.py

@@ -167,6 +167,14 @@ class ZeroconfGetInfo(ZeroconfResponse):
         """
         return self._BrandDisplayName
 
+    @BrandDisplayName.setter
+    def BrandDisplayName(self, value:str):
+        """ 
+        Sets the BrandDisplayName property value.
+        """
+        if isinstance(value, str):
+            self._BrandDisplayName = value
+
 
     @property
     def ClientId(self) -> str:
@@ -305,6 +313,14 @@ class ZeroconfGetInfo(ZeroconfResponse):
         """
         return self._ModelDisplayName
 
+    @ModelDisplayName.setter
+    def ModelDisplayName(self, value:str):
+        """ 
+        Sets the ModelDisplayName property value.
+        """
+        if isinstance(value, str):
+            self._ModelDisplayName = value
+
 
     @property
     def ProductId(self) -> str:
@@ -313,6 +329,14 @@ class ZeroconfGetInfo(ZeroconfResponse):
         """
         return self._ProductId
 
+    @ProductId.setter
+    def ProductId(self, value:str):
+        """ 
+        Sets the ProductId property value.
+        """
+        if isinstance(value, str):
+            self._ProductId = value
+
 
     @property
     def PublicKey(self) -> str: