`reprlib.md`

127 строк · 9.2 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.11/library/reprlib.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# [`reprlib`](https://python-all.ru/3.11/library/reprlib.html#module-reprlib) – альтернативная реализация [`repr()`](https://python-all.ru/3.11/library/functions.html#repr)89**Исходный код:** [Lib/reprlib.py](https://python-all.ru/src/3.11/Lib/reprlib.py)1011---1213Модуль `reprlib` предоставляет средства для создания представлений объектов с ограничением на длину результирующих строк. Он используется в отладчике Python и может быть полезен и в других контекстах.1415Этот модуль предоставляет класс, экземпляр и функцию:1617#### `class reprlib.Repr`1819Класс, предоставляющий средства форматирования, полезные для реализации функций, аналогичных встроенной [`repr()`](https://python-all.ru/3.11/library/functions.html#repr); для разных типов объектов задаются ограничения на размер, чтобы избежать создания слишком длинных представлений.2021#### `reprlib.aRepr`2223Это экземпляр [`Repr`](https://python-all.ru/3.11/library/reprlib.html#reprlib.Repr), используемый для предоставления функции [`repr()`](https://python-all.ru/3.11/library/reprlib.html#reprlib.repr), описанной ниже. Изменение атрибутов этого объекта повлияет на ограничения размера, используемые [`repr()`](https://python-all.ru/3.11/library/reprlib.html#reprlib.repr) и отладчиком Python.2425#### `reprlib.repr(obj)`2627Это метод [`repr()`](https://python-all.ru/3.11/library/reprlib.html#reprlib.Repr.repr) класса `aRepr`. Он возвращает строку, аналогичную возвращаемой встроенной функцией с тем же именем, но с ограничениями на большинство размеров.2829В дополнение к инструментам ограничения размера, модуль также предоставляет декоратор для обнаружения рекурсивных вызовов [`__repr__()`](https://python-all.ru/3.11/reference/datamodel.html#object.__repr__) и подстановки вместо них строки-заполнителя.3031#### `@reprlib.recursive_repr(fillvalue='...')`3233Декоратор для методов [`__repr__()`](https://python-all.ru/3.11/reference/datamodel.html#object.__repr__), обнаруживающий рекурсивные вызовы в пределах одного потока. Если происходит рекурсивный вызов, возвращается значение *fillvalue*, в противном случае выполняется обычный вызов `__repr__()`. Например:3435```pycon36>>> 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.11/library/reprlib.html#reprlib.Repr) предоставляют несколько атрибутов, которые можно использовать для задания ограничений размера представлений разных типов объектов, а также методы, форматирующие конкретные типы объектов.5455#### `Repr.fillvalue`5657Эта строка отображается для рекурсивных ссылок. По умолчанию она равна `...`.5859Новое в версии 3.11.6061#### `Repr.maxlevel`6263Ограничение глубины при создании рекурсивных представлений. По умолчанию – `6`.6465#### `Repr.maxdict`6667#### `Repr.maxlist`6869#### `Repr.maxtuple`7071#### `Repr.maxset`7273#### `Repr.maxfrozenset`7475#### `Repr.maxdeque`7677#### `Repr.maxarray`7879Ограничения на количество элементов, представленных для указанного типа объекта. По умолчанию – `4` для [`maxdict`](https://python-all.ru/3.11/library/reprlib.html#reprlib.Repr.maxdict), `5` для [`maxarray`](https://python-all.ru/3.11/library/reprlib.html#reprlib.Repr.maxarray) и `6` для остальных.8081#### `Repr.maxlong`8283Максимальное количество символов в строковом представлении целого числа. Цифры в середине отбрасываются. По умолчанию `40`.8485#### `Repr.maxstring`8687Ограничение на количество символов в строковом представлении строки. Обратите внимание, что в качестве источника символов используется «обычное» строковое представление: если в представлении нужны escape-последовательности, они могут быть искажены при его сокращении. По умолчанию `30`.8889#### `Repr.maxother`9091Этот предел используется для управления размером тех типов объектов, для которых нет специального метода форматирования в объекте [`Repr`](https://python-all.ru/3.11/library/reprlib.html#reprlib.Repr). Он применяется аналогично [`maxstring`](https://python-all.ru/3.11/library/reprlib.html#reprlib.Repr.maxstring). По умолчанию `20`.9293#### `Repr.repr(obj)`9495Эквивалент встроенной функции [`repr()`](https://python-all.ru/3.11/library/functions.html#repr), использующий форматирование, заданное экземпляром.9697#### `Repr.repr1(obj, level)`9899Рекурсивная реализация, используемая методом [`repr()`](https://python-all.ru/3.11/library/reprlib.html#reprlib.Repr.repr). Она использует тип *obj* для определения того, какой метод форматирования вызвать, передавая ему *obj* и *level*. Методы, специфичные для типа, должны вызывать [`repr1()`](https://python-all.ru/3.11/library/reprlib.html#reprlib.Repr.repr1) для выполнения рекурсивного форматирования, передавая `level - 1` в качестве значения *level* при рекурсивном вызове.100101#### `Repr.repr_TYPE(obj, level)`102103Методы форматирования для конкретных типов реализуются как методы, имя которых строится на основе имени типа. В имени метода **TYPE** заменяется на `'_'.join(type(obj).__name__.split())`. Вызов этих методов осуществляется через [`repr1()`](https://python-all.ru/3.11/library/reprlib.html#reprlib.Repr.repr1). Методы, специфичные для типа, которым нужно рекурсивно отформатировать значение, должны вызывать `self.repr1(subobj, level - 1)`.104105## Создание подклассов объектов Repr106107Использование динамической диспетчеризации в [`Repr.repr1()`](https://python-all.ru/3.11/library/reprlib.html#reprlib.Repr.repr1) позволяет подклассам [`Repr`](https://python-all.ru/3.11/library/reprlib.html#reprlib.Repr) добавлять поддержку дополнительных встроенных типов объектов или изменять обработку уже поддерживаемых типов. В этом примере показано, как можно добавить специальную поддержку для файловых объектов:108109```python110import reprlib111import sys112113class MyRepr(reprlib.Repr):114115    def repr_TextIOWrapper(self, obj, level):116        if obj.name in {'<stdin>', '<stdout>', '<stderr>'}:117            return obj.name118        return repr(obj)119120aRepr = MyRepr()121print(aRepr.repr(sys.stdin))         # печатает '<stdin>'122```123124```text125<stdin>126```127