`reprlib.md`

116 строк · 9.1 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.6/library/reprlib.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 8.12. [`reprlib`](https://python-all.ru/3.6/library/reprlib.html#module-reprlib) – Альтернативная реализация [`repr()`](https://python-all.ru/3.6/library/functions.html#repr)89**Исходный код:** [Lib/reprlib.py](https://python-all.ru/src/3.6/Lib/reprlib.py)1011---1213Модуль [`reprlib`](https://python-all.ru/3.6/library/reprlib.html#module-reprlib) предоставляет средства для создания представлений объектов с ограничением на длину результирующих строк. Он используется в отладчике Python и может быть полезен и в других контекстах.1415Этот модуль предоставляет класс, экземпляр и функцию:1617#### `class reprlib.Repr`1819Класс, предоставляющий средства форматирования, полезные для реализации функций, аналогичных встроенной [`repr()`](https://python-all.ru/3.6/library/functions.html#repr); для разных типов объектов задаются ограничения на размер, чтобы избежать создания слишком длинных представлений.2021#### `reprlib.aRepr`2223Это экземпляр [`Repr`](https://python-all.ru/3.6/library/reprlib.html#reprlib.Repr), используемый для предоставления функции [`repr()`](https://python-all.ru/3.6/library/reprlib.html#reprlib.repr), описанной ниже. Изменение атрибутов этого объекта повлияет на ограничения размера, используемые [`repr()`](https://python-all.ru/3.6/library/reprlib.html#reprlib.repr) и отладчиком Python.2425#### `reprlib.repr(obj)`2627Это метод [`repr()`](https://python-all.ru/3.6/library/reprlib.html#reprlib.Repr.repr) класса `aRepr`. Он возвращает строку, аналогичную возвращаемой встроенной функцией с тем же именем, но с ограничениями на большинство размеров.2829В дополнение к инструментам ограничения размера, модуль также предоставляет декоратор для обнаружения рекурсивных вызовов [`__repr__()`](https://python-all.ru/3.6/reference/datamodel.html#object.__repr__) и подстановки замещающей строки вместо него.3031#### `@reprlib.recursive_repr(fillvalue="...")`3233Декоратор для методов [`__repr__()`](https://python-all.ru/3.6/reference/datamodel.html#object.__repr__), обнаруживающий рекурсивные вызовы в пределах одного потока. Если происходит рекурсивный вызов, возвращается значение *fillvalue*, в противном случае выполняется обычный вызов [`__repr__()`](https://python-all.ru/3.6/reference/datamodel.html#object.__repr__). Например:3435```python36>>> class MyList(list):37...     @recursive_repr()38...     def __repr__(self):39...         return '<' + '|'.join(map(repr, self)) + '>'40...41>>> m = MyList('abc')42>>> m.append(m)43>>> m.append('x')44>>> print(m)45<'a'|'b'|'c'|...|'x'>46```4748Новое в версии 3.2.4950## 8.12.1. Объекты Repr5152Экземпляры [`Repr`](https://python-all.ru/3.6/library/reprlib.html#reprlib.Repr) предоставляют несколько атрибутов, которые можно использовать для задания ограничений размера представлений разных типов объектов, а также методы, форматирующие конкретные типы объектов.5354#### `Repr.maxlevel`5556Ограничение глубины при создании рекурсивных представлений. По умолчанию – `6`.5758#### `Repr.maxdict`5960#### `Repr.maxlist`6162#### `Repr.maxtuple`6364#### `Repr.maxset`6566#### `Repr.maxfrozenset`6768#### `Repr.maxdeque`6970#### `Repr.maxarray`7172Ограничения на количество элементов, представленных для указанного типа объекта. По умолчанию – `4` для [`maxdict`](https://python-all.ru/3.6/library/reprlib.html#reprlib.Repr.maxdict), `5` для [`maxarray`](https://python-all.ru/3.6/library/reprlib.html#reprlib.Repr.maxarray) и `6` для остальных.7374#### `Repr.maxlong`7576Максимальное количество символов в строковом представлении целого числа. Цифры в середине отбрасываются. По умолчанию `40`.7778#### `Repr.maxstring`7980Ограничение на количество символов в строковом представлении строки. Обратите внимание, что в качестве источника символов используется «обычное» строковое представление: если в представлении нужны escape-последовательности, они могут быть искажены при его сокращении. По умолчанию `30`.8182#### `Repr.maxother`8384Этот предел используется для управления размером тех типов объектов, для которых нет специального метода форматирования в объекте [`Repr`](https://python-all.ru/3.6/library/reprlib.html#reprlib.Repr). Он применяется аналогично [`maxstring`](https://python-all.ru/3.6/library/reprlib.html#reprlib.Repr.maxstring). По умолчанию `20`.8586#### `Repr.repr(obj)`8788Эквивалент встроенной функции [`repr()`](https://python-all.ru/3.6/library/functions.html#repr), использующий форматирование, заданное экземпляром.8990#### `Repr.repr1(obj, level)`9192Рекурсивная реализация, используемая методом [`repr()`](https://python-all.ru/3.6/library/reprlib.html#reprlib.Repr.repr). Она использует тип *obj* для определения того, какой метод форматирования вызвать, передавая ему *obj* и *level*. Методы, специфичные для типа, должны вызывать [`repr1()`](https://python-all.ru/3.6/library/reprlib.html#reprlib.Repr.repr1) для выполнения рекурсивного форматирования, передавая `level - 1` в качестве значения *level* при рекурсивном вызове.9394#### `Repr.repr_TYPE(obj, level)`9596Методы форматирования для конкретных типов реализуются как методы, имя которых строится на основе имени типа. В имени метода **TYPE** заменяется на `'_'.join(type(obj).__name__.split())`. Вызов этих методов осуществляется через [`repr1()`](https://python-all.ru/3.6/library/reprlib.html#reprlib.Repr.repr1). Методы, специфичные для типа, которым нужно рекурсивно отформатировать значение, должны вызывать `self.repr1(subobj, level - 1)`.9798## 8.12.2. Наследование объектов Repr99100Использование динамической диспетчеризации в [`Repr.repr1()`](https://python-all.ru/3.6/library/reprlib.html#reprlib.Repr.repr1) позволяет подклассам [`Repr`](https://python-all.ru/3.6/library/reprlib.html#reprlib.Repr) добавлять поддержку дополнительных встроенных типов объектов или изменять обработку уже поддерживаемых типов. В этом примере показано, как можно добавить специальную поддержку для файловых объектов:101102```python103import reprlib104import sys105106class MyRepr(reprlib.Repr):107108    def repr_TextIOWrapper(self, obj, level):109        if obj.name in {'<stdin>', '<stdout>', '<stderr>'}:110            return obj.name111        return repr(obj)112113aRepr = MyRepr()114print(aRepr.repr(sys.stdin))         # печатает '<stdin>'115```116