spotifywebapiPython 1.0.92__py3-none-any.whl → 1.0.94__py3-none-any.whl

spotifywebapipython/models/spotifyconnectdevices.py

@@ -289,6 +289,7 @@ class SpotifyConnectDevices():
         """
         result:dict = \
         {
+            'AgeLastRefreshed': self.AgeLastRefreshed,
             'DateLastRefreshed': self._DateLastRefreshed,
             'ItemsCount': self.ItemsCount,
             'Items': [ item.ToDictionary() for item in self._Items ],

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
 

spotifywebapipython/models/userprofilesimplified.py

@@ -177,6 +177,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,           

spotifywebapipython/models/zeroconfdiscoveryresult.py

@@ -349,7 +349,7 @@ class ZeroconfDiscoveryResult:
     @property
     def SpotifyConnectIsInDeviceList(self) -> bool:
         """ 
-        Spotify Connect SpotifyConnectIsInDeviceList property value (e.g. "/zc").
+        True if the device is in the Spotify Player active device list; otherwise, False.
         """
         return self._SpotifyConnectIsInDeviceList
     
@@ -435,6 +435,7 @@ class ZeroconfDiscoveryResult:
             'HostIpAddresses': [ str(item) for item in self._HostIpAddresses ],
             'HostIpPort': self._HostIpPort,
             'HostTTL': self._HostTTL,
+            'IsDynamicDevice': self.IsDynamicDevice,
             'Key': self._Key,
             'Name': self._Name,
             'Priority': self._Priority,

spotifywebapipython/spotifyclient.py

@@ -2713,9 +2713,12 @@ class SpotifyClient:
             # update result object with final paging details.
             result.Total = pageObj.Total
 
-            # sort items on Name property, ascending order.
-            if (len(result.Items) > 0) and (sortResult is True):
-                result.Items.sort(key=lambda x: (x.Album.Name or "").lower(), reverse=False)
+            # sort result items.
+            if (len(result.Items) > 0):
+                if (sortResult is True):
+                    result.Items.sort(key=lambda x: (x.Album.Name or "").lower(), reverse=False)
+                else:
+                    result.Items.sort(key=lambda x: (x.AddedAt or "").lower(), reverse=True)
 
             # trace.
             _logsi.LogObject(SILevel.Verbose, (TRACE_METHOD_RESULT_TYPE + result.PagingInfo) % (apiMethodName, type(result).__name__), result, excludeNonPublic=True)
@@ -2875,9 +2878,10 @@ class SpotifyClient:
             # update result object with final paging details.
             result.Total = pageObj.Total
 
-            # sort items on Name property, ascending order.
-            if (len(result.Items) > 0) and (sortResult is True):
-                result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
+            # sort result items.
+            if (len(result.Items) > 0):
+                if (sortResult is True):
+                    result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
 
             # trace.
             _logsi.LogObject(SILevel.Verbose, (TRACE_METHOD_RESULT_TYPE + result.PagingInfo) % (apiMethodName, type(result).__name__), result, excludeNonPublic=True)
@@ -3406,9 +3410,10 @@ class SpotifyClient:
             # update result object with final paging details.
             result.Total = pageObj.Total
 
-            # sort items on Name property, ascending order.
-            if (len(result.Items) > 0) and (sortResult is True):
-                result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
+            # sort result items.
+            if (len(result.Items) > 0):
+                if (sortResult is True):
+                    result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
 
             # trace.
             _logsi.LogObject(SILevel.Verbose, (TRACE_METHOD_RESULT_TYPE + result.PagingInfo) % (apiMethodName, type(result).__name__), result, excludeNonPublic=True)
@@ -3981,9 +3986,10 @@ class SpotifyClient:
             result.Total = pageObj.Total
             result.CursorAfter = pageObj.CursorAfter
 
-            # sort items on Name property, ascending order.
-            if (len(result.Items) > 0) and (sortResult is True):
-                result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
+            # sort result items.
+            if (len(result.Items) > 0):
+                if (sortResult is True):
+                    result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
         
             # trace.
             _logsi.LogObject(SILevel.Verbose, TRACE_METHOD_RESULT_TYPE % (apiMethodName, type(result).__name__), result, excludeNonPublic=True)
@@ -4510,9 +4516,10 @@ class SpotifyClient:
             # update result object with final paging details.
             result.Total = pageObj.Total
 
-            # sort items on Name property, ascending order.
-            if (len(result.Items) > 0) and (sortResult is True):
-                result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
+            # sort result items.
+            if (len(result.Items) > 0):
+                if (sortResult is True):
+                    result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
 
             # trace.
             _logsi.LogObject(SILevel.Verbose, (TRACE_METHOD_RESULT_TYPE + result.PagingInfo) % (apiMethodName, type(result).__name__), result, excludeNonPublic=True)
@@ -4900,9 +4907,10 @@ class SpotifyClient:
             # update result object with final paging details.
             result.Total = pageObj.Total
 
-            # sort items on Name property, ascending order.
-            if (len(result.Items) > 0) and (sortResult is True):
-                result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
+            # sort result items.
+            if (len(result.Items) > 0):
+                if (sortResult is True):
+                    result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
         
             # trace.
             _logsi.LogObject(SILevel.Verbose, TRACE_METHOD_RESULT_TYPE % (apiMethodName, type(result).__name__), result, excludeNonPublic=True)
@@ -5182,9 +5190,10 @@ class SpotifyClient:
             # update result object with final paging details.
             result.Total = pageObj.Total
 
-            # sort items on Name property, ascending order.
-            if (len(result.Items) > 0) and (sortResult is True):
-                result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
+            # sort result items.
+            if (len(result.Items) > 0):
+                if (sortResult is True):
+                    result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
 
             # trace.
             _logsi.LogObject(SILevel.Verbose, (TRACE_METHOD_RESULT_TYPE + result.PagingInfo) % (apiMethodName, type(result).__name__), result, excludeNonPublic=True)
@@ -5623,9 +5632,12 @@ class SpotifyClient:
             # update result object with final paging details.
             result.Total = pageObj.Total
 
-            # sort items on Name property, ascending order.
-            if (len(result.Items) > 0) and (sortResult is True):
-                result.Items.sort(key=lambda x: (x.Episode.Name or "").lower(), reverse=False)
+            # sort result items.
+            if (len(result.Items) > 0):
+                if (sortResult is True):
+                    result.Items.sort(key=lambda x: (x.Episode.Name or "").lower(), reverse=False)
+                else:
+                    result.Items.sort(key=lambda x: (x.AddedAt or "").lower(), reverse=True)
             
             # trace.
             _logsi.LogObject(SILevel.Verbose, (TRACE_METHOD_RESULT_TYPE + result.PagingInfo) % (apiMethodName, type(result).__name__), result, excludeNonPublic=True)
@@ -5910,9 +5922,10 @@ class SpotifyClient:
             # update result object with final paging details.
             result.Total = pageObj.Total
 
-            # sort items on Name property, ascending order.
-            if (len(result.Items) > 0) and (sortResult is True):
-                result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
+            # sort result items.
+            if (len(result.Items) > 0):
+                if (sortResult is True):
+                    result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
 
             # trace.
             _logsi.LogObject(SILevel.Verbose, (TRACE_METHOD_RESULT_TYPE + result.PagingInfo) % (apiMethodName, type(result).__name__), result, excludeNonPublic=True)
@@ -7843,9 +7856,10 @@ class SpotifyClient:
             # update result object with final paging details.
             result.Total = pageObj.Total
 
-            # sort items on Name property, ascending order.
-            if (len(result.Items) > 0) and (sortResult is True):
-                result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
+            # sort result items.
+            if (len(result.Items) > 0):
+                if (sortResult is True):
+                    result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
             
             # trace.
             _logsi.LogObject(SILevel.Verbose, (TRACE_METHOD_RESULT_TYPE + result.PagingInfo) % (apiMethodName, type(result).__name__), result, excludeNonPublic=True)
@@ -8001,9 +8015,10 @@ class SpotifyClient:
             # update result object with final paging details.
             result.Total = pageObj.Total
 
-            # sort items on Name property, ascending order.
-            if (len(result.Items) > 0) and (sortResult is True):
-                result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
+            # sort result items.
+            if (len(result.Items) > 0):
+                if (sortResult is True):
+                    result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
             
             # trace.
             _logsi.LogObject(SILevel.Verbose, (TRACE_METHOD_RESULT_TYPE + result.PagingInfo) % (apiMethodName, type(result).__name__), result, excludeNonPublic=True)
@@ -8416,7 +8431,7 @@ class SpotifyClient:
                 else:
                 
                     # append page of items to final results.
-                    item:AlbumSaved
+                    item:ShowSaved
                     for item in pageObj.Items:
                         result.Items.append(item)
                         result.Limit = result.ItemsCount
@@ -8430,9 +8445,12 @@ class SpotifyClient:
             # update result object with final paging details.
             result.Total = pageObj.Total
 
-            # sort items on Name property, ascending order.
-            if (len(result.Items) > 0) and (sortResult is True):
-                result.Items.sort(key=lambda x: (x.Show.Name or "").lower(), reverse=False)
+            # sort result items.
+            if (len(result.Items) > 0):
+                if (sortResult is True):
+                    result.Items.sort(key=lambda x: (x.Show.Name or "").lower(), reverse=False)
+                else:
+                    result.Items.sort(key=lambda x: (x.AddedAt or "").lower(), reverse=True)
             
             # trace.
             _logsi.LogObject(SILevel.Verbose, (TRACE_METHOD_RESULT_TYPE + result.PagingInfo) % (apiMethodName, type(result).__name__), result, excludeNonPublic=True)
@@ -9066,9 +9084,10 @@ class SpotifyClient:
                 # update cache.
                 self._ConfigurationCache[apiMethodName] = result
 
-            # sort items on Name property, ascending order.
-            if (len(result.Items) > 0) and (sortResult is True):
-                result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
+            # sort result items.
+            if (len(result.Items) > 0):
+                if (sortResult is True):
+                    result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
         
             # update last refresh date.
             result.DateLastRefreshed = datetime.utcnow().timestamp()
@@ -9391,9 +9410,12 @@ class SpotifyClient:
             # update result object with final paging details.
             result.Total = pageObj.Total
 
-            # sort items on Name property, ascending order.
-            if (len(result.Items) > 0) and (sortResult is True):
-                result.Items.sort(key=lambda x: (x.Track.Name or "").lower(), reverse=False)
+            # sort result items.
+            if (len(result.Items) > 0):
+                if (sortResult is True):
+                    result.Items.sort(key=lambda x: (x.Track.Name or "").lower(), reverse=False)
+                else:
+                    result.Items.sort(key=lambda x: (x.AddedAt or "").lower(), reverse=True)
 
             # trace.
             _logsi.LogObject(SILevel.Verbose, (TRACE_METHOD_RESULT_TYPE + result.PagingInfo) % (apiMethodName, type(result).__name__), result, excludeNonPublic=True)
@@ -10314,9 +10336,10 @@ class SpotifyClient:
             # update result object with final paging details.
             result.Total = pageObj.Total
 
-            # sort items on Name property, ascending order.
-            if (len(result.Items) > 0) and (sortResult is True):
-                result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
+            # sort result items.
+            if (len(result.Items) > 0):
+                if (sortResult is True):
+                    result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
         
             # trace.
             _logsi.LogObject(SILevel.Verbose, (TRACE_METHOD_RESULT_TYPE + result.PagingInfo) % (apiMethodName, type(result).__name__), result, excludeNonPublic=True)
@@ -10477,9 +10500,10 @@ class SpotifyClient:
             # update result object with final paging details.
             result.Total = pageObj.Total
 
-            # sort items on Name property, ascending order.
-            if (len(result.Items) > 0) and (sortResult is True):
-                result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
+            # sort result items.
+            if (len(result.Items) > 0):
+                if (sortResult is True):
+                    result.Items.sort(key=lambda x: (x.Name or "").lower(), reverse=False)
         
             # trace.
             _logsi.LogObject(SILevel.Verbose, (TRACE_METHOD_RESULT_TYPE + result.PagingInfo) % (apiMethodName, type(result).__name__), result, excludeNonPublic=True)

spotifywebapipython/zeroconfapi/zeroconfgetinfo.py

@@ -492,6 +492,11 @@ class ZeroconfGetInfo(ZeroconfResponse):
             'TokenType': self._TokenType,
             'Version': self._Version,
             'VoiceSupport': self._VoiceSupport,
+            # helper property(s), not part of the Spotify Web API interface:
+            'HasActiveUser': self.HasActiveUser,
+            'HasAliases': self.HasAliases,
+            'IsAvailable': self.IsAvailable,
+            'IsBrandSonos': self.IsBrandSonos,
             'IsActiveDevice': self._IsActiveDevice,
             'IsInDeviceList': self._IsInDeviceList,
         }

spotifywebapipython/zeroconfapi/zeroconfgetinfoalias.py

@@ -82,6 +82,7 @@ class ZeroconfGetInfoAlias:
             'Id': self._Id,
             'IsGroup': self._IsGroup,
             'Name': self._Name,
+            'Title': self.Title,
         }
         return result