X-Git-Url: https://git.kaliko.me/?a=blobdiff_plain;f=sima%2Flib%2Fmeta.py;h=2adac1376b3b972f29acb1ac48df645910448a5c;hb=1c01e4a7aa37eeef825c6918fc90b154a7f4ccc7;hp=6fb6a0e60a3a86f14c2a180bb24e6043e7cf2127;hpb=927b9fcec374c8bca35abcdb666b05a8279facd3;p=mpd-sima.git diff --git a/sima/lib/meta.py b/sima/lib/meta.py index 6fb6a0e..2adac13 100644 --- a/sima/lib/meta.py +++ b/sima/lib/meta.py @@ -1,72 +1,190 @@ # -*- coding: utf-8 -*- - -from .simastr import SimaStr -from .track import Track +# Copyright (c) 2013, 2014 Jack Kaliko +# +# This file is part of sima +# +# sima is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# sima is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with sima. If not, see . +# +# +""" +Defines some object to handle audio file metadata +""" + +try: + from collections.abc import Set # python >= 3.3 +except ImportError: + from collections import Set # python 3.2 +import logging +import re + +UUID_RE = r'^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89aAbB][a-f0-9]{3}-[a-f0-9]{12}$' + +def is_uuid4(uuid): + regexp = re.compile(UUID_RE, re.IGNORECASE) + if regexp.match(uuid): + return True + raise WrongUUID4(uuid) class MetaException(Exception): + """Generic Meta Exception""" pass -class NotSameArtist(MetaException): +class WrongUUID4(MetaException): pass +def mbidfilter(func): + def wrapper(*args, **kwargs): + cls = args[0] + if not cls.use_mbid: + kwargs.pop('mbid', None) + kwargs.pop('musicbrainz_artistid', None) + kwargs.pop('musicbrainz_albumartistid', None) + func(*args, **kwargs) + return wrapper + class Meta: + """Generic Class for Meta object + Meta(name=[, mbid=UUID4]) + """ + use_mbid = True def __init__(self, **kwargs): - self.name = None - self.mbid = None - if 'name' not in kwargs: - raise MetaException('need at least a "name" argument') - self.__dict__.update(kwargs) + self.__name = None #TODO: should be immutable + self.__mbid = None + self.__aliases = set() + self.log = logging.getLogger(__name__) + if 'name' not in kwargs or not kwargs.get('name'): + raise MetaException('Need a "name" argument') + else: + self.__name = kwargs.pop('name') + if 'mbid' in kwargs and kwargs.get('mbid'): + try: + is_uuid4(kwargs.get('mbid')) + self.__mbid = kwargs.pop('mbid').lower() + except WrongUUID4: + self.log.warning('Wrong mbid %s:%s', self.__name, + kwargs.get('mbid')) + # mbid immutable as hash rests on + self.__dict__.update(**kwargs) def __repr__(self): - fmt = '{0}(name="{1.name}", mbid="{1.mbid}")' + fmt = '{0}(name={1.name!r}, mbid={1.mbid!r})' return fmt.format(self.__class__.__name__, self) def __str__(self): - return str(self.name) + return self.__name.__str__() def __eq__(self, other): """ - Perform mbid equality test if present, - else fallback on fuzzy equality + Perform mbid equality test """ - if hasattr(other, 'mbid'): - if other.mbid and self.mbid: - return self.mbid == other.mbid - return SimaStr(str(self)) == SimaStr(str(other)) - + #if hasattr(other, 'mbid'): # better isinstance? + if isinstance(other, Meta) and self.mbid and other.mbid: + return self.mbid == other.mbid + elif isinstance(other, Meta): + return bool(self.names & other.names) + elif getattr(other, '__str__', None): + # is other.__str__() in self.__name or self.__aliases + return other.__str__() in self.names + return False + + def __hash__(self): + if self.mbid: + return hash(self.mbid) + return hash(self.__name) + + def add_alias(self, other): + if getattr(other, '__str__', None): + if callable(other.__str__) and other.__str__() != self.name: + self.__aliases |= {other.__str__()} + elif isinstance(other, Meta): + if other.name != self.name: + self.__aliases |= other.__aliases + else: + raise MetaException('No __str__ method found in {!r}'.format(other)) -class Artist(Meta): + @property + def name(self): + return self.__name - def __init__(self, **kwargs): - self._aliases = [] - super().__init__(**kwargs) + @property + def mbid(self): + return self.__mbid - def append(self, name): - self._aliases.append(name) + @property + def aliases(self): + return self.__aliases @property def names(self): - return self._aliases + [self.name] - - def __add__(self, other): - if isinstance(other, Artist): - if self.mbid == other.mbid: - res = Artist(**self.__dict__) - res._aliases.extend(other.names) - return res + return self.__aliases | {self.__name,} + + +class Album(Meta): + + @property + def album(self): + return self.name + +class Artist(Meta): + + @mbidfilter + def __init__(self, name=None, mbid=None, **kwargs): + """Artist object built from a mapping dict containing at least an + "artist" entry: + >>> trk = {'artist':'Art Name', + >>> 'albumartist': 'Alb Art Name', # optional + >>> 'musicbrainz_artistid': '' , # optional + >>> 'musicbrainz_albumartistid': '', # optional + >>> } + >>> artobj0 = Artist(**trk) + >>> artobj1 = Artist(name='Tool') + """ + name = kwargs.get('artist', name).split(', ')[0] + mbid = kwargs.get('musicbrainz_artistid', mbid) + if (kwargs.get('albumartist', False) and + kwargs.get('albumartist') != 'Various Artists'): + name = kwargs.get('albumartist').split(', ')[0] + if (kwargs.get('musicbrainz_albumartistid', False) and + kwargs.get('musicbrainz_albumartistid') != '89ad4ac3-39f7-470e-963a-56509c546377'): + mbid = kwargs.get('musicbrainz_albumartistid').split(', ')[0] + super().__init__(name=name, mbid=mbid) + +class MetaContainer(Set): + + def __init__(self, iterable): + self.elements = lst = [] + for value in iterable: + if value not in lst: + lst.append(value) else: - raise NotSameArtist('different mbids: {0} and {1}'.format(self, other)) + for inlst in lst: + if value == inlst: + inlst.add_alias(value) + def __iter__(self): + return iter(self.elements) -class TrackMB(Track): + def __contains__(self, value): + return value in self.elements - def __init__(self, **kwargs): - super().__init__(**kwargs) - if hasattr(self, 'musicbrainz_artistid'): - self.artist = Artist(mbid=self.musicbrainz_artistid, - name=self.artist) + def __len__(self): + return len(self.elements) -# vim: ai ts=4 sw=4 sts=4 expandtab + def __repr__(self): + return repr(self.elements) +# VIM MODLINE +# vim: ai ts=4 sw=4 sts=4 expandtab