+class AdvancedPlugin(Plugin):
+ """Object to derive from for plugins
+ Exposes advanced music library look up with use of play history
+ """
+
+ # Query History
+ def get_history(self):
+ """Returns a Track list of already played artists."""
+ duration = self.main_conf.getint('sima', 'history_duration')
+ return self.sdb.fetch_history(duration=duration)
+
+ def get_album_history(self, artist):
+ """Retrieve album history"""
+ duration = self.main_conf.getint('sima', 'history_duration')
+ return self.sdb.fetch_albums_history(needle=artist, duration=duration)
+
+ def get_reorg_artists_list(self, alist):
+ """
+ Move around items in alist in order to have first not recently
+ played (or about to be played) artists.
+
+ :param {Artist} alist: Artist objects list/container
+ """
+ queued_artist = MetaContainer([Artist(_.artist) for _ in
+ self.player.queue if _.artist])
+ not_queued_artist = alist - queued_artist
+ duration = self.main_conf.getint('sima', 'history_duration')
+ hist = []
+ for art in self.sdb.fetch_artists_history(alist, duration=duration):
+ if art not in hist:
+ if art not in queued_artist:
+ hist.insert(0, art)
+ else:
+ hist.append(art)
+ # Find not recently played (not in history) & not in queue
+ reorg = [art for art in not_queued_artist if art not in hist]
+ reorg.extend(hist)
+ return reorg
+ # /Query History
+
+ # Find not recently played/unplayed
+ def album_candidate(self, artist, unplayed=True):
+ """Search an album for artist
+
+ :param Artist artist: Artist to fetch an album for
+ :param bool unplayed: Fetch only unplayed album
+ """
+ self.log.info('Searching an album for "%s"...', artist)
+ albums = self.player.search_albums(artist)
+ if not albums:
+ return None
+ self.log.debug('Albums to choose from: %s', albums)
+ albums_hist = self.get_album_history(artist)
+ self.log.trace('Albums history: %s', [a.name for a in albums_hist])
+ albums_not_in_hist = [a for a in albums if a.name not in albums_hist]
+ # Get to next artist if there are no unplayed albums
+ if not albums_not_in_hist:
+ self.log.info('No unplayed album found for "%s"', artist)
+ if unplayed:
+ return None
+ random.shuffle(albums_not_in_hist)
+ albums_not_in_hist.extend(albums_hist)
+ self.log.trace('Album candidates: %s', albums_not_in_hist)
+ album_to_queue = []
+ for album in albums_not_in_hist:
+ # Controls the album found is not already queued
+ if album in {t.Album.name for t in self.player.queue}:
+ self.log.debug('"%s" already queued, skipping!', album)
+ continue
+ # In random play mode use complete playlist to filter
+ # Yes indeed, some users play in random with album mode :|
+ if self.player.playmode.get('random'):
+ if album in {t.Album.name for t in self.player.playlist}:
+ self.log.debug('"%s" already in playlist, skipping!',
+ album)
+ continue
+ album_to_queue = album
+ break
+ if not album_to_queue:
+ self.log.info('No album found for "%s"', artist)
+ return None
+ self.log.info('%s plugin chose album: %s - %s',
+ self.__class__.__name__, artist, album_to_queue)
+ return album_to_queue
+
+ def filter_track(self, tracks, chosen=None, unplayed=False):
+ """
+ Extract one unplayed track from a Track object list.
+ * not in history
+ * not already in the queue
+
+ :param list(Track) tracks: List of tracks to chose from
+ :param list(Track) chosen: List of tracks previously chosen
+ :param bool unplayed: chose only unplayed (honoring history duration setting)
+ :return: A Track
+ :rtype: Track
+ """
+ artist = tracks[0].Artist
+ # In random play mode use complete playlist to filter
+ if self.player.playmode.get('random'):
+ deny_list = self.player.playlist
+ else:
+ deny_list = self.player.queue
+ not_in_hist = list(set(tracks) - set(self.sdb.fetch_history(artist=artist)))
+ if not not_in_hist:
+ self.log.debug('All tracks already played for "%s"', artist)
+ if unplayed:
+ return None
+ random.shuffle(not_in_hist)
+ candidates = []
+ for trk in [_ for _ in not_in_hist if _ not in deny_list]:
+ # Should use albumartist heuristic as well
+ if self.plugin_conf.getboolean('single_album', False): # pylint: disable=no-member
+ albums = [tr.Album for tr in deny_list]
+ albums += [tr.Album for tr in chosen]
+ if (trk.Album == self.player.current.Album or
+ trk.Album in albums):
+ self.log.debug('Found unplayed track ' +
+ 'but from an album already queued: %s', trk)
+ continue
+ candidates.append(trk)
+ if not candidates:
+ return None
+ return random.choice(candidates)