reprlib 交替 repr() 实施

源代码： Lib/reprlib.py

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

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

class reprlib.Repr

类，该类在实现类似于内置函数的函数时提供格式化服务 repr() ；添加了不同对象类型的大小限制，以避免生成过长的表示。

reprlib.aRepr

这是一个 Repr 用于提供 repr() 功能描述如下。更改此对象的属性将影响 repr() 以及python调试器。

reprlib.repr(obj)

这就是 repr() 方法 aRepr . 它返回一个类似于由具有相同名称的内置函数返回的字符串，但对大多数大小都有限制。

除了大小限制工具外，该模块还提供了一个用于检测对 __repr__() 替换占位符字符串。

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

decorator __repr__() 方法来检测同一线程中的递归调用。如果进行了递归调用，则 填充值 否则，通常 __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.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

限制字符串表示中的字符数。请注意，字符串的“正常”表示形式用作字符源：如果表示形式中需要转义序列，则在缩短表示形式时可能会损坏转义序列。默认值为 30 .

Repr.maxother

此限制用于控制对象类型的大小，对象类型上没有可用的特定格式设置方法。 Repr 对象。其应用方式与 maxstring . 默认值为 20 .

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>'