Add support for artist popular tracks (#1453)

* Add artist popular tracks

* Test artist popular tracks

Author: JonnyWong16

plexapi/audio.py

@@ -281,6 +281,21 @@ def download(self, savepath=None, keep_original_name=False, subfolders=False, **
             filepaths += track.download(_savepath, keep_original_name, **kwargs)
         return filepaths
 
+    def popularTracks(self):
+        """ Returns a list of :class:`~plexapi.audio.Track` popular tracks by the artist. """
+        filters = {
+            'album.subformat!': 'Compilation,Live',
+            'artist.id': self.ratingKey,
+            'group': 'title',
+            'ratingCount>>': 0,
+        }
+        return self.section().search(
+            libtype='track',
+            filters=filters,
+            sort='ratingCount:desc',
+            limit=100
+        )
+
     def station(self):
         """ Returns a :class:`~plexapi.playlist.Playlist` artist radio station or `None`. """
         key = f'{self.key}?includeStations=1'

plexapi/library.py

@@ -2823,7 +2823,8 @@ def _manualFields(self):
             additionalFields.extend([
                 ('duration', 'integer', 'Duration'),
                 ('viewOffset', 'integer', 'View Offset'),
-                ('label', 'tag', 'Label')
+                ('label', 'tag', 'Label'),
+                ('ratingCount', 'integer', 'Rating Count'),
             ])
         elif self.type == 'collection':
             additionalFields.extend([

tests/test_audio.py

@@ -88,6 +88,11 @@ def test_audio_Artist_hubs(artist):
     assert isinstance(hubs, list)
 
 
+def test_audio_Artist_popularTracks(artist):
+    tracks = artist.popularTracks()
+    assert len(tracks)
+
+
 def test_audio_Artist_mixins_edit_advanced_settings(artist):
     test_mixins.edit_advanced_settings(artist)