Defines some object to handle audio file metadata
"""
+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}$'
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=<str>[, mbid=UUID4])
"""
+ use_mbid = True
def __init__(self, **kwargs):
- self.name = None
+ 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'):
- is_uuid4(kwargs.get('mbid'))
+ try:
+ is_uuid4(kwargs.get('mbid'))
+ self.__mbid = kwargs.pop('mbid')
+ except WrongUUID4:
+ self.log.warning('Wrong mbid {}:{}'.format(self.__name,
+ kwargs.get('mbid')))
# mbid immutable as hash rests on
- self.__mbid = kwargs.pop('mbid')
self.__dict__.update(**kwargs)
def __repr__(self):
return fmt.format(self.__class__.__name__, self)
def __str__(self):
- return self.name.__str__()
+ return self.__name.__str__()
def __eq__(self, other):
"""
if isinstance(other, Meta) and self.mbid and other.mbid:
if self.mbid and other.mbid:
return self.mbid == other.mbid
- else:
- return other.__str__() == self.__str__()
+ 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 id(self)
+ 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))
+
+ @property
+ def name(self):
+ return self.__name
@property
def mbid(self):
return self.__mbid
+ @property
+ def aliases(self):
+ return self.__aliases
+
+ @property
+ def names(self):
+ return self.__aliases | {self.__name,}
+
class Album(Meta):
class Artist(Meta):
- def __init__(self, name=None, **kwargs):
+ @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',
>>> artobj0 = Artist(**trk)
>>> artobj1 = Artist(name='Tool')
"""
- self.__aliases = set()
name = kwargs.get('artist', name)
- mbid = kwargs.get('musicbrainz_artistid', None)
+ mbid = kwargs.get('musicbrainz_artistid', mbid)
if (kwargs.get('albumartist', False) and
kwargs.get('albumartist') != 'Various Artists'):
name = kwargs.get('albumartist').split(', ')[0]
mbid = kwargs.get('musicbrainz_albumartistid').split(', ')[0]
super().__init__(name=name, mbid=mbid)
- def add_alias(self, other):
- if getattr(other, '__str__', None):
- if callable(other.__str__):
- self.__aliases |= {other.__str__()}
- elif isinstance(other, Artist):
- self.__aliases |= other._Artist__aliases
- else:
- raise MetaException('No __str__ method found in {!r}'.format(other))
-
- @property
- def names(self):
- return self.__aliases | {self.name,}
-
# VIM MODLINE
# vim: ai ts=4 sw=4 sts=4 expandtab