Слоты, дескрипторы, декораторы

Расширения объектной модели Python

Декораторы

Что, если мы хотим «обмазать» все вызовы некоторой функции отладочной информацией?

   1 def fun(a,b):G
   2     return a*2+b
   3 
   4 def dfun(f, *args):
   5     print(">", *args)
   6     res = f(*args)
   7     print("<", res)
   8     return res
   9 
  10 
  11 print(fun(2,3))
  12 print(dfun(fun,2,3))

Неудобно! Поиск с заменой fun(a,b) на dfun(fun,a,b).

Создадим обёрнутую функцию вместо старой:

   1 # ...
   2 def genf(f):
   3     def newfun(*args):
   4         print(">", *args)
   5         res = f(*args)
   6         print("<", res)
   7         return res
   8     return newfun
   9 
  10 newf = genf(fun)
  11 print(newf(2,3))

Всё равно поиск с заменой, хотя и попроще. Тогда просто перебьём имя fun!

   1 # ...
   2 fun = genf(fun)
   3 print(fun(2,3))

Вот это и есть декоратор, записывается так:

   1 def genf(f):
   2     def newfun(*args):
   3         print(">", *args)
   4         res = f(*args)
   5         print("<", res)
   6         return res
   7     return newfun
   8 
   9 @genf
  10 def fun(a,b):
  11     return a*2+b
  12 
  13 print(fun(2,3))

Закомментировали @genf — убрали декоратор!

статья на хабре

BTW, Запись вида

   1 @декоратор2
   2 @декоратор1
   3 def функция(…)
   4 …

означает то, что вы подумали: функцию функция(), обмазанную сначала декоратором декоратор1(), а затем — декоратор2().

Параметрические декораторы

Конструкторы декораторов!

вторая часть статьи (+декораторы методов)

Декораторы методов и классов

Методы в классах тоже можно декорировать. И сами классы.

Декоратор метода — это то же самое, что декоратор функции, не забываем только про self в первом параметре.

Класс — это callable, так что ему ничто не мешает быть декоратором

Декоратор класса — проще, чем кажется ☺! Это функция, которой передаётся класс, она его жуёт (например, подсовывает или даже перебивает поля), и возвращает новый, пережёванный класc.

Дескрипторы

Механизм getter/setter:

Реализация в Python:

Будучи полем класса, дескриптор отсутствует в .__dict__[] объекта, но имеет перед ним приоритет:

Вот такой дескриптор может быть в классе только один, потому что он изменяет одно конкретное поле:

(!) Мы могли бы хранить значение дескрипторов d = Descr() и e = Descr() непосредственно в obj.__dict__["d"] и obj.__dict__["e"]… но для этого нам нужно как-то узнать, что экземпляры Descr() назывались «d» и «e».

Метод __set_name__() (pep-0487) вызывается при формировании пространства имён класса, и решает ровно эту задачу!

   1 class Descr:
   2     def __get__(self, obj, cls):
   3         return obj.__dict__[self.key]
   4     def __set__(self, obj, val):
   5         obj.__dict__[self.key] = abs(val)
   6     def __set_name__(self, owner, name):
   7         self.key = name
   8 
   9 class C:
  10     d = Descr()
  11     e = Descr()

Воспользуемся:

   1 >>> a = C()
   2 >>> dir(a)
   3 ['__class__', …, '__weakref__', 'd', 'e']
   4 >>> a.__dict__
   5 {}
   6 >>> a.d, a.e = 1, 42
   7 >>> a.__dict__
   8 {'d': 1, 'e': 42}
   9 >>> a.d, a.e = -2, -100500
  10 >>> a.__dict__
  11 {'d': 2, 'e': 100500}
  12 >>> a.e
  13 100500
  14 

Слоты

Гвидо про дескрипторы и слоты

Недостатки реализации объектной модели в Python с помощью __dict__:

Слоты:

   1 class slo:
   2 
   3     __slots__ = "field", "schmield"
   4     readonly = 100500
   5 
   6     def __init__(self, f, s):
   7         self.field, self.schmield = f, s

А теперь попробуем:

   1 >>> s=slo(2,3)
   2 >>> s.readonly
   3 100500
   4 >>> s.field
   5 2
   6 >>> s.schmield=4
   7 >>> s.schmield
   8 4
   9 >>> s.foo = 0
  10 Traceback (most recent call last):
  11   File "<stdin>", line 1, in <module>
  12 AttributeError: 'slo' object has no attribute 'foo'
  13 >>> s.readonly = 0
  14 Traceback (most recent call last):
  15   File "<stdin>", line 1, in <module>
  16 AttributeError: 'slo' object attribute 'readonly' is read-only
  17 >>> slo.field
  18 <member 'field' of 'slo' objects>
  19 >>> type(slo.field)
  20 <class 'member_descriptor'>
  21 

Немного подкапотной машинерии:

   1 >>> type(s.field)
   2 <class 'int'>
   3 >>> type(slo.field)
   4 <class 'member_descriptor'>
   5 >>> slo.field.__get__()
   6 Traceback (most recent call last):
   7   File "<stdin>", line 1, in <module>
   8 TypeError:  expected at least 1 argument, got 0
   9 
  10  expected at least 1 argument, got 0
  11 >>> slo.field.__get__(s)
  12 2
  13 

Стандартные декораторы

В стандартной библиотеке Python полно декораторов:

Модификаторы методов

Примеры адского использования неклассической объектной модели в стандартной библиотеке Python

Д/З

LecturesCMC/PythonIntro2026/10_SlotsDescriptorsDecorators (последним исправлял пользователь StephenMalchevskii 2026-11-22 17:38:28)