Source code for coalib.bearlib.aspects.meta

import re

from inspect import getmembers, signature

from coala_utils.decorators import generate_repr

from .base import aspectbase
from .docs import Documentation
from .exceptions import AspectTypeError
from .taste import Taste


[docs]class aspectclass(type): """ Metaclass for aspectclasses. Root aspectclass is :class:`coalib.bearlib.aspects.Root`. """ def __init__(cls, clsname, bases, clsattrs): """ Initializes the ``.subaspects`` dict on new aspectclasses. """ cls.subaspects = {} @property def tastes(cls): """ Get a dictionary of all taste names mapped to their :class:`coalib.bearlib.aspects.Taste` instances. """ if cls.parent: return dict(cls.parent.tastes, **cls._tastes) return dict(cls._tastes)
[docs] def subaspect(cls, subcls): """ The sub-aspectclass decorator. See :class:`coalib.bearlib.aspects.Root` for description and usage. """ aspectname = subcls.__name__ sub_qualname = '%s.%s' % (cls.__qualname__, aspectname) docs = getattr(subcls, 'docs', None) aspectdocs = Documentation(subcls.__doc__, **{ attr: getattr(docs, attr, '') for attr in list(signature(Documentation).parameters.keys())[1:]}) # search for tastes in the sub-aspectclass subtastes = {} for name, member in getmembers(subcls): if isinstance(member, Taste): # tell the taste its own name member.name = name # tell its owner name member.aspect_name = sub_qualname subtastes[name] = member class Sub(subcls, aspectbase, metaclass=aspectclass): __module__ = subcls.__module__ parent = cls docs = aspectdocs _tastes = subtastes members = sorted(Sub.tastes) if members: Sub = generate_repr(*members)(Sub) Sub.__name__ = aspectname Sub.__qualname__ = sub_qualname cls.subaspects[aspectname] = Sub setattr(cls, aspectname, Sub) return Sub
def __repr__(cls): return '<%s %s>' % (type(cls).__name__, repr(cls.__qualname__))
[docs]def isaspect(item): """ This function checks whether or not an object is an ``aspectclass`` or an instance of ``aspectclass`` """ return isinstance(item, (aspectclass, aspectbase))
[docs]def assert_aspect(item): """ This function raises ``AspectTypeError`` when an object is not an ``aspectclass`` or an instance of ``aspectclass`` """ if not isaspect(item): raise AspectTypeError(item) return item
[docs]def issubaspect(subaspect, aspect): """ This function checks whether or not ``subaspect`` is a subaspect of ``aspect``. """ subaspect = assert_aspect(subaspect) aspect = assert_aspect(aspect) aspect_qualname = (aspect.__qualname__ if isinstance( aspect, aspectclass) else type(aspect).__qualname__) subaspect_qualname = (subaspect.__qualname__ if isinstance( subaspect, aspectclass) else type(subaspect).__qualname__) return re.match(aspect_qualname+r'(\.|$)', subaspect_qualname) is not None