# -*- coding: utf-8 -*-
-# Copyright (c) 2013, 2014 Jack Kaliko <kaliko@azylum.org>
+# Copyright (c) 2013, 2014, 2015 Jack Kaliko <kaliko@azylum.org>
#
# This file is part of sima
#
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}$'
+# The Track Object is collapsing multiple tags into a single string using this
+# separator. It is used then to split back the string to tags list.
+SEPARATOR = chr(0x1F) # ASCII Unit Separator
def is_uuid4(uuid):
regexp = re.compile(UUID_RE, re.IGNORECASE)
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])
+
+ Using generic kwargs in constructor for convenience but the actual signature is:
+
+ >>> Meta(name, mbid=None, **kwargs)
+
+ :param string name: set name attribute
+ :param string mbid: set MusicBrainz ID (optional)
"""
+ use_mbid = True
def __init__(self, **kwargs):
+ """Meta(name=<str>[, mbid=UUID4])"""
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').lower()
+ except WrongUUID4:
+ self.log.warning('Wrong mbid %s:%s', self.__name,
+ kwargs.get('mbid'))
# mbid immutable as hash rests on
- self.__mbid = kwargs.pop('mbid')
self.__dict__.update(**kwargs)
def __repr__(self):
"""
#if hasattr(other, 'mbid'): # better isinstance?
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__() or
- other.__str__() in self.__aliases)
+ 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):
def add_alias(self, other):
if getattr(other, '__str__', None):
- if callable(other.__str__):
+ if callable(other.__str__) and other.__str__() != self.name:
self.__aliases |= {other.__str__()}
elif isinstance(other, Meta):
- self.__aliases |= other.__aliases
+ if other.name != self.name:
+ self.__aliases |= other.__aliases
else:
raise MetaException('No __str__ method found in {!r}'.format(other))
class Album(Meta):
+ """Album object"""
@property
def album(self):
return self.name
class Artist(Meta):
+ """Artist object deriving from :class:`Meta`.
+
+ :param string name: Artist name, default ``None``
+ :param string mbid: Musicbrainz artist ID, defautl ``None``
+ :param string artist: Overrides "name" argument
+ :param string albumartist: Overrides "name" and "artist" argument
+ :param string musicbrainz_artistid: Overrides "mbid" argument
+ :param string musicbrainz_albumartistid: Overrides "musicbrainz_artistid" argument
+
+ :Example:
+
+ >>> trk = {'artist':'Art Name',
+ >>> 'albumartist': 'Alb Art Name', # optional
+ >>> 'musicbrainz_artistid': '<UUID4>', # optional
+ >>> 'musicbrainz_albumartistid': '<UUID4>', # optional
+ >>> }
+ >>> artobj0 = Artist(**trk)
+ >>> artobj1 = Artist(name='Tool')
+ """
+ @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': '<UUID4>' , # optional
- >>> 'musicbrainz_albumartistid': '<UUID4>', # optional
- >>> }
- >>> artobj0 = Artist(**trk)
- >>> artobj1 = Artist(name='Tool')
- """
- name = kwargs.get('artist', name)
- mbid = kwargs.get('musicbrainz_artistid', mbid)
+ if kwargs.get('artist', False):
+ name = kwargs.get('artist').split(SEPARATOR)[0]
+ if kwargs.get('musicbrainz_artistid', False):
+ mbid = kwargs.get('musicbrainz_artistid').split(SEPARATOR)[0]
if (kwargs.get('albumartist', False) and
kwargs.get('albumartist') != 'Various Artists'):
- name = kwargs.get('albumartist').split(', ')[0]
+ name = kwargs.get('albumartist').split(SEPARATOR)[0]
if (kwargs.get('musicbrainz_albumartistid', False) and
kwargs.get('musicbrainz_albumartistid') != '89ad4ac3-39f7-470e-963a-56509c546377'):
- mbid = kwargs.get('musicbrainz_albumartistid').split(', ')[0]
+ mbid = kwargs.get('musicbrainz_albumartistid').split(SEPARATOR)[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:
+ for inlst in lst:
+ if value == inlst:
+ inlst.add_alias(value)
+
+ def __iter__(self):
+ return iter(self.elements)
+
+ def __contains__(self, value):
+ return value in self.elements
+
+ def __len__(self):
+ return len(self.elements)
+
+ def __repr__(self):
+ return repr(self.elements)
+
# VIM MODLINE
# vim: ai ts=4 sw=4 sts=4 expandtab
home / dev / repositories / mpd-sima.git / blobdiff