Что такое метакласс и когда он реально нужен?

Пример: registry через метакласс

class RegistryMeta(type):
    registry: dict[str, type] = {}

    def __new__(mcls, name, bases, namespace, **kw):
        cls = super().__new__(mcls, name, bases, namespace)
        if bases:  # пропускаем сам корневой Plugin
            mcls.registry[name] = cls
        return cls


class Plugin(metaclass=RegistryMeta):
    pass


class CsvPlugin(Plugin):
    fmt = "csv"


class JsonPlugin(Plugin):
    fmt = "json"


print(RegistryMeta.registry)
# {'CsvPlugin': <class CsvPlugin>, 'JsonPlugin': <class JsonPlugin>}

Что это

В Python всё, включая классы, — объекты. Класс класса (то, что создаёт класс) называется метаклассом. По умолчанию это type. class Foo: ... эквивалентно Foo = type("Foo", (), {...}).

Пользовательский метакласс задаётся через class Foo(metaclass=Meta):. Meta наследуется от type и переопределяет хуки создания класса.

Этапы создания класса

1. Выбор метакласса: явно через metaclass=, иначе — общий предок метаклассов всех баз.
2. Meta.__prepare__(name, bases, **kwds) — возвращает namespace (по умолчанию dict). Можно вернуть OrderedDict/специальный mapping, чтобы перехватить присваивания в теле класса.
3. Тело класса исполняется в этом namespace.
4. Meta.__new__(mcls, name, bases, namespace, **kwds) — создаёт объект класса.
5. Meta.__init__(cls, name, bases, namespace, **kwds) — пост-инициализация.
6. __set_name__ у дескрипторов, __init_subclass__ у базы — вызываются на этапе создания.

Когда метакласс реально нужен

• Framework declarative bases: SQLAlchemy DeclarativeMeta, Django ModelBase, Pydantic v1 ModelMetaclass — собирают поля, строят mapper, инсталлируют дескрипторы.
• ABCs: abc.ABCMeta регистрирует виртуальные подклассы через register(), проверяет abstract-методы.
• Перехват синтаксиса класса: например, разрешить дублирующиеся имена и собирать их в список (через __prepare__ с особым dict).
• Плагинная регистрация всех наследников в registry.
• Type-level контроль: запретить наследование, добавить обязательные атрибуты, форсировать namespace.

Почти всегда достаточно более простых средств

• __init_subclass__ (PEP 487, 3.6+) — хук на создание подкласса, без метакласса. Покрывает 80% сценариев регистрации.
• Class decorator — функция, которая принимает класс и возвращает класс (или модифицирует). Чище читается, проще тестируется.
• __set_name__ у дескрипторов — для привязки к имени атрибута без метакласса.

То же через __init_subclass__ (проще)

class Plugin:
    registry: dict[str, type] = {}

    def __init_subclass__(cls, **kw):
        super().__init_subclass__(**kw)
        Plugin.registry[cls.__name__] = cls


class CsvPlugin(Plugin):
    fmt = "csv"


print(Plugin.registry)  # {'CsvPlugin': <class CsvPlugin>}

Подводные камни

• Конфликт метаклассов при множественном наследовании: metaclass conflict — все базы должны иметь совместимый метакласс. Решается общим mcls-наследником.
• Метакласс делает код менее читаемым; junior-ы не понимают, откуда «магия». Документируйте.
• Тестирование классов с метаклассами сложнее — побочные эффекты на этапе импорта.
• Перепутать type(obj) и type как метакласс — две разные вещи.
• Использовать метакласс там, где достаточно __init_subclass__ или class-decorator — over-engineering.
• Pydantic, attrs, dataclass в современном виде НЕ требуют метакласс (или используют его легко); раньше pydantic v1 имел Metaclass, в v2 ушёл на __init_subclass__ и более тонкие хуки.

• Говорить, что метакласс нужен для любого factory.
• Не знать, что type — метакласс обычных классов.
• Не упоминать альтернативы.

• Объясняет classes are objects.
• Понимает этапы создания класса.
• Называет реальные framework-level use cases.