reprlib --- 另一种 repr() 实现¶
源代码: Lib/reprlib.py
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 Objects 小节了解有关
Repr属性的信息。在 3.12 版更改: 允许通过关键字参数来设置属性。
在大小限制工具以外，此模块还提供了一个装饰器，用于检测对 __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.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.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>'