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
- 限制为命名对象类型表示的条目数。默认值为
4
formaxdict
,5
formaxarray
和6
for其他。
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>'