"""Что декоратор класса может и чего не может — по прогону, а не по таблице.

ЗАЧЕМ ЭТОТ ФАЙЛ. В уроке стояла таблица возможностей, где у декоратора класса
было «не может изменить имя, базы или пространство имён». Аудит возразил:
декоратор получает ГОТОВЫЙ объект класса, а с готовым классом можно многое —
и переименовать, и подменить целиком. Прав он или нет, решает не спор, а
запуск: у каждой строки таблицы здесь есть свой блок, и печатается то, что
получилось на самом деле, включая тип ошибки, если её не миновать.

ГРАНИЦА, КОТОРУЮ ЭТОТ ФАЙЛ ПРОВОДИТ. Она проходит не по «может/не может», а по
ВРЕМЕНИ: до создания класса (пространство имён, базы, аргументы type.__new__)
или после (готовый объект). Декоратор всегда после; метакласс — и до, и во
время, и после. Поэтому таблица должна сравнивать не силу, а момент.

ЗАПУСК: python3.13 bench/metaclass/decorator_capabilities.py
Вывод по версиям: runs/decorator_capabilities-3.11.txt и соседние.
"""

import sys

EVENTS: list[str] = []


def show(title: str) -> None:
    print()
    print(title)
    print("-" * len(title))


def result(label: str, value: object) -> None:
    print(f"  {label:<52} {value}")


def attempt(label: str, fn) -> None:
    """Печатает результат или ТИП ошибки.

    Текст сообщений между версиями меняется, тип — нет; в таблице урока речь о
    возможности, а не о формулировке.
    """
    try:
        result(label, fn())
    except Exception as exc:  # noqa: BLE001 — тип и есть ответ
        result(label, f"{type(exc).__name__}")


# ------------------------------------------------------------------ 1
def block1() -> None:
    show("1. Декоратор получает класс уже созданным")

    class Watcher:
        def __set_name__(self, owner, name):
            EVENTS.append(f"__set_name__ увидел класс с именем {owner.__name__!r}")

    def decorator(cls):
        EVENTS.append(f"декоратор получил класс с именем {cls.__name__!r}")
        return cls

    EVENTS.clear()

    @decorator
    class Sample:
        field = Watcher()

    for line in EVENTS:
        result("порядок:", line)
    result("то есть декоратор работает:", "после __set_name__ и после type.__new__")


# ------------------------------------------------------------------ 2
def block2() -> None:
    show("2. Что декоратор с готовым классом всё-таки может")

    def rename(cls):
        cls.__name__ = "Переименован"
        cls.added = "добавлено декоратором"
        return cls

    @rename
    class Sample:
        original = "было в теле"

    result("__name__ после декоратора", Sample.__name__)
    result("новый атрибут виден", Sample.added)
    result("старый атрибут на месте", Sample.original)

    def replace(cls):
        return type("Подменённый", (), {"kind": "совсем другой объект"})

    @replace
    class Other:
        kind = "из тела класса"

    result("декоратор вернул другой класс: имя", Other.__name__)
    result("и его содержимое", Other.kind)


# ------------------------------------------------------------------ 3
def block3() -> None:
    show("3. Базы: присваивание __bases__ разрешено не всегда")

    class Base:
        pass

    class Another:
        pass

    class OnObject:
        pass

    class OnBase(Base):
        pass

    attempt(
        "класс на object: __bases__ = (Base,)",
        lambda: (setattr(OnObject, "__bases__", (Base,)), OnObject.__mro__[1].__name__)[1],
    )
    attempt(
        "класс на Base: __bases__ = (Another,)",
        lambda: (setattr(OnBase, "__bases__", (Another,)), OnBase.__mro__[1].__name__)[1],
    )
    result("вывод", "«не может менять базы» — не про декоратор, а про правила смены __bases__")


# ------------------------------------------------------------------ 4
def block4() -> None:
    show("4. Пространство имён: единственное, чего декоратор не застаёт")

    class OrderedNamespace(dict):
        def __setitem__(self, key, value):
            EVENTS.append(f"в пространство имён кладут {key!r}")
            super().__setitem__(key, value)

    class Meta(type):
        @classmethod
        def __prepare__(mcls, name, bases, **kwargs):
            EVENTS.append("__prepare__ дал своё отображение")
            return OrderedNamespace()

        def __new__(mcls, name, bases, ns, **kwargs):
            EVENTS.append(f"Meta.__new__ видит имена: {[k for k in ns if not k.startswith('__')]}")
            return super().__new__(mcls, name, bases, dict(ns), **kwargs)

    EVENTS.clear()

    def decorator(cls):
        EVENTS.append("декоратор: тело уже выполнено, класс собран")
        return cls

    @decorator
    class Sample(metaclass=Meta):
        a = 1
        b = 2

    for line in EVENTS:
        result("порядок:", line)
    result("вывод", "тело выполняется в отображении из __prepare__ — до декоратора")


def main() -> None:
    print(f"Python {sys.version.split()[0]} ({sys.implementation.name})")
    block1()
    block2()
    block3()
    block4()


if __name__ == "__main__":
    main()