]> kaliko git repositories - mpd-sima.git/blob - sima/client.py
Fixed typo, thanks lintian
[mpd-sima.git] / sima / client.py
1 # -*- coding: utf-8 -*-
2 # Copyright (c) 2013, 2014 Jack Kaliko <kaliko@azylum.org>
3 #
4 #  This file is part of sima
5 #
6 #  sima is free software: you can redistribute it and/or modify
7 #  it under the terms of the GNU General Public License as published by
8 #  the Free Software Foundation, either version 3 of the License, or
9 #  (at your option) any later version.
10 #
11 #  sima is distributed in the hope that it will be useful,
12 #  but WITHOUT ANY WARRANTY; without even the implied warranty of
13 #  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14 #  GNU General Public License for more details.
15 #
16 #  You should have received a copy of the GNU General Public License
17 #  along with sima.  If not, see <http://www.gnu.org/licenses/>.
18 #
19 #
20 """MPD client for Sima
21
22 This client is built above python-musicpd a fork of python-mpd
23 """
24 #  pylint: disable=C0111
25
26 # standard library import
27 from difflib import get_close_matches
28 from select import select
29
30 # third parties components
31 try:
32     from musicpd import (MPDClient, MPDError, CommandError)
33 except ImportError as err:
34     from sys import exit as sexit
35     print('ERROR: missing python-musicpd?\n{0}'.format(err))
36     sexit(1)
37
38 # local import
39 from .lib.simastr import SimaStr
40 from .lib.player import Player, blacklist
41 from .lib.track import Track
42 from .lib.meta import Album, Artist
43 from .utils.leven import levenshtein_ratio
44
45
46 class PlayerError(Exception):
47     """Fatal error in poller."""
48
49 class PlayerCommandError(PlayerError):
50     """Command error"""
51
52 PlayerUnHandledError = MPDError  # pylint: disable=C0103
53
54 def bl_artist(func):
55     def wrapper(*args, **kwargs):
56         cls = args[0]
57         if not args[0].database:
58             return func(*args, **kwargs)
59         result = func(*args, **kwargs)
60         if not result:
61             return
62         names = list()
63         for art in result.names:
64             if cls.database.get_bl_artist(art, add_not=True):
65                 cls.log.debug('Blacklisted "%s"', art)
66                 continue
67             names.append(art)
68         if not names:
69             return
70         resp = Artist(name=names.pop(), mbid=result.mbid)
71         for name in names:
72             resp.add_alias(name)
73         return resp
74     return wrapper
75
76
77 class PlayerClient(Player):
78     """MPD Client
79     From python-musicpd:
80         _fetch_nothing  …
81         _fetch_item     single str
82         _fetch_object   single dict
83         _fetch_list     list of str
84         _fetch_playlist list of str
85         _fetch_changes  list of dict
86         _fetch_database list of dict
87         _fetch_songs    list of dict, especially tracks
88         _fetch_plugins,
89     TODO: handle exception in command not going through _client_wrapper() (ie.
90           remove…)
91     """
92     database = None  # sima database (history, blacklist)
93
94     def __init__(self, host="localhost", port="6600", password=None):
95         super().__init__()
96         self._comm = self._args = None
97         self._mpd = host, port, password
98         self._client = MPDClient()
99         self._client.iterate = True
100         self._cache = None
101
102     def __getattr__(self, attr):
103         command = attr
104         wrapper = self._execute
105         return lambda *args: wrapper(command, args)
106
107     def _execute(self, command, args):
108         self._write_command(command, args)
109         return self._client_wrapper()
110
111     def _write_command(self, command, args=None):
112         self._comm = command
113         self._args = list()
114         for arg in args:
115             self._args.append(arg)
116
117     def _client_wrapper(self):
118         func = self._client.__getattr__(self._comm)
119         try:
120             ans = func(*self._args)
121         # WARNING: MPDError is an ancestor class of # CommandError
122         except CommandError as err:
123             raise PlayerCommandError('MPD command error: %s' % err)
124         except (MPDError, IOError) as err:
125             raise PlayerError(err)
126         return self._track_format(ans)
127
128     def _track_format(self, ans):
129         """
130         unicode_obj = ["idle", "listplaylist", "list", "sticker list",
131                 "commands", "notcommands", "tagtypes", "urlhandlers",]
132         """
133         # TODO: ain't working for "sticker find" and "sticker list"
134         tracks_listing = ["playlistfind", "playlistid", "playlistinfo",
135                           "playlistsearch", "plchanges", "listplaylistinfo", "find",
136                           "search", "sticker find",]
137         track_obj = ['currentsong']
138         if self._comm in tracks_listing + track_obj:
139             if isinstance(ans, list):
140                 return [Track(**track) for track in ans]
141             elif isinstance(ans, dict):
142                 return Track(**ans)
143         return ans
144
145     def __skipped_track(self, old_curr):
146         if (self.state == 'stop'
147                 or not hasattr(old_curr, 'id')
148                 or not hasattr(self.current, 'id')):
149             return False
150         return self.current.id != old_curr.id  # pylint: disable=no-member
151
152     def _flush_cache(self):
153         """
154         Both flushes and instantiates _cache
155         """
156         if isinstance(self._cache, dict):
157             self.log.info('Player: Flushing cache!')
158         else:
159             self.log.info('Player: Initialising cache!')
160         self._cache = {'artists': frozenset(),
161                        'nombid_artists': frozenset(),}
162         self._cache['artists'] = frozenset(filter(None, self._execute('list', ['artist'])))
163         if Artist.use_mbid:
164             self._cache['nombid_artists'] = frozenset(filter(None, self._execute('list', ['artist', 'musicbrainz_artistid', ''])))
165
166     @blacklist(track=True)
167     def find_track(self, artist, title=None):
168         tracks = set()
169         if artist.mbid:
170             if title:
171                 tracks |= set(self.find('musicbrainz_artistid', artist.mbid,
172                                         'title', title))
173             else:
174                 tracks |= set(self.find('musicbrainz_artistid', artist.mbid))
175         else:
176             for name in artist.names:
177                 if title:
178                     tracks |= set(self.find('artist', name, 'title', title))
179                 else:
180                     tracks |= set(self.find('artist', name))
181         return list(tracks)
182
183     @bl_artist
184     def search_artist(self, artist):
185         """
186         Search artists based on a fuzzy search in the media library
187             >>> art = Artist(name='the beatles', mbid=<UUID4>) # mbid optional
188             >>> bea = player.search_artist(art)
189             >>> print(bea.names)
190             >>> ['The Beatles', 'Beatles', 'the beatles']
191
192         Returns an Artist object
193         """
194         found = False
195         if artist.mbid:
196             # look for exact search w/ musicbrainz_artistid
197             exact_m = self._execute('list', ['artist', 'musicbrainz_artistid', artist.mbid])
198             if exact_m:
199                 _ = [artist.add_alias(name) for name in exact_m]
200                 found = True
201         else:
202             artist = Artist(name=artist.name)
203         # then complete with fuzzy search on artist with no musicbrainz_artistid
204         if artist.mbid:
205             # we already performed a lookup on artists with mbid set
206             # search through remaining artists
207             artists = self._cache.get('nombid_artists')
208         else:
209             artists = self._cache.get('artists')
210         match = get_close_matches(artist.name, artists, 50, 0.73)
211         if not match and not found:
212             return
213         if len(match) > 1:
214             self.log.debug('found close match for "%s": %s', artist, '/'.join(match))
215         # Does not perform fuzzy matching on short and single word strings
216         # Only lowercased comparison
217         if ' ' not in artist.name and len(artist.name) < 8:
218             for fuzz_art in match:
219                 # Regular lowered string comparison
220                 if artist.name.lower() == fuzz_art.lower():
221                     artist.add_alias(fuzz_art)
222                     return artist
223         fzartist = SimaStr(artist.name)
224         for fuzz_art in match:
225             # Regular lowered string comparison
226             if artist.name.lower() == fuzz_art.lower():
227                 found = True
228                 artist.add_alias(fuzz_art)
229                 if artist.name != fuzz_art:
230                     self.log.debug('"%s" matches "%s".', fuzz_art, artist)
231                 continue
232             # SimaStr string __eq__ (not regular string comparison here)
233             if fzartist == fuzz_art:
234                 found = True
235                 artist.add_alias(fuzz_art)
236                 self.log.info('"%s" quite probably matches "%s" (SimaStr)',
237                               fuzz_art, artist)
238         if found:
239             if artist.aliases:
240                 self.log.debug('Found: %s', '/'.join(list(artist.names)[:4]))
241             return artist
242
243     def fuzzy_find_track(self, artist, title):
244         # Retrieve all tracks from artist
245         all_tracks = self.find_track(artist, title)
246         # Get all titles (filter missing titles set to 'None')
247         all_artist_titles = frozenset([tr.title for tr in all_tracks
248                                        if tr.title is not None])
249         match = get_close_matches(title, all_artist_titles, 50, 0.78)
250         if not match:
251             return []
252         for title_ in match:
253             leven = levenshtein_ratio(title.lower(), title_.lower())
254             if leven == 1:
255                 pass
256             elif leven >= 0.79:  # PARAM
257                 self.log.debug('title: "%s" should match "%s" (lr=%1.3f)',
258                                title_, title, leven)
259             else:
260                 self.log.debug('title: "%s" does not match "%s" (lr=%1.3f)',
261                                title_, title, leven)
262                 return []
263             return self.find('artist', artist, 'title', title_)
264
265     def find_album(self, artist, album):
266         """
267         Special wrapper around album search:
268         Album lookup is made through AlbumArtist/Album instead of Artist/Album
269         """
270         alb_art_search = self.find('albumartist', artist, 'album', album)
271         if alb_art_search:
272             return alb_art_search
273         return self.find('artist', artist, 'album', album)
274
275     @blacklist(album=True)
276     def search_albums(self, artist):
277         """
278         Fetch all albums for "AlbumArtist"  == artist
279         Filter albums returned for "artist" == artist since MPD returns any
280                album containing at least a single track for artist
281         """
282         albums = []
283         for name in artist.names:
284             if len(artist.names) > 1:
285                 self.log.debug('Searching album for aliase: "%s"', name)
286             kwalbart = {'albumartist':name, 'artist':name}
287             for album in self.list('album', 'albumartist', artist):
288                 if album and album not in albums:
289                     albums.append(Album(name=album, **kwalbart))
290             for album in self.list('album', 'artist', artist):
291                 album_trks = [trk for trk in self.find('album', album)]
292                 if 'Various Artists' in [tr.albumartist for tr in album_trks]:
293                     self.log.debug('Discarding %s ("Various Artists" set)', album)
294                     continue
295                 arts = set([trk.artist for trk in album_trks])
296                 if len(set(arts)) < 2:  # TODO: better heuristic, use a ratio instead
297                     if album not in albums:
298                         albums.append(Album(name=album, **kwalbart))
299                 elif album and album not in albums:
300                     self.log.debug('"{0}" probably not an album of "{1}"'.format(
301                         album, artist) + '({0})'.format('/'.join(arts)))
302         return albums
303
304     def monitor(self):
305         curr = self.current
306         try:
307             self.send_idle('database', 'playlist', 'player', 'options')
308             select([self._client], [], [], 60)
309             ret = self.fetch_idle()
310             if self.__skipped_track(curr):
311                 ret.append('skipped')
312             if 'database' in ret:
313                 self._flush_cache()
314             return ret
315         except (MPDError, IOError) as err:
316             raise PlayerError("Couldn't init idle: %s" % err)
317
318     def clean(self):
319         """Clean blocking event (idle) and pending commands
320         """
321         if 'idle' in self._client._pending:
322             self._client.noidle()
323         elif self._client._pending:
324             self.log.warning('pending commands: %s', self._client._pending)
325
326     def remove(self, position=0):
327         self.delete(position)
328
329     def add(self, track):
330         """Overriding MPD's add method to accept add signature with a Track
331         object"""
332         self._execute('add', [track.file])
333
334     @property
335     def artists(self):
336         return self._cache.get('artists')
337
338     @property
339     def state(self):
340         return str(self.status().get('state'))
341
342     @property
343     def playmode(self):
344         plm = {'repeat': None,
345                'single': None,
346                'random': None,
347                'consume': None,
348               }
349         for key, val in self.status().items():
350             if key in plm.keys():
351                 plm.update({key:bool(int(val))})
352         return plm
353
354     @property
355     def current(self):
356         return self.currentsong()
357
358     @property
359     def queue(self):
360         plst = self.playlist
361         plst.reverse()
362         return [trk for trk in plst if int(trk.pos) > int(self.current.pos)]
363
364     @property
365     def playlist(self):
366         """
367         Override deprecated MPD playlist command
368         """
369         return self.playlistinfo()
370
371     def connect(self):
372         host, port, password = self._mpd
373         self.disconnect()
374         try:
375             self._client.connect(host, port)
376
377         # Catch socket errors
378         except IOError as err:
379             raise PlayerError('Could not connect to "%s:%s": %s' %
380                               (host, port, err.strerror))
381
382         # Catch all other possible errors
383         # ConnectionError and ProtocolError are always fatal.  Others may not
384         # be, but we don't know how to handle them here, so treat them as if
385         # they are instead of ignoring them.
386         except MPDError as err:
387             raise PlayerError('Could not connect to "%s:%s": %s' %
388                               (host, port, err))
389
390         if password:
391             try:
392                 self._client.password(password)
393             except (MPDError, IOError) as err:
394                 raise PlayerError("Could not connect to '%s': %s", (host, err))
395         # Controls we have sufficient rights
396         needed_cmds = ['status', 'stats', 'add', 'find', \
397                        'search', 'currentsong', 'ping']
398
399         available_cmd = self._client.commands()
400         for nddcmd in needed_cmds:
401             if nddcmd not in available_cmd:
402                 self.disconnect()
403                 raise PlayerError('Could connect to "%s", '
404                                   'but command "%s" not available' %
405                                   (host, nddcmd))
406
407         #  Controls use of MusicBrainzIdentifier
408         if Artist.use_mbid:
409             if 'MUSICBRAINZ_ARTISTID' not in self._client.tagtypes():
410                 self.log.warning('Use of MusicBrainzIdentifier is set but MPD is '
411                                  'not providing related metadata')
412                 self.log.info(self._client.tagtypes())
413                 self.log.warning('Disabling MusicBrainzIdentifier')
414                 Artist.use_mbid = False
415             else:
416                 self.log.trace('Available metadata: %s', self._client.tagtypes())  # pylint: disable=no-member
417         else:
418             self.log.warning('Use of MusicBrainzIdentifier disabled!')
419             self.log.info('Consider using MusicBrainzIdentifier for your music library')
420         self._flush_cache()
421
422     def disconnect(self):
423         # Try to tell MPD we're closing the connection first
424         try:
425             self._client.noidle()
426             self._client.close()
427         # If that fails, don't worry, just ignore it and disconnect
428         except (MPDError, IOError):
429             pass
430         try:
431             self._client.disconnect()
432         # Disconnecting failed, so use a new client object instead
433         # This should never happen.  If it does, something is seriously broken,
434         # and the client object shouldn't be trusted to be re-used.
435         except (MPDError, IOError):
436             self._client = MPDClient()
437
438 # VIM MODLINE
439 # vim: ai ts=4 sw=4 sts=4 expandtab