Декоратори класу в Python: випадки практичного використання

Я шукаю випадки практичного та несинтетичного використання декораторів класу Python. Поки єдиний випадок, який для мене мав сенс, - це реєстрація класу в системі видавця-підписника, наприклад плагіни або події, щось на кшталт:

@register
class MyPlugin(Plugin):
    pass

або

@recieves_notifications
class Console:
    def print(self, text):
        ...

Будь-які інші розумні випадки, про які я думав, могли бути побудовані на основі успадкування, метакласів або методів декорування. Чи можете ви поділитися будь-якими хорошими (чи поганими!) Прикладами використання декораторів класу?

Дякую!

При написанні одиничних тестів, які мають @unittest.skipIfі @unittest.skipUnlessможуть бути використані або окремі методи, або для визначення цілого unittest.TestCaseкласу. Це значно спрощує написання тестів для певних проблем на платформі.

Приклад від asyncio/test_selectors

# Some platforms don't define the select.kqueue object for these tests.
# On those platforms, this entire grouping of tests will be skipped.

@unittest.skipUnless(hasattr(selectors, 'KqueueSelector'),
                 "Test needs selectors.KqueueSelector)")
class KqueueSelectorTestCase(BaseSelectorTestCase, ScalableSelectorMixIn):
...

Декоратори класів були явно створені, щоб зробити деякі речі, які вже були виразні за допомогою метакласів, більш приємними від PEP :

Мотивуючий випадок використання полягав у тому, щоб зробити деякі конструкції легше вираженими та менш залежними від деталей реалізації інтерпретатора CPython. Незважаючи на те, що можна виразити функціональність декораторів класу за допомогою метакласів, результати, як правило, неприємні, а реалізація дуже неміцна. Крім того, метакласи успадковуються, тоді як декоратори класів не є, що робить метакласи непридатними для деяких, специфічних для класу використання декораторів класів. Той факт, що масштабні проекти Python, такі як Zope, проходили через ці дикі викривлення, щоб досягти чогось подібного, як декоратори класу, перемогли над BDFL.

З цього питання про переповнення стека:

def singleton(class_):
  instances = {}
  def getinstance(*args, **kwargs):
    if class_ not in instances:
        instances[class_] = class_(*args, **kwargs)
    return instances[class_]
  return getinstance

@singleton
class MyClass(BaseClass):
  pass

Шукати випадки використання, які можна зробити з декораторами на заняттях, марно - все, що можна зробити з декораторами на заняттях, можна зробити з метакласами. Навіть ваш приклад реєстрації. Щоб довести це, ось метаклас, який застосовує декоратор:

Пітон 2:

def register(target):
    print 'Registring', target
    return target


class ApplyDecorator(type):
    def __new__(mcs, name, bases, attrs):
        decorator = attrs.pop('_decorator')
        cls = type(name, bases, attrs)
        return decorator(cls)

    def __init__(cls, name, bases, attrs, decorator=None):
        super().__init__(name, bases, attrs)


class Foo:
    __metaclass__ = ApplyDecorator
    _decorator = register

Пітон 3:

def register(target):
    print('Registring', target)
    return target


class ApplyDecorator(type):
    def __new__(mcs, name, bases, attrs, decorator):
        cls = type(name, bases, attrs)
        return decorator(cls)

    def __init__(cls, name, bases, attrs):
        super().__init__(name, bases, attrs)


class Foo(metaclass=ApplyDecorator, decorator=register):
    pass