Магические методы (dunder methods) — обзор

Python — очень «умный» язык. Когда вы пишете len(obj), print(obj) или a + b, Python не просто выполняет операцию — он ищет у вашего объекта специальный метод и вызывает его. Эти методы называют магическими или dunder-методами, и они открывают двери к подлинной интеграции ваших классов в экосистему Python.

🔤 Откуда название «dunder»

Вы уже знаете один такой метод — __init__. Обратите внимание: он начинается и заканчивается двойным подчёркиванием. В английском «двойное подчёркивание» — double underscore, которое сокращают до dunder. Произносится как «дандер».

Поэтому любой метод вида __что_то__ называют dunder-методом. Вот несколько примеров, которые вы встретите в этом уроке:

✨ Почему их называют «магическими»

Слово «магия» здесь — метафора для неявного автоматического поведения. Когда вы вызываете встроенную функцию или оператор Python, язык за кулисами ищет нужный dunder-метод и вызывает его. Вы этого «не видите» — отсюда и «магия».

Разберём три жизненных примера, чтобы это стало конкретным:

🗺️ Карта самых частых dunder-методов

Dunder-методов в Python несколько десятков, но на практике используется небольшой набор. Сгруппируем их по смыслу — так проще запомнить и найти нужный.

💻 Пример 1: len(obj) и метод __len__

Представьте класс Library — библиотека с книгами. Было бы удобно узнавать количество книг через len(library), как для обычного списка. Без __len__ это не работает. Давайте добавим его:

class Library:
    def __init__(self, name):
        self.name = name
        self.books = []  # Список книг в библиотеке

    def add_book(self, title):
        self.books.append(title)

    def __len__(self):
        # Python вызывает этот метод, когда пишут len(library)
        return len(self.books)


lib = Library("Городская библиотека")
lib.add_book("Война и мир")
lib.add_book("Преступление и наказание")
lib.add_book("Мастер и Маргарита")

# Теперь len() работает с нашим объектом!
print(len(lib))   # 3

# Что происходит «за кулисами»:
# len(lib)  →  lib.__len__()  →  3

Обратите внимание: внутри __len__ мы написали return len(self.books) — это нормально. self.books — обычный список Python, для него len() работает из коробки. Мы просто делегируем вычисление длины нашего объекта встроенному списку.

💻 Пример 2: оператор + и метод __add__

Создадим класс Vector — математический вектор (точка в пространстве). Векторы можно складывать: (1, 2) + (3, 4) = (4, 6). Чтобы оператор + работал между нашими объектами, нужно реализовать __add__:

class Vector:
    def __init__(self, x, y):
        self.x = x
        self.y = y

    def __add__(self, other):
        # Python вызывает этот метод, когда пишут v1 + v2
        # other — это второй операнд (правый от знака +)
        new_x = self.x + other.x
        new_y = self.y + other.y
        return Vector(new_x, new_y)  # Возвращаем НОВЫЙ вектор с суммой

    def __str__(self):
        return f"Vector({self.x}, {self.y})"


v1 = Vector(1, 2)
v2 = Vector(3, 4)

# Используем + между нашими объектами!
v3 = v1 + v2

print(v3)  # Vector(4, 6)

# Что происходит «за кулисами»:
# v1 + v2  →  v1.__add__(v2)  →  Vector(4, 6)

# Можно складывать цепочкой
v4 = Vector(0, 1)
result = v1 + v2 + v4
print(result)  # Vector(4, 7)

Заметьте: метод __add__ создаёт и возвращает новый объект Vector. Сами v1 и v2 остаются нетронутыми. Это соответствует тому, как работает сложение чисел: 3 + 4 не меняет тройку, а создаёт новое число 7.

💻 Пример 3: print(obj) без __str__ и с __str__

Пожалуй, самый частый dunder-метод после __init__. Посмотрим наглядно, что происходит, если его НЕТ, и как всё меняется, когда мы его добавляем:

# --- БЕЗ __str__ ---

class Book:
    def __init__(self, title, author, year):
        self.title = title
        self.author = author
        self.year = year


book = Book("Мастер и Маргарита", "Булгаков", 1967)

print(book)
# <__main__.Book object at 0x10b3a5f40>
# Некрасиво и бесполезно: адрес объекта в памяти.

print(str(book))
# <__main__.Book object at 0x10b3a5f40>
# То же самое.

# --- С __str__ ---

class Book:
    def __init__(self, title, author, year):
        self.title = title
        self.author = author
        self.year = year

    def __str__(self):
        # Этот метод вызывается при print(book) и str(book)
        return f'"{self.title}" — {self.author} ({self.year})'


book = Book("Мастер и Маргарита", "Булгаков", 1967)

print(book)
# "Мастер и Маргарита" — Булгаков (1967)
# Красиво, понятно, полезно!

print(str(book))
# "Мастер и Маргарита" — Булгаков (1967)

# Также работает в f-строках:
message = f"Рекомендую прочитать: {book}"
print(message)
# Рекомендую прочитать: "Мастер и Маргарита" — Булгаков (1967)

Правило: всегда определяйте хотя бы __repr__ в своих классах. Это сэкономит вам часы на отладке — вы всегда будете видеть осмысленный вывод вместо адреса в памяти.

🔬 Как Python связывает операцию с методом

Вот компактная таблица — что вы пишете в коде и что Python вызывает за кулисами:

📚 Где смотреть полный список

Dunder-методов в Python несколько десятков. Все они задокументированы в официальной документации Python в разделе, который называется «Data Model» (Модель данных):

Не пытайтесь выучить их все сразу — это не нужно. Работает принцип: столкнулся с задачей → посмотрел, какой dunder-метод её решает → реализовал. Со временем самые популярные запомнятся сами.

✅ Итоги урока

• Dunder = double underscore: методы вида __имя__. Называются «магическими», потому что Python вызывает их автоматически.
• Python вызывает dunder-методы при операциях: len(obj) → __len__, obj1 + obj2 → __add__, print(obj) → __str__.
• Реализуя dunder-методы, вы делаете свой класс «родным» в Python — он начинает поддерживать стандартные операции и синтаксис.
• Основные категории: жизненный цикл (__init__, __del__), вывод (__str__, __repr__), арифметика, сравнение, контейнеры, итерация, контекстные менеджеры.
• Вы не вызываете dunder-методы напрямую — Python делает это сам. Вы только определяете их.
• Полный список: docs.python.org/3/reference/datamodel.html. Выучивать всё сразу не нужно.

👉 В следующих уроках мы разберём каждую группу методов в деталях. Начнём с самых важных и практичных: __str__ и __repr__ — как делать читаемый вывод для ваших объектов. Затем реализуем арифметику и сравнения, и к концу модуля вы сможете строить классы, которые работают с Python «как родные».