Что такое магические методы? Чем __str__ отличается от __repr__?

Python вызывает магические методы сам, когда вы используете встроенный синтаксис: len(x) → x.__len__(), a + b → a.__add__(b), a == b → a.__eq__(b), for → __iter__, with → __enter__/__exit__, obj() → __call__. Реализовав их, свой класс начинает вести себя как встроенный тип.

**__repr__ и __str__.**

• __repr__ — для отладки и логов: однозначно описывает объект, в идеале так, чтобы по строке можно было его воссоздать: Point(x=1, y=2). Его показывают консоль, отладчик и контейнеры: print([p]) выведет repr элементов.
• __str__ — для пользователя: print(p), str(p), f-строки.
• Если __str__ нет, используется __repr__; наоборот — нет. Поэтому писать стоит хотя бы __repr__.

Сравнение и хеш. Переопределив __eq__, нужно позаботиться о __hash__: иначе объект станет нехешируемым. Для упорядочивания хватит __eq__ и __lt__ с декоратором functools.total_ordering.

@dataclass генерирует __init__, __repr__ и __eq__ сам.

class Point:
    def __init__(self, x, y):
        self.x, self.y = x, y
    def __repr__(self):
        return f"Point(x={self.x}, y={self.y})"
    def __str__(self):
        return f"({self.x}, {self.y})"
    def __eq__(self, other):
        return isinstance(other, Point) and (self.x, self.y) == (other.x, other.y)
    def __hash__(self):
        return hash((self.x, self.y))

p = Point(1, 2)
print(p)       # (1, 2)
print([p])     # [Point(x=1, y=2)] — у элементов repr