`reprlib` — 替代 `repr()` 实现¶

reprlib 模块提供了一种生成对象表示的方法，并限制了结果字符串的大小。这在 Python 调试器中使用，也可能在其他上下文中有用。

此模块提供了一个类、一个实例和一个函数

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)¶

此类别提供格式化服务，有助于实现类似于内置 repr() 的函数；增加了不同对象类型的尺寸限制，以避免生成过长的表示。

构造函数的关键字参数可用作设置 Repr 实例属性的快捷方式。这意味着以下初始化

aRepr = reprlib.Repr(maxlevel=3)

等效于

aRepr = reprlib.Repr()
aRepr.maxlevel = 3

有关 Repr 属性的更多信息，请参阅 Repr 对象部分。

3.12 版本中的更改: 允许通过关键字参数设置属性。

reprlib.aRepr¶: 这是一个 Repr 实例，用于提供下面描述的 repr() 函数。更改此对象的属性将影响 repr() 和 Python 调试器使用的尺寸限制。

reprlib.repr(obj)¶: 这是 aRepr 的 repr() 方法。它返回一个与内置同名函数返回的字符串类似的字符串，但在大多数尺寸上都有限制。

除了尺寸限制工具之外，该模块还提供了一个装饰器，用于检测对 __repr__() 的递归调用，并替换为占位符字符串。

@reprlib.recursive_repr(fillvalue='...')¶

用于 __repr__() 方法的装饰器，用于检测同一线程内的递归调用。如果发生递归调用，则返回 fillvalue，否则，进行常规的 __repr__() 调用。例如

>>> from reprlib import recursive_repr
>>> class MyList(list):
...     @recursive_repr()
...     def __repr__(self):
...         return '<' + '|'.join(map(repr, self)) + '>'
...
>>> m = MyList('abc')
>>> m.append(m)
>>> m.append('x')
>>> print(m)
<'a'|'b'|'c'|...|'x'>

在 3.2 版本加入。

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¶: 字符串表示中的字符数限制。请注意，字符串的“正常”表示用作字符源：如果表示中需要转义序列，则在缩短表示时可能会被破坏。默认值为 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 的值为 level - 1。

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>

`reprlib` — 替代 `repr()` 实现¶

Repr 对象¶

Repr 对象子类化¶

目录

上一主题

下一主题

本页

reprlib — 替代 repr() 实现¶

Repr 对象¶

Repr 对象子类化¶

`reprlib` — 替代 `repr()` 实现¶