__init__, __str__ и __repr__
Тема дорожной карты · Python Programming
__init__ — это инициализатор, а не конструктор (конструктор — __new__); он вызывается уже после создания объекта и настраивает его состояние. __str__ возвращает дружелюбную строку для конечного пользователя (print(obj) и str()), а __repr__ — однозначное представление для разработчика, в идеале пригодное для воссоздания объекта; если __str__ не определён, используется __repr__. Всегда реализуй __repr__ для классов, которые будешь отлаживать. Если нужен просто value-тип, посмотри на @dataclass — он сгенерирует все три метода автоматически.
Как это работает
init, str и repr в Python использует class для связи состояния (атрибуты) и поведения (методы). __init__ инициализирует экземпляры; первый параметр self — сам экземпляр. Методы бывают instance (self), class (@classmethod, cls) или static (@staticmethod). Наследование: class Sub(Base): — допускается множественное; Method Resolution Order (MRO) считается C3-линеаризацией. Dunder-методы (__add__, __len__, __iter__) встраиваются в синтаксис Python (перегрузка операторов, len(), for). @property даёт attribute-like доступ с логикой геттера.
Когда применять
Класс — когда (а) состояние и поведение принадлежат вместе, (б) есть несколько связанных операций над теми же данными, (в) функция с кучей параметров была бы яснее как self-contained объект. Не создавайте класс, если хватит функции или dataclass — Python это не Java; модули с набором функций часто бьют поверхностные иерархии классов. Композиция важнее наследования, кроме случаев настоящего "is-a".
Типичные ошибки
Ловушки init, str и repr: mutable атрибуты на уровне класса, общие между экземплярами (class C: items = [] — каждый C() делит этот список); глубокие иерархии наследования, скрывающие, где живёт поведение (используйте композицию или миксины, максимум 1-2 уровня); перегрузка __eq__ без __hash__ (объект становится unhashable, ломает ключи словаря); злоупотребление @staticmethod для того, что должно быть функцией модуля. __init__ короткий — тяжёлая работа в factory или classmethod.