reprlib — альтернативная реализация repr()

Объекты Repr

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

Repr.fillvalue

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

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

Repr.maxlevel

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

Repr.maxdict

Repr.maxlist

Repr.maxtuple

Repr.maxset

Repr.maxfrozenset

Repr.maxdeque

Repr.maxarray

Ограничения на количество элементов, отображаемых для указанного типа объекта. По умолчанию для maxdict используется 4, для maxarray — 5, а для остальных — 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

Динамическая диспетчеризация, используемая методом 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))         # prints '<stdin>'

<stdin>