Декораторы классов в 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

Поиск вариантов использования, которые можно выполнить с помощью декораторов классов, бесполезен - все, что можно сделать с помощью декораторов классов, можно сделать с помощью метаклассов. Даже ваш пример регистрации. Чтобы доказать это, вот метакласс, который применяет декоратор:

Python 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

Python 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