1 # -*- coding: utf-8 -*-
2 # Copyright (c) 2013, 2014 Jack Kaliko <kaliko@azylum.org>
4 # This file is part of sima
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.
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.
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/>.
21 Defines some object to handle audio file metadata
26 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}$'
29 regexp = re.compile(UUID_RE, re.IGNORECASE)
30 if regexp.match(uuid):
32 raise WrongUUID4(uuid)
34 class MetaException(Exception):
35 """Generic Meta Exception"""
38 class WrongUUID4(MetaException):
42 def wrapper(*args, **kwargs):
45 kwargs.pop('mbid', None)
46 kwargs.pop('musicbrainz_artistid', None)
47 kwargs.pop('musicbrainz_albumartistid', None)
53 """Generic Class for Meta object
54 Meta(name=<str>[, mbid=UUID4])
58 def __init__(self, **kwargs):
59 self.__name = None #TODO: should be immutable
61 self.__aliases = set()
62 if 'name' not in kwargs or not kwargs.get('name'):
63 raise MetaException('Need a "name" argument')
65 self.__name = kwargs.pop('name')
66 if 'mbid' in kwargs and kwargs.get('mbid'):
67 is_uuid4(kwargs.get('mbid'))
68 # mbid immutable as hash rests on
69 self.__mbid = kwargs.pop('mbid')
70 self.__dict__.update(**kwargs)
73 fmt = '{0}(name={1.name!r}, mbid={1.mbid!r})'
74 return fmt.format(self.__class__.__name__, self)
77 return self.__name.__str__()
79 def __eq__(self, other):
81 Perform mbid equality test
83 #if hasattr(other, 'mbid'): # better isinstance?
84 if isinstance(other, Meta) and self.mbid and other.mbid:
85 if self.mbid and other.mbid:
86 return self.mbid == other.mbid
88 return (other.__str__() == self.__str__() or
89 other.__str__() in self.__aliases)
94 return hash(self.mbid)
95 return hash(self.__name)
97 def add_alias(self, other):
98 if getattr(other, '__str__', None):
99 if callable(other.__str__):
100 self.__aliases |= {other.__str__()}
101 elif isinstance(other, Meta):
102 self.__aliases |= other.__aliases
104 raise MetaException('No __str__ method found in {!r}'.format(other))
116 return self.__aliases
120 return self.__aliases | {self.__name,}
132 def __init__(self, name=None, mbid=None, **kwargs):
133 """Artist object built from a mapping dict containing at least an
135 >>> trk = {'artist':'Art Name',
136 >>> 'albumartist': 'Alb Art Name', # optional
137 >>> 'musicbrainz_artistid': '<UUID4>' , # optional
138 >>> 'musicbrainz_albumartistid': '<UUID4>', # optional
140 >>> artobj0 = Artist(**trk)
141 >>> artobj1 = Artist(name='Tool')
143 name = kwargs.get('artist', name)
144 mbid = kwargs.get('musicbrainz_artistid', mbid)
145 if (kwargs.get('albumartist', False) and
146 kwargs.get('albumartist') != 'Various Artists'):
147 name = kwargs.get('albumartist').split(', ')[0]
148 if (kwargs.get('musicbrainz_albumartistid', False) and
149 kwargs.get('musicbrainz_albumartistid') != '89ad4ac3-39f7-470e-963a-56509c546377'):
150 mbid = kwargs.get('musicbrainz_albumartistid').split(', ')[0]
151 super().__init__(name=name, mbid=mbid)
154 # vim: ai ts=4 sw=4 sts=4 expandtab