🏗️ ООП и модель объектов

Короткий ответ Дескриптор позволяет один раз описать логику валидации/преобразования и переиспользовать её декларативно на множестве полей многих классов без повторения кода property для каждого поля, но переносит часть логики на менее очевидный уровень протокола __get__/__set__, что увеличивает порог входа для разработчиков, не знакомых с этим механизмом, и усложняет отладку по сравнению с явным property на каждом поле. Как это работает подробнее Дескриптор — объект, определяющий __get__, __set__ и/или __delete__, который при присвоении атрибуту класса (не экземпляра) перехватывает доступ к этому имени у всех экземпляров класса: instance.field фактически вызывает Field.__get__(descriptor, instance, owner), а instance.field = value — Field.__set__(descriptor, instance, value). В отличие от property, которая создаётся заново для каждого атрибута через декоратор прямо в классе, дескриптор — это отдельный переиспользуемый класс, который можно параметризовать (тип, диапазон значений, обязательность) и применять к

Читать полностьюcustom-exceptions

Короткий ответ Python требует, чтобы равные по __eq__ объекты имели одинаковый хеш (__hash__) для корректной работы в set и как ключи dict; если переопределить __eq__ и не переопределить __hash__, Python по умолчанию делает объект нехешируемым (__hash__ становится None), и попытка положить его в set/словарь приведёт к TypeError. Как это работает подробнее Контракт хеш-таблиц: если a == b, то должно быть hash(a) == hash(b) — иначе два "равных" объекта могут попасть в разные корзины хеш-таблицы, и словарь/множество перестанет находить уже добавленный эквивалентный элемент. Как только класс явно определяет __eq__, Python автоматически отключает унаследованный __hash__ (устанавливает его в None), чтобы не нарушить этот контракт случайно, — хеш нужно либо переопределить согласованно с __eq__, либо явно оставить класс нехешируемым. Пример кода Что использовать на практике Практика. Хеш обычно строят из тех же полей, которые участвуют в сравнении равенства, оборачивая их в hash((self.field1, self.field2)). Для измен

Читать полностьюequality

Короткий ответ Немедленно сделать поле обязательным в коде и в сериализованном формате — это breaking change для всех, кто создаёт объект без нового поля или десериализует старые сообщения без него; безопасная эволюция обычно идёт через добровольный (optional) этап: поле добавляется с безопасным значением по умолчанию или как Optional, старые данные продолжают десериализоваться, а переход к реально обязательному полю выполняется отдельным скоординированным этапом с поддержкой потребителей и периодом депрекации. Как это работает подробнее Если поле добавлено как field: NewType без значения по умолчанию в существующий @dataclass, любой код, создающий объект позиционными/именованными аргументами без этого поля, немедленно перестанет работать (TypeError: missing required argument), а код, десериализующий старые JSON-сообщения без этого поля в словарь и передающий его как data в конструктор, упадёт точно так же. Добавление поля со значением по умолчанию (field: NewType = default или Optional[NewType] = None) сохра

Читать полностьюdataclass

Короткий ответ __str__ предназначен для читаемого, ориентированного на человека представления объекта и используется функцией print() и str(obj); __repr__ предназначен для однозначного, по возможности воссоздаваемого (eval-able) представления, полезного для отладки и логов, и используется интерактивной консолью при выводе значения без print, а также как резервный вариант, если __str__ не определён. Как это работает подробнее str(obj) вызывает obj.__str__(), а если класс его не определяет — падает обратно на obj.__repr__(). repr(obj) всегда вызывает именно obj.__repr__(). Интерактивная консоль и Jupyter при выводе значения ячейки без явного print используют repr(), что объясняет, почему объект может "выглядеть по-разному" при print(obj) и при простом вводе obj в REPL, если оба метода переопределены по-разному. Пример кода Что использовать на практике Практика. Хорошей практикой считается всегда реализовывать __repr__ так, чтобы по нему можно было понять точное состояние объекта для отладки — по соглашению, в и

Читать полностьюobject-model

Короткий ответ Метод экземпляра — это функция, определённая внутри класса, которая автоматически получает первым аргументом сам объект, на котором её вызвали (self), что даёт методу доступ к атрибутам и другим методам этого конкретного экземпляра. Как это работает подробнее Когда вы пишете obj.method(arg), Python фактически вызывает ClassName.method(obj, arg) — self связывается с объектом автоматически через механизм дескрипторов функций (bound method). Внутри метода self.attr обращается к атрибуту именно этого экземпляра. Пример кода Что использовать на практике Практика. self — это просто соглашение об имени (можно назвать иначе, но так не делают), и он обязателен как первый параметр любого обычного метода, не являющегося staticmethod. Через self методы читают и изменяют состояние объекта, вызывают другие методы того же объекта (self.other_method()). Подводные камни Риски. Забывают указать self в сигнатуре метода и получают TypeError: method() takes 0 positional arguments but 1 was given при вызове. Также п

Читать полностьюclasses

Короткий ответ __slots__ объявляет фиксированный, заранее известный набор атрибутов экземпляра и запрещает Python создавать для каждого объекта отдельный __dict__ для произвольных атрибутов — это уменьшает потребление памяти на больших количествах экземпляров, но не позволяет добавлять атрибуты, не перечисленные в __slots__, и требует аккуратности при множественном наследовании. Как это работает подробнее Без __slots__ каждый экземпляр хранит свой словарь атрибутов __dict__, который сам по себе занимает заметный объём памяти, особенно при создании миллионов небольших объектов. __slots__ = ("x", "y") заставляет Python выделить для каждого атрибута компактный дескриптор на уровне класса (slot), а у экземпляров не создаётся __dict__ вообще, что экономит память и немного ускоряет доступ к атрибутам. Пример кода Что использовать на практике Практика. __slots__ имеет смысл применять к классам, которые создаются в больших количествах (элементы кэша, узлы структур данных, DTO в горячем пути), и для которых набор атри

Читать полностьюmemory

Короткий ответ __init__ — это метод-инициализатор, который вызывается автоматически сразу после создания нового объекта класса и используется для присвоения начальных значений атрибутам этого экземпляра; он не создаёт сам объект, а только настраивает уже созданный. Как это работает подробнее Когда пишут obj = MyClass(arg1, arg2), Python сначала вызывает __new__, который фактически создаёт и возвращает новый пустой объект, а затем автоматически вызывает __init__(obj, arg1, arg2) на этом объекте. Для подавляющего большинства классов __new__ переопределять не нужно — достаточно __init__, чтобы задать стартовое состояние. Пример кода Что использовать на практике Практика. В __init__ обычно присваивают переданные аргументы атрибутам через self.attr = value, выполняют простую валидацию входных данных и, при необходимости, вызывают __init__ родительского класса через super().__init__(...), если класс использует наследование. Подводные камни Риски. Путают __init__ с конструктором в смысле "создания объекта" — объект

Читать полностьюdunder-methods

Короткий ответ Diamond problem возникает, когда класс наследуется от двух классов, у которых есть общий предок, и возникает неоднозначность, какую версию метода общего предка должен получить итоговый класс; Python решает это не "напрямую к родителю", а через единый порядок MRO (C3-линеаризацию), благодаря чему super() в каждом классе переходит к следующему классу по этому общему порядку, и общий предок вызывается ровно один раз, а не дважды. Как это работает подробнее Если ClassD(ClassB, ClassC), а ClassB и ClassC оба наследуются от ClassA, наивная реализация (вызов родителя "в лоб" по имени класса) привела бы к тому, что метод ClassA может быть вызван дважды — один раз через цепочку B, второй раз через C. MRO выстраивает единый линейный порядок [D, B, C, A, object], и каждый super().method() в B и C переходит не прямо к A, а к следующему классу в этом общем порядке, поэтому A вызывается один раз, независимо от того, сколько путей к нему ведёт. Пример кода Что использовать на практике Практика. Это особенно в

Читать полностьюinheritance

Короткий ответ MRO — это детерминированный порядок, в котором Python ищет метод или атрибут по цепочке классов при множественном наследовании, вычисляемый по алгоритму C3-линеаризации; узнать точный порядок для конкретного класса можно через ClassName.__mro__ или ClassName.mro(). Как это работает подробнее C3-линеаризация строит порядок так, чтобы класс всегда шёл раньше своих родителей, а относительный порядок родителей, указанных в определении класса, сохранялся — это даёт единый непротиворечивый порядок обхода даже для сложных диаграмм наследования. super() внутри метода использует именно этот порядок, переходя к следующему классу в MRO текущего экземпляра, а не напрямую к "родителю" в обычном понимании. Пример кода Что использовать на практике Практика. Понимание MRO важно для классов-миксинов (mixin), где функциональность собирается из нескольких небольших классов: порядок перечисления родителей в class Combined(MixinA, MixinB, Base): определяет, какая реализация метода будет вызвана первой. При конфликт

Читать полностьюinheritance