`reprlib.md`

117 строк · 9.1 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.9/library/reprlib.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# [`reprlib`](https://python-all.ru/3.9/library/reprlib.html#module-reprlib) – альтернативная реализация [`repr()`](https://python-all.ru/3.9/library/functions.html#repr)89**Исходный код:** [Lib/reprlib.py](https://python-all.ru/src/3.9/Lib/reprlib.py)1011---1213Модуль [`reprlib`](https://python-all.ru/3.9/library/reprlib.html#module-reprlib) предоставляет средства для создания представлений объектов с ограничением на длину результирующих строк. Он используется в отладчике Python и может быть полезен и в других контекстах.1415Этот модуль предоставляет класс, экземпляр и функцию:1617#### `class reprlib.Repr`1819Класс, предоставляющий средства форматирования, полезные для реализации функций, аналогичных встроенной [`repr()`](https://python-all.ru/3.9/library/functions.html#repr); для разных типов объектов задаются ограничения на размер, чтобы избежать создания слишком длинных представлений.2021#### `reprlib.aRepr`2223Это экземпляр [`Repr`](https://python-all.ru/3.9/library/reprlib.html#reprlib.Repr), используемый для предоставления функции [`repr()`](https://python-all.ru/3.9/library/reprlib.html#reprlib.repr), описанной ниже. Изменение атрибутов этого объекта повлияет на ограничения размера, используемые [`repr()`](https://python-all.ru/3.9/library/reprlib.html#reprlib.repr) и отладчиком Python.2425#### `reprlib.repr(obj)`2627Это метод [`repr()`](https://python-all.ru/3.9/library/reprlib.html#reprlib.Repr.repr) класса `aRepr`. Он возвращает строку, аналогичную возвращаемой встроенной функцией с тем же именем, но с ограничениями на большинство размеров.2829В дополнение к инструментам ограничения размера, модуль также предоставляет декоратор для обнаружения рекурсивных вызовов [`__repr__()`](https://python-all.ru/3.9/reference/datamodel.html#object.__repr__) и подстановки замещающей строки вместо него.3031#### `@reprlib.recursive_repr(fillvalue="...")`3233Декоратор для методов [`__repr__()`](https://python-all.ru/3.9/reference/datamodel.html#object.__repr__), обнаруживающий рекурсивные вызовы в пределах одного потока. Если происходит рекурсивный вызов, возвращается значение *fillvalue*, в противном случае выполняется обычный вызов [`__repr__()`](https://python-all.ru/3.9/reference/datamodel.html#object.__repr__). Например:3435```python36>>> from reprlib import recursive_repr37>>> class MyList(list):38...     @recursive_repr()39...     def __repr__(self):40...         return '<' + '|'.join(map(repr, self)) + '>'41...42>>> m = MyList('abc')43>>> m.append(m)44>>> m.append('x')45>>> print(m)46<'a'|'b'|'c'|...|'x'>47```4849Новое в версии 3.2.5051## Объекты Repr5253Экземпляры [`Repr`](https://python-all.ru/3.9/library/reprlib.html#reprlib.Repr) предоставляют несколько атрибутов, которые можно использовать для задания ограничений размера представлений разных типов объектов, а также методы, форматирующие конкретные типы объектов.5455#### `Repr.maxlevel`5657Ограничение глубины при создании рекурсивных представлений. По умолчанию – `6`.5859#### `Repr.maxdict`6061#### `Repr.maxlist`6263#### `Repr.maxtuple`6465#### `Repr.maxset`6667#### `Repr.maxfrozenset`6869#### `Repr.maxdeque`7071#### `Repr.maxarray`7273Ограничения на количество элементов, представленных для указанного типа объекта. По умолчанию – `4` для [`maxdict`](https://python-all.ru/3.9/library/reprlib.html#reprlib.Repr.maxdict), `5` для [`maxarray`](https://python-all.ru/3.9/library/reprlib.html#reprlib.Repr.maxarray) и `6` для остальных.7475#### `Repr.maxlong`7677Максимальное количество символов в строковом представлении целого числа. Цифры в середине отбрасываются. По умолчанию `40`.7879#### `Repr.maxstring`8081Ограничение на количество символов в строковом представлении строки. Обратите внимание, что в качестве источника символов используется «обычное» строковое представление: если в представлении нужны escape-последовательности, они могут быть искажены при его сокращении. По умолчанию `30`.8283#### `Repr.maxother`8485Этот предел используется для управления размером тех типов объектов, для которых нет специального метода форматирования в объекте [`Repr`](https://python-all.ru/3.9/library/reprlib.html#reprlib.Repr). Он применяется аналогично [`maxstring`](https://python-all.ru/3.9/library/reprlib.html#reprlib.Repr.maxstring). По умолчанию `20`.8687#### `Repr.repr(obj)`8889Эквивалент встроенной функции [`repr()`](https://python-all.ru/3.9/library/functions.html#repr), использующий форматирование, заданное экземпляром.9091#### `Repr.repr1(obj, level)`9293Рекурсивная реализация, используемая методом [`repr()`](https://python-all.ru/3.9/library/reprlib.html#reprlib.Repr.repr). Она использует тип *obj* для определения того, какой метод форматирования вызвать, передавая ему *obj* и *level*. Методы, специфичные для типа, должны вызывать [`repr1()`](https://python-all.ru/3.9/library/reprlib.html#reprlib.Repr.repr1) для выполнения рекурсивного форматирования, передавая `level - 1` в качестве значения *level* при рекурсивном вызове.9495#### `Repr.repr_TYPE(obj, level)`9697Методы форматирования для конкретных типов реализуются как методы, имя которых строится на основе имени типа. В имени метода **TYPE** заменяется на `'_'.join(type(obj).__name__.split())`. Вызов этих методов осуществляется через [`repr1()`](https://python-all.ru/3.9/library/reprlib.html#reprlib.Repr.repr1). Методы, специфичные для типа, которым нужно рекурсивно отформатировать значение, должны вызывать `self.repr1(subobj, level - 1)`.9899## Создание подклассов объектов Repr100101Использование динамической диспетчеризации в [`Repr.repr1()`](https://python-all.ru/3.9/library/reprlib.html#reprlib.Repr.repr1) позволяет подклассам [`Repr`](https://python-all.ru/3.9/library/reprlib.html#reprlib.Repr) добавлять поддержку дополнительных встроенных типов объектов или изменять обработку уже поддерживаемых типов. В этом примере показано, как можно добавить специальную поддержку для файловых объектов:102103```python104import reprlib105import sys106107class MyRepr(reprlib.Repr):108109    def repr_TextIOWrapper(self, obj, level):110        if obj.name in {'<stdin>', '<stdout>', '<stderr>'}:111            return obj.name112        return repr(obj)113114aRepr = MyRepr()115print(aRepr.repr(sys.stdin))         # печатает '<stdin>'116```117