reprlib – альтернативная реализация repr()¶reprlib – Alternate repr() implementation

Объекты Repr¶Repr Objects

Экземпляры Repr предоставляют несколько атрибутов, которые можно использовать для задания ограничений размера представлений разных типов объектов, а также методы, форматирующие конкретные типы объектов.

Repr.fillvalue¶

Эта строка отображается для рекурсивных ссылок. По умолчанию она равна ....

Добавлено в версии 3.12.

Repr.maxlevel¶

Ограничение глубины при создании рекурсивных представлений. По умолчанию – 6.

Repr.maxdict¶

Repr.maxlist¶

Repr.maxtuple¶

Repr.maxset¶

Repr.maxfrozenset¶

Repr.maxdeque¶

Repr.maxarray¶

Ограничения на количество элементов, представленных для указанного типа объекта. По умолчанию – 4 для maxdict, 5 для maxarray и 6 для остальных.

Repr.maxlong¶

Максимальное количество символов в строковом представлении целого числа. Цифры в середине отбрасываются. По умолчанию 40.

Repr.maxstring¶

Ограничение на количество символов в строковом представлении строки. Обратите внимание, что в качестве источника символов используется «обычное» строковое представление: если в представлении нужны escape-последовательности, они могут быть искажены при его сокращении. По умолчанию 30.

Repr.maxother¶

Этот предел используется для управления размером тех типов объектов, для которых нет специального метода форматирования в объекте Repr. Он применяется аналогично maxstring. По умолчанию 20.

Repr.indent¶

Если для этого атрибута установлено значение None (по умолчанию), вывод форматируется без разрывов строк и отступов, как стандартная функция repr(). Например:

>>> example = [
...     1, 'spam', {'a': 2, 'b': 'spam eggs', 'c': {3: 4.5, 6: []}}, 'ham']
>>> import reprlib
>>> aRepr = reprlib.Repr()
>>> print(aRepr.repr(example))
[1, 'spam', {'a': 2, 'b': 'spam eggs', 'c': {3: 4.5, 6: []}}, 'ham']

Если indent задаётся строкой, каждый уровень рекурсии помещается на отдельную строку с отступом в виде этой строки:

>>> aRepr.indent = '-->'
>>> print(aRepr.repr(example))
[
-->1,
-->'spam',
-->{
-->-->'a': 2,
-->-->'b': 'spam eggs',
-->-->'c': {
-->-->-->3: 4.5,
-->-->-->6: [],
-->-->},
-->},
-->'ham',
]

Установка indent в положительное целое число работает так, как если бы он был задан строкой из такого количества пробелов:

>>> aRepr.indent = 4
>>> print(aRepr.repr(example))
[
    1,
    'spam',
    {
        'a': 2,
        'b': 'spam eggs',
        'c': {
            3: 4.5,
            6: [],
        },
    },
    'ham',
]

Добавлено в версии 3.12.

Repr.repr(obj)¶

Эквивалент встроенной функции repr(), использующий форматирование, заданное экземпляром.

Repr.repr1(obj, level)¶

Рекурсивная реализация, используемая методом repr(). Она использует тип obj для определения того, какой метод форматирования вызвать, передавая ему obj и level. Методы, специфичные для типа, должны вызывать repr1() для выполнения рекурсивного форматирования, передавая level - 1 в качестве значения level при рекурсивном вызове.

Repr.repr_TYPE(obj, level)

Методы форматирования для конкретных типов реализуются как методы, имя которых строится на основе имени типа. В имени метода TYPE заменяется на '_'.join(type(obj).__name__.split()). Вызов этих методов осуществляется через repr1(). Методы, специфичные для типа, которым нужно рекурсивно отформатировать значение, должны вызывать self.repr1(subobj, level - 1).

Создание подклассов объектов Repr¶Subclassing Repr Objects

Использование динамической диспетчеризации в Repr.repr1() позволяет подклассам Repr добавлять поддержку дополнительных встроенных типов объектов или изменять обработку уже поддерживаемых типов. В этом примере показано, как можно добавить специальную поддержку для файловых объектов:

import reprlib
import sys

class MyRepr(reprlib.Repr):

    def repr_TextIOWrapper(self, obj, level):
        if obj.name in {'<stdin>', '<stdout>', '<stderr>'}:
            return obj.name
        return repr(obj)

aRepr = MyRepr()
print(aRepr.repr(sys.stdin))         # печатает '<stdin>'

<stdin>