reprlib.md

1> **Источник:** https://python-all.ru/3.16/library/reprlib.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# `reprlib` – альтернативная реализация [`repr()`](https://python-all.ru/3.16/library/functions.html#repr)89**Исходный код:** [Lib/reprlib.py](https://python-all.ru/src/main/Lib/reprlib.py)1011---1213Модуль `reprlib` предоставляет средства для создания представлений объектов с ограничением на длину результирующих строк. Он используется в отладчике Python и может быть полезен и в других контекстах.1415Этот модуль предоставляет класс, экземпляр и функцию:1617#### `class reprlib.Repr(*, maxlevel=6, maxtuple=6, maxlist=6, maxarray=5, maxdict=4, maxset=6, maxfrozenset=6, maxdeque=6, maxstring=30, maxlong=40, maxother=30, fillvalue='...', indent=None)`1819Класс, предоставляющий средства форматирования, полезные для реализации функций, аналогичных встроенной [`repr()`](https://python-all.ru/3.16/library/functions.html#repr); для разных типов объектов задаются ограничения на размер, чтобы избежать создания слишком длинных представлений.2021Именованные аргументы конструктора можно использовать как сокращение для установки атрибутов экземпляра `Repr`. То есть следующая инициализация:2223```python24aRepr = reprlib.Repr(maxlevel=3)25```2627Эквивалентно:2829```python30aRepr = reprlib.Repr()31aRepr.maxlevel = 332```3334Смотрите раздел [Объекты Repr](https://python-all.ru/3.16/library/reprlib.html#id1) для получения дополнительной информации об атрибутах `Repr`.3536Изменено в версии 3.12: Теперь атрибуты можно задавать через именованные аргументы.3738#### `reprlib.aRepr`3940Это экземпляр [`Repr`](https://python-all.ru/3.16/library/reprlib.html#reprlib.Repr), используемый для предоставления функции [`repr()`](https://python-all.ru/3.16/library/reprlib.html#reprlib.repr), описанной ниже. Изменение атрибутов этого объекта повлияет на ограничения размера, используемые `repr()` и отладчиком Python.4142#### `reprlib.repr(obj)`4344Это метод [`repr()`](https://python-all.ru/3.16/library/reprlib.html#reprlib.Repr.repr) класса `aRepr`. Он возвращает строку, аналогичную возвращаемой встроенной функцией с тем же именем, но с ограничениями на большинство размеров.4546В дополнение к инструментам ограничения размера, модуль также предоставляет декоратор для обнаружения рекурсивных вызовов [`__repr__()`](https://python-all.ru/3.16/reference/datamodel.html#object.__repr__) и подстановки вместо них строки-заполнителя.4748#### `@reprlib.recursive_repr(fillvalue='...')`4950Декоратор для методов [`__repr__()`](https://python-all.ru/3.16/reference/datamodel.html#object.__repr__), обнаруживающий рекурсивные вызовы в пределах одного потока. Если происходит рекурсивный вызов, возвращается значение *fillvalue*, в противном случае выполняется обычный вызов `__repr__()`. Например:5152```pycon53>>> from reprlib import recursive_repr54>>> class MyList(list):55...     @recursive_repr()56...     def __repr__(self):57...         return '<' + '|'.join(map(repr, self)) + '>'58...59>>> m = MyList('abc')60>>> m.append(m)61>>> m.append('x')62>>> print(m)63<'a'|'b'|'c'|...|'x'>64```6566Добавлено в версии 3.2.6768## Объекты Repr6970Экземпляры [`Repr`](https://python-all.ru/3.16/library/reprlib.html#reprlib.Repr) предоставляют несколько атрибутов, которые можно использовать для задания ограничений размера представлений разных типов объектов, а также методы, форматирующие конкретные типы объектов.7172#### `Repr.fillvalue`7374Эта строка отображается для рекурсивных ссылок. По умолчанию она равна `...`.7576Добавлено в версии 3.12.7778#### `Repr.maxlevel`7980Ограничение глубины при создании рекурсивных представлений. По умолчанию – `6`.8182#### `Repr.maxdict`8384#### `Repr.maxlist`8586#### `Repr.maxtuple`8788#### `Repr.maxset`8990#### `Repr.maxfrozenset`9192#### `Repr.maxdeque`9394#### `Repr.maxarray`9596Ограничения на количество элементов, представленных для указанного типа объекта. По умолчанию – `4` для [`maxdict`](https://python-all.ru/3.16/library/reprlib.html#reprlib.Repr.maxdict), `5` для [`maxarray`](https://python-all.ru/3.16/library/reprlib.html#reprlib.Repr.maxarray) и `6` для остальных.9798#### `Repr.maxlong`99100Максимальное количество символов в строковом представлении целого числа. Цифры в середине отбрасываются. По умолчанию `40`.101102#### `Repr.maxstring`103104Ограничение на количество символов в строковом представлении строки. Обратите внимание, что в качестве источника символов используется «обычное» строковое представление: если в представлении нужны escape-последовательности, они могут быть искажены при его сокращении. По умолчанию `30`.105106#### `Repr.maxother`107108Этот предел используется для управления размером тех типов объектов, для которых нет специального метода форматирования в объекте [`Repr`](https://python-all.ru/3.16/library/reprlib.html#reprlib.Repr). Он применяется аналогично [`maxstring`](https://python-all.ru/3.16/library/reprlib.html#reprlib.Repr.maxstring). По умолчанию `20`.109110#### `Repr.indent`111112Если для этого атрибута установлено значение `None` (по умолчанию), вывод форматируется без разрывов строк и отступов, как стандартная функция [`repr()`](https://python-all.ru/3.16/library/functions.html#repr). Например:113114```pycon115>>> example = [116...     1, 'spam', {'a': 2, 'b': 'spam eggs', 'c': {3: 4.5, 6: []}}, 'ham']117>>> import reprlib118>>> aRepr = reprlib.Repr()119>>> print(aRepr.repr(example))120[1, 'spam', {'a': 2, 'b': 'spam eggs', 'c': {3: 4.5, 6: []}}, 'ham']121```122123Если `indent` задаётся строкой, каждый уровень рекурсии помещается на отдельную строку с отступом в виде этой строки:124125```pycon126>>> aRepr.indent = '-->'127>>> print(aRepr.repr(example))128[129-->1,130-->'spam',131-->{132-->-->'a': 2,133-->-->'b': 'spam eggs',134-->-->'c': {135-->-->-->3: 4.5,136-->-->-->6: [],137-->-->},138-->},139-->'ham',140]141```142143Установка `indent` в положительное целое число работает так, как если бы он был задан строкой из такого количества пробелов:144145```pycon146>>> aRepr.indent = 4147>>> print(aRepr.repr(example))148[149    1,150    'spam',151    {152        'a': 2,153        'b': 'spam eggs',154        'c': {155            3: 4.5,156            6: [],157        },158    },159    'ham',160]161```162163Добавлено в версии 3.12.164165#### `Repr.repr(obj)`166167Эквивалент встроенной функции [`repr()`](https://python-all.ru/3.16/library/functions.html#repr), использующий форматирование, заданное экземпляром.168169#### `Repr.repr1(obj, level)`170171Рекурсивная реализация, используемая методом [`repr()`](https://python-all.ru/3.16/library/reprlib.html#reprlib.Repr.repr). Она использует тип *obj* для определения того, какой метод форматирования вызвать, передавая ему *obj* и *level*. Методы, специфичные для типа, должны вызывать `repr1()` для выполнения рекурсивного форматирования, передавая `level - 1` в качестве значения *level* при рекурсивном вызове.172173#### `Repr.repr_TYPE(obj, level)`174175Методы форматирования для конкретных типов реализуются как методы, имя которых строится на основе имени типа. В имени метода **TYPE** заменяется на `'_'.join(type(obj).__name__.split())`. Вызов этих методов осуществляется через [`repr1()`](https://python-all.ru/3.16/library/reprlib.html#reprlib.Repr.repr1). Методы, специфичные для типа, которым нужно рекурсивно отформатировать значение, должны вызывать `self.repr1(subobj, level - 1)`.176177## Создание подклассов объектов Repr178179Использование динамической диспетчеризации в [`Repr.repr1()`](https://python-all.ru/3.16/library/reprlib.html#reprlib.Repr.repr1) позволяет подклассам [`Repr`](https://python-all.ru/3.16/library/reprlib.html#reprlib.Repr) добавлять поддержку дополнительных встроенных типов объектов или изменять обработку уже поддерживаемых типов. В этом примере показано, как можно добавить специальную поддержку для файловых объектов:180181```python182import reprlib183import sys184185class MyRepr(reprlib.Repr):186187    def repr_TextIOWrapper(self, obj, level):188        if obj.name in {'<stdin>', '<stdout>', '<stderr>'}:189            return obj.name190        return repr(obj)191192aRepr = MyRepr()193print(aRepr.repr(sys.stdin))         # печатает '<stdin>'194```195196```text197<stdin>198```199