types.md

1> **Источник:** https://python-all.ru/3.3/library/types.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 8.9. [`types`](https://python-all.ru/3.3/library/types.html#module-types) – Динамическое создание типов и имена для встроенных типов89**Исходный код:** [Lib/types.py](https://python-all.ru/src/3.3/Lib/types.py)1011---1213Этот модуль определяет вспомогательную функцию для динамического создания новых типов.1415Он также определяет имена для некоторых типов объектов, которые используются стандартным интерпретатором Python, но не представлены как встроенные, такие как [`int`](https://python-all.ru/3.3/library/functions.html#int) или [`str`](https://python-all.ru/3.3/library/stdtypes.html#str).1617## 8.9.1. Создание динамических типов1819#### `types.new_class(name, bases=(), kwds=None, exec_body=None)`2021Динамически создаёт объект класса, используя соответствующий метакласс.2223Первые три аргумента – это компоненты, составляющие заголовок определения класса: имя класса, базовые классы (по порядку), именованные аргументы (например, `metaclass`).2425Аргумент *exec\_body* – это колбэк, который используется для заполнения вновь созданного пространства имён класса. Он должен принимать пространство имён класса в качестве единственного аргумента и обновлять пространство имён непосредственно содержимым класса. Если колбэк не указан, эффект аналогичен передаче `lambda ns: ns`.2627Новое в версии 3.3.2829#### `types.prepare_class(name, bases=(), kwds=None)`3031Вычисляет соответствующий метакласс и создаёт пространство имён класса.3233Аргументы – это компоненты, составляющие заголовок определения класса: имя класса, базовые классы (по порядку) и именованные аргументы (например, `metaclass`).3435Возвращаемое значение – кортеж из трёх элементов: `metaclass, namespace, kwds`3637*metaclass* – это подходящий метакласс, *namespace* – это подготовленное пространство имён класса, а *kwds* – это обновлённая копия переданного аргумента *kwds*, из которой удалена запись `'metaclass'`. Если аргумент *kwds* не передан, это будет пустой словарь.3839Новое в версии 3.3.4041> **См. также**42>43> **[*Настройка создания классов*](https://python-all.ru/3.3/reference/datamodel.html#metaclasses)**44>45> Полные сведения о процессе создания класса, поддерживаемом этими функциями46>47> **[**PEP 3115**](https://python-all.ru/3.3/library/types.html) – Метаклассы в Python 3000**48>49> Представлен хук пространства имён50>51> `__prepare__`5253## 8.9.2. Стандартные типы интерпретатора5455Этот модуль предоставляет имена для многих типов, необходимых для реализации интерпретатора Python. Он намеренно избегает включения некоторых типов, которые возникают только попутно в процессе обработки, например типа `listiterator`.5657Обычно эти имена используют для проверок с помощью [`isinstance()`](https://python-all.ru/3.3/library/functions.html#isinstance) или [`issubclass()`](https://python-all.ru/3.3/library/functions.html#issubclass).5859Стандартные имена определены для следующих типов:6061#### `types.FunctionType`6263#### `types.LambdaType`6465Тип пользовательских функций и функций, созданных с помощью выражений [`lambda`](https://python-all.ru/3.3/reference/expressions.html#lambda).6667#### `types.GeneratorType`6869Тип объектов-итераторов [*generator*](https://python-all.ru/3.3/glossary.html#term-generator), создаваемых вызовом генераторной функции.7071#### `types.CodeType`7273Тип объектов кода, таких как возвращаемые [`compile()`](https://python-all.ru/3.3/library/functions.html#compile).7475#### `types.MethodType`7677Тип методов экземпляров пользовательских классов.7879#### `types.BuiltinFunctionType`8081#### `types.BuiltinMethodType`8283Тип встроенных функций, таких как [`len()`](https://python-all.ru/3.3/library/functions.html#len) или [`sys.exit()`](https://python-all.ru/3.3/library/sys.html#sys.exit), и методов встроенных классов. (Здесь термин «встроенный» означает «написанный на C».)8485#### `types.ModuleType`8687Тип модулей.8889#### `types.TracebackType`9091Тип объектов traceback, таких как `sys.exc_info()[2]`.9293#### `types.FrameType`9495Тип объектов фреймов, таких как `tb.tb_frame`, если `tb` является объектом traceback.9697#### `types.GetSetDescriptorType`9899Тип объектов, определённых в расширениях модулей с помощью `PyGetSetDef`, таких как `FrameType.f_locals` или `array.array.typecode`. Этот тип используется как дескриптор для атрибутов объектов; он выполняет ту же функцию, что и тип [`property`](https://python-all.ru/3.3/library/functions.html#property), но для классов, определённых в расширениях.100101#### `types.MemberDescriptorType`102103Тип объектов, определённых в расширениях модулей с помощью `PyMemberDef`, таких как `datetime.timedelta.days`. Этот тип используется как дескриптор для простых C-членов, которые используют стандартные функции преобразования; он выполняет ту же функцию, что и тип [`property`](https://python-all.ru/3.3/library/functions.html#property), но для классов, определённых в расширениях.104105**Особенности реализации CPython:** В других реализациях Python этот тип может быть идентичен `GetSetDescriptorType`.106107#### `class types.MappingProxyType(mapping)`108109Прокси-объект отображения только для чтения. Он предоставляет динамическое представление записей отображения, что означает, что при изменении отображения представление отражает эти изменения.110111Новое в версии 3.3.112113#### `key in proxy`114115Возвращает `True`, если базовое отображение содержит ключ *key*, иначе `False`.116117#### `proxy[key]`118119Возвращает элемент базового отображения с ключом *key*. Вызывает [`KeyError`](https://python-all.ru/3.3/library/exceptions.html#KeyError), если *key* отсутствует в базовом отображении.120121#### `iter(proxy)`122123Возвращает итератор по ключам базового отображения. Это сокращение для `iter(proxy.keys())`.124125#### `len(proxy)`126127Возвращает количество элементов в базовом отображении.128129#### `copy()`130131Возвращает поверхностную копию базового отображения.132133#### `get(key[, default])`134135Возвращает значение для *key*, если *key* присутствует в базовом отображении, иначе *default*. Если *default* не указан, по умолчанию используется `None`, так что этот метод никогда не вызывает [`KeyError`](https://python-all.ru/3.3/library/exceptions.html#KeyError).136137#### `items()`138139Возвращает новое представление элементов базового отображения (`(key, value)` пары).140141#### `keys()`142143Возвращает новое представление ключей базового отображения.144145#### `values()`146147Возвращает новое представление значений базового отображения.148149#### `class types.SimpleNamespace`150151Простой подкласс [`object`](https://python-all.ru/3.3/library/functions.html#object), предоставляющий доступ к атрибутам своего пространства имён, а также осмысленное представление (repr).152153В отличие от [`object`](https://python-all.ru/3.3/library/functions.html#object), с `SimpleNamespace` можно добавлять и удалять атрибуты. Если объект `SimpleNamespace` инициализируется именованными аргументами, они напрямую добавляются в базовое пространство имён.154155Этот тип примерно эквивалентен следующему коду:156157```python158class SimpleNamespace:159    def __init__(self, **kwargs):160        self.__dict__.update(kwargs)161    def __repr__(self):162        keys = sorted(self.__dict__)163        items = ("{}={!r}".format(k, self.__dict__[k]) for k in keys)164        return "{}({})".format(type(self).__name__, ", ".join(items))165```166167`SimpleNamespace` может быть полезен как замена `class NS: pass`. Однако для структурированного типа записей лучше использовать [`namedtuple()`](https://python-all.ru/3.3/library/collections.html#collections.namedtuple).168169Новое в версии 3.3.170