Что такое Descriptor?
Дескриптор (Descriptor) — это особый объект в Python, который управляет тем, что происходит при обращении к атрибуту объекта: при его чтении, изменении или удалении. С помощью дескрипторов можно добавить дополнительную логику при доступе к атрибутам — например, проверять значение, преобразовывать его или фиксировать каждое обращение.
Проще говоря: дескриптор — это «охранник у двери» атрибута. Когда кто-то хочет прочитать атрибут или записать в него новое значение, сначала нужно пройти через охранника.
Как работает дескриптор?
Дескриптор — это класс, который определяет хотя бы один из следующих специальных методов:
- __get__(self, instance, owner) — вызывается при чтении атрибута.
- __set__(self, instance, value) — вызывается при записи нового значения. Здесь можно проверить корректность значения.
- __delete__(self, instance) — вызывается при удалении атрибута.
- __set_name__(self, owner, name) — вызывается один раз при создании дескриптора в классе и сообщает ему имя атрибута (начиная с Python 3.6).
⚠️ Важное правило: дескриптор работает только тогда, когда он определён как атрибут класса. Если записать его в атрибут экземпляра внутри __init__, эти методы вообще не будут вызываться.
Пример: проверка значения
Допустим, возраст и оценка ученика всегда должны быть положительными целыми числами. Вместо того чтобы писать проверку отдельно для каждого атрибута, создадим один дескриптор:
python
class PolozhitelnoeChislo:
def __set_name__(self, owner, name):
self.imya = "_" + name # например, "_vozrast"
def __get__(self, instance, owner):
if instance is None: # обращение через класс
return self
return getattr(instance, self.imya)
def __set__(self, instance, value):
if not isinstance(value, int) or value < 0:
raise ValueError(f"{self.imya[1:]} должен быть положительным целым числом")
setattr(instance, self.imya, value)
class Uchenik:
vozrast = PolozhitelnoeChislo() # дескриптор как атрибут класса
otsenka = PolozhitelnoeChislo() # тот же дескриптор для другого атрибута
def __init__(self, imya, vozrast, otsenka):
self.imya = imya
self.vozrast = vozrast # вызывается __set__ и выполняется проверка
self.otsenka = otsenka
u = Uchenik("Айсель", 14, 9)
print(u.vozrast) # 14
u.vozrast = -5 # ValueError: vozrast должен быть положительным целым числом
Здесь одна и та же логика проверки используется для двух разных атрибутов без повторения кода. В этом и состоит главное преимущество дескрипторов.
Дескрипторы повсюду
Даже если вы никогда не писали дескриптор, вы пользуетесь ими каждый день. Многие привычные возможности Python внутри работают через дескрипторы:
- @property — позволяет вычислять атрибут как метод;
- @classmethod и @staticmethod;
- даже обычные методы класса — автоматическая передача self при обращении obj.metod тоже результат работы механизма дескрипторов.
💡 Совет для начинающих: если проверка нужна только для одного атрибута, проще использовать @property. Дескрипторы полезны, когда одна и та же логика повторяется в нескольких атрибутах или классах.
Где полезны дескрипторы?
- Проверка корректности данных (валидация).
- Запрет прямого изменения атрибутов (атрибуты только для чтения).
- Логирование каждого обращения к атрибуту.
- Централизация повторяющейся логики в больших проектах и библиотеках. Например, поля моделей базы данных во фреймворках вроде Django основаны на этом принципе.
Дескрипторы — один из самых мощных инструментов объектно-ориентированного программирования в Python. Их понимание помогает разобраться, как Python работает «за кулисами», и создавать более гибкие API и библиотеки.
Хотите применить эти знания на практике и получить реальные результаты? Начните обучение на курсе «IT и Компьютерная инженерия» и шаг за шагом приобретайте практические навыки. Подробнее о курсе — перейдите по ссылке: Курс «IT и Компьютерная инженерия».

