spotifywebapiPython 1.0.35__py3-none-any.whl → 1.0.147__py3-none-any.whl

spotifywebapipython/models/trackpagesimplified.py

@@ -38,7 +38,8 @@ class TrackPageSimplified(PageObject):
             items:list = root.get('items',None)
             if items is not None:
                 for item in items:
-                    self._Items.append(TrackSimplified(root=item))
+                    if item is not None:
+                        self._Items.append(TrackSimplified(root=item))
 
         
     def __repr__(self) -> str:

spotifywebapipython/models/trackrecommendations.py

@@ -8,7 +8,7 @@ from .track import Track
 @export
 class TrackRecommendations:
     """
-    Spotify Web API SimplifiedTrack object.
+    Spotify Web API TrackRecommendations object.
     """
 
     def __init__(self, root:dict=None) -> None:
@@ -30,12 +30,12 @@ class TrackRecommendations:
         else:
 
             # process all collections and objects.
-            items:list = root.get('seeds',None)
+            items:list = root.get('seeds', [])
             if items is not None:
                 for item in items:
                     self._Seeds.append(RecommendationSeed(root=item))
         
-            items:list = root.get('tracks',None)
+            items:list = root.get('tracks', [])
             if items is not None:
                 for item in items:
                     self._Tracks.append(Track(root=item))
@@ -60,8 +60,8 @@ class TrackRecommendations:
     @property
     def Tracks(self) -> list[Track]:
         """ 
-        A list of Track objects, ordered according to the parameters supplied.
-        on the `GetTrackRecommendations` method.
+        A list of Track objects, ordered according to the parameters supplied
+        to the `GetTrackRecommendations` method.
         """
         return self._Tracks
 

spotifywebapipython/models/tracksimplified.py

@@ -139,7 +139,7 @@ class TrackSimplified:
     @property
     def Explicit(self) -> bool:
         """ 
-        Whether or not the track has explicit lyrics (true = yes it does; false = no it does not OR unknown).
+        Whether or not the track has explicit content (true = yes it does; false = no it does not OR unknown).
         """
         return self._Explicit
 
@@ -198,7 +198,7 @@ class TrackSimplified:
     @property
     def Name(self) -> str:
         """ 
-        The name of the artist.
+        The name of the track.
         """
         return self._Name
 
@@ -224,10 +224,17 @@ class TrackSimplified:
     @property
     def PreviewUrl(self) -> str:
         """ 
+        <span class="deprecated">
+            DEPRECATED - property no longer supported by Spotify as of 2024/11/27.
+            More information about the deprecated functionality can be found on the 
+            <a href="https://developer.spotify.com/blog/2024-11-27-changes-to-the-web-api" target="_blank">Spotify Developer Forum Blog</a>
+            page.
+        </span>
+        
         A link to a 30 second preview (MP3 format) of the track. Can be null.
         
         Important policy note:
-        - Spotify Audio preview clips can not be a standalone service.
+        - Spotify Audio preview clips can not be a standalone service.       
         """
         return self._PreviewUrl
 

spotifywebapipython/models/userprofile.py

@@ -110,7 +110,31 @@ class UserProfile(UserProfileSimplified):
     
 
     @property
-    def Product(self) -> str:
+    def IsProductFree(self) -> str:
+        """ 
+        Returns true if the user's Spotify subscription level is `free` or `open`;
+        otherwise, False.
+        
+        This field is only valid when the current user has granted access to 
+        the `user-read-private` scope; otherwise, it is set to `unknown`.
+        """
+        return (self._Product == 'free') or (self._Product == 'opem')
+
+
+    @property
+    def IsProductPremium(self) -> bool:
+        """ 
+        Returns true if the user's Spotify subscription level is `premium`;
+        otherwise, False.
+        
+        This field is only valid when the current user has granted access to 
+        the `user-read-private` scope; otherwise, it is set to `unknown`.
+        """
+        return (self._Product == 'premium')
+
+
+    @property
+    def Product(self) -> bool:
         """ 
         The user's Spotify subscription level: `premium`, `free`, etc. 
         

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
@@ -177,6 +175,7 @@ class UserProfileSimplified:
             'followers': followers,
             'href': self._Href,
             'id': self._Id,
+            'image_url': self.ImageUrl,
             'images': [ item.ToDictionary() for item in self._Images ],
             'type': self._Type,
             'uri': self._Uri,