✧ Классы без рутины ✧

🚀 Запускаем

Вспомни класс героя: конструктор, __repr__, __eq__, и всё это ради трёх полей. Вот то же самое в пять строк. Запусти:

from dataclasses import dataclass


@dataclass
class Hero:
    name: str
    level: int = 1
    element: str = "Пиро"


amber = Hero("Эмбер", 80)
print(amber)
print(amber == Hero("Эмбер", 80))
print(amber.level)
Hero(name='Эмбер', level=80, element='Пиро')
True
80

Мы не писали ни __init__, ни __repr__, ни __eq__: декоратор @dataclass сделал это сам по списку полей с аннотациями. Поля со значением (level: int = 1) становятся необязательными.

📜 Теория: dataclass и Enum

Что умеет dataclass

from dataclasses import dataclass, field, asdict


@dataclass(order=True)
class Hero:
    level: int
    name: str
    skills: list[str] = field(default_factory=list)


team = [Hero(90, "Лиза"), Hero(80, "Эмбер"), Hero(80, "Кли")]
print(sorted(team)[0])                   # → Hero(level=80, name='Кли', skills=[])
print(asdict(team[0]))                   # → {'level': 90, 'name': 'Лиза', 'skills': []}
  • order=True добавляет сравнения: объекты сравниваются по полям по очереди, как кортежи, и их можно сортировать;
  • frozen=True запрещает менять поля после создания, и такие объекты можно класть в множества;
  • field(default_factory=list) — способ завести изменяемое поле по умолчанию. Писать skills: list = [] нельзя: это та же ловушка с общим списком, и dataclass не даст это сделать;
  • asdict превращает объект в словарь, удобно для json.dumps.

Порядок полей важен: сравнение идёт сверху вниз. Поэтому level стоит первым, когда сортируют по уровню.

__post_init__: проверка после создания

@dataclass
class Hero:
    name: str
    level: int = 1

    def __post_init__(self):
        if not 1 <= self.level <= 90:
            raise ValueError("Уровень от 1 до 90")

Метод __post_init__ dataclass вызывает сразу после генерируемого __init__. В нём удобно проверять значения и вычислять поля, которые зависят от других.

Enum: набор допустимых значений

from enum import Enum


class Element(Enum):
    PYRO = "Пиро"
    HYDRO = "Гидро"
    ANEMO = "Анемо"


e = Element("Гидро")             # по значению
print(e)                         # → Element.HYDRO
print(e.name, e.value)           # → HYDRO Гидро
print(Element.PYRO == e)         # → False

for element in Element:          # перебор в порядке объявления
    print(element.value)

Element("Лёд")                   # ValueError: 'Лёд' is not a valid Element

Enum — это фиксированный набор вариантов. Вместо строк, в которых легко ошибиться в опечатке ("Pyro", "pyro", "Пиро"), у тебя ровно столько значений, сколько перечислено. Неизвестное значение сразу выдаёт ValueError, а у редактора кода появляются подсказки. Перебор for element in Element идёт в порядке объявления.

Когда что брать

Нужен контейнер для данных (поля, сравнение, вывод) — @dataclass. Нужно, чтобы значение было одним из заранее известных — Enum. Нужно поведение со сложным внутренним состоянием — обычный класс. Они дружат: поле dataclass может иметь тип Element.

🧪 Попробуй сам

★★★

🎯 Задача: Герои в dataclass

10 очков

Напиши в файле heroes.py класс героя с помощью @dataclass. Файл main.py написан за тебя, трогать его не нужно. Он читает число n и n строк уровень имя [элемент], создаёт героев, печатает их по возрастанию (сортировка по уровню, затем по имени) и называет самого сильного.

Поля по порядку: level: int, name: str, element: str со значением по умолчанию "Пиро". Героев нужно уметь сравнивать (order=True). Если уровень вне диапазона от 1 до 90, при создании выбрасывается ValueError("Уровень от 1 до 90") (проверка в __post_init__); такого героя программа пропускает с пометкой.

Пример. Ввод:

3
90 Лиза Электро
80 Эмбер
95 Дракон

Вывод:

Пропускаю: Уровень от 1 до 90
Hero(level=80, name='Эмбер', element='Пиро')
Hero(level=90, name='Лиза', element='Электро')
Самый сильный: Лиза

Заготовка (кнопка у блока отправит её в песочницу):

from heroes import Hero

heroes = []
for _ in range(int(input())):
    parts = input().split()
    try:
        heroes.append(Hero(int(parts[0]), *parts[1:]))
    except ValueError as e:
        print("Пропускаю:", e)

for hero in sorted(heroes):
    print(hero)

if heroes:
    print("Самый сильный:", max(heroes).name)
★★★

🎯 Задача: Элементы и резонанс

25 очков

Напиши в файле elements.py перечисление элементов и две функции. Файл main.py написан за тебя, трогать его не нужно. Он читает одну строку с названиями элементов через пробел, пропускает неизвестные, а потом печатает, какие элементы встретились в отряде не менее двух раз (это резонанс).

  • Element(Enum) с семью значениями в таком порядке: Пиро, Гидро, Электро, Крио, Дендро, Анемо, Гео (значение — русское название);
  • parse(word) — возвращает элемент по названию или None, если такого нет;
  • resonance(elements) — возвращает список элементов, которых в elements не меньше двух, в порядке объявления в Element.

Пример. Ввод:

Крио Пиро Крио Пиро Лёд

Вывод:

Неизвестный элемент: Лёд
Резонанс: Пиро, Крио

Заготовка (кнопка у блока отправит её в песочницу):

from elements import parse, resonance

elements = []
for word in input().split():
    element = parse(word)
    if element is None:
        print(f"Неизвестный элемент: {word}")
    else:
        elements.append(element)

found = resonance(elements)
print("Резонанс: " + ", ".join(e.value for e in found) if found else "Резонанса нет")

✅ Что мы узнали

@dataclass по списку полей сам создаёт __init__, __repr__ и __eq__; параметры order, frozen и field(default_factory=…) добавляют сортировку, неизменяемость и безопасные значения по умолчанию; проверки пишут в __post_init__. Enum задаёт набор допустимых вариантов, и неверное значение сразу отвергается.

Остался приём, которым можно оборачивать функции и классы: декораторы.

⟵ Договариваемся об интерфейсе Оборачиваем функции ⟶