Jet School Logo

Что такое 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 и Компьютерная инженерия».

Заполните форму чтобы узнать больше о наших IT курсах

Связанные термины:

Начни изучать IT уже сегодня