reprlib模块替代repr()的详解(41)Python语言(必读进阶学习教程)(参考资料)

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

该模块提供了一个类，一个实例和一个函数：

类reprlib.Repr: 提供格式化服务的类，用于实现类似于内置的函数repr(); 添加不同对象类型的大小限制以避免生成过长的表示。

reprlib.aRepr: 这是Repr用于提供下述 repr()功能的实例。更改此对象的属性将影响repr()Python调试器使用的大小限制。

reprlib.repr（obj ）: 这是repr()方法aRepr。它返回一个类似于同名内置函数返回的字符串，但对大多数大小有限制。

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

@reprlib.recursive_repr（fillvalue =“…” ）

Decorator用于__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.maxlevel: 创建递归表示的深度限制。默认是6。

Repr.maxdict
Repr.maxlist
Repr.maxtuple
Repr.maxset
Repr.maxfrozenset
Repr.maxdeque
Repr.maxarray: 限制为命名对象类型表示的条目数。默认值为4for maxdict，5for maxarray和 6for其他。

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值。level - 1

Repr.repr_TYPE（obj，级别）: 特定类型的格式化方法实现为具有基于类型名称的名称的方法。在方法名称中，TYPE替换为'_'.join(type(obj).__name__.split())。对这些方法的调度由处理repr1()。需要递归格式化值的类型特定方法应该调用。self.repr1(subobj, level - 1)

子类化重新对象

动态分派的使用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>'