Что является экземпляром метакласса (metaclass)?

Экземпляры метаклассов в Python

Метакласс — это класс, чьими экземплярами являются классы. Это может звучать запутанно, но это мощный инструмент для глубокого программирования на Python.

Иерархия объектов в Python

# Обычный объект — экземпляр класса
class Dog:
    pass

my_dog = Dog()  # my_dog — экземпляр класса Dog
type(my_dog)  # <class 'Dog'>

# Класс — это тоже объект, экземпляр метакласса
type(Dog)  # <class 'type'>

# Метакласс 'type' — это метакласс класса Dog
# Получается: my_dog — экземпляр Dog, Dog — экземпляр type

Что является экземпляром метакласса

Экземпляром метакласса является класс.

# type — встроенный метакласс по умолчанию
class MyClass:
    pass

print(type(MyClass))  # <class 'type'>
print(isinstance(MyClass, type))  # True

# Каждый класс в Python — экземпляр type (или подкласса type)
print(isinstance(int, type))  # True
print(isinstance(str, type))  # True
print(isinstance(list, type))  # True

Создание собственного метакласса

# Метакласс — подкласс type
class MyMetaclass(type):
    def __new__(mcs, name, bases, namespace):
        print(f"Creating class {name}")
        return super().__new__(mcs, name, bases, namespace)

    def __init__(cls, name, bases, namespace):
        print(f"Initializing class {name}")
        super().__init__(name, bases, namespace)

# Используем метакласс в определении класса
class MyClass(metaclass=MyMetaclass):
    pass

# Выведет:
# Creating class MyClass
# Initializing class MyClass

Как работает создание класса с метаклассом

Когда интерпретатор встречает определение класса:

class MyClass(BaseClass):
    x = 10
    def method(self):
        pass

Он вызывает метакласс так:

MyClass = MyMetaclass(
    "MyClass",  # name
    (BaseClass,),  # bases (родительские классы)
    {"x": 10, "method": <function>}  # namespace (атрибуты класса)
)

Практический пример: автоматическое создание методов

class AutoReprMeta(type):
    """Метакласс, добавляющий __repr__ к классам"""
    
    def __new__(mcs, name, bases, namespace):
        # Получаем все атрибуты класса
        attrs = [k for k in namespace.keys() if not k.startswith('_')]
        
        def __repr__(self):
            items = ", ".join(f"{k}={getattr(self, k)!r}" for k in attrs)
            return f"{name}({items})"
        
        namespace['__repr__'] = __repr__
        return super().__new__(mcs, name, bases, namespace)

class Person(metaclass=AutoReprMeta):
    def __init__(self, name, age):
        self.name = name
        self.age = age

p = Person("Alice", 30)
print(p)  # Person(name='Alice', age=30)

Проверка метакласса

class CustomMeta(type):
    pass

class MyClass(metaclass=CustomMeta):
    pass

print(type(MyClass))  # <class 'CustomMeta'>
print(isinstance(MyClass, CustomMeta))  # True
print(isinstance(MyClass, type))  # True (CustomMeta наследует от type)

Когда использовать метаклассы

• Валидация класса при его создании
• Автоматическое добавление методов ко всем классам с метаклассом
• Реестр классов — отслеживание всех созданных классов
• Декораторы на уровне класса — альтернатива декораторам функций
• ORM системы (Django ORM, SQLAlchemy) — для отслеживания полей моделей

Пример с реестром классов

class PluginRegistry(type):
    plugins = {}
    
    def __new__(mcs, name, bases, namespace):
        cls = super().__new__(mcs, name, bases, namespace)
        if name != 'PluginBase':
            mcs.plugins[name] = cls
        return cls

class PluginBase(metaclass=PluginRegistry):
    pass

class PluginA(PluginBase):
    pass

class PluginB(PluginBase):
    pass

print(PluginRegistry.plugins)  # {'PluginA': <class PluginA>, 'PluginB': <class PluginB>}

Важные моменты

• Метаклассы создают классы так же, как классы создают объекты
• Экземпляр метакласса = класс
• type — главный метакласс для всех остальных классов
• Метаклассы сложны и нужны редко в реальных проектах
• Часто можно обойтись декораторами вместо метаклассов

Помните фразу Тима Петерса из Zen of Python: "Metaclasses are deeper magic than 99% of users should ever worry about."