reprlib --- 另一種 repr() 實現(xiàn)?
源代碼: Lib/reprlib.py
reprlib 模塊提供了一種對象表示的產生方式，它會對結果字符串的大小進行限制。 該方式被用于 Python 調試器，也適用于某些其他場景。
此模塊提供了一個類、一個實例和一個函數(shù)：
在大小限制工具以外，此模塊還提供了一個裝飾器，用于檢測對 __repr__() 的遞歸調用并改用一個占位符來替換。
- @reprlib.recursive_repr(fillvalue='...')?
用于為
__repr__()方法檢測同一線程內部遞歸調用的裝飾器。 如果執(zhí)行了遞歸調用，則會返回 fillvalue，否則執(zhí)行正常的__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?
This string is displayed for recursive references. It defaults to
....3.11 新版功能.
- Repr.maxlevel?
創(chuàng)建遞歸表示形式的深度限制。 默認為
6。
- Repr.maxdict?
- Repr.maxlist?
- Repr.maxtuple?
- Repr.maxset?
- Repr.maxfrozenset?
- Repr.maxdeque?
- Repr.maxarray?
表示命名對象類型的條目數(shù)量限制。 對于
maxdict的默認值為4，對于maxarray為5，對于其他則為6。
- Repr.maxlong?
表示整數(shù)的最大字符數(shù)量。 數(shù)碼會從中間被丟棄。 默認值為
40。
- Repr.maxstring?
表示字符串的字符數(shù)量限制。 請注意字符源會使用字符串的“正?！北硎拘问剑喝绻硎局行枰玫睫D義序列，在縮短表示時它們可能會被破壞。 默認值為
30。
- Repr.repr1(obj, level)?
供
repr()使用的遞歸實現(xiàn)。 此方法使用 obj 的類型來確定要調用哪個格式化方法，并傳入 obj 和 level。 類型專屬的方法應當調用repr1()來執(zhí)行遞歸格式化，在遞歸調用中使用level - 1作為 level 的值。
- Repr.repr_TYPE(obj, level)
特定類型的格式化方法會被實現(xiàn)為基于類型名稱來命名的方法。 在方法名稱中，TYPE 會被替換為
'_'.join(type(obj).__name__.split())。 對這些方法的分派會由repr1()來處理。 需要對值進行遞歸格式化的類型專屬方法應當調用self.repr1(subobj, level - 1)。
子類化 Repr 對象?
通過 Repr.repr1() 使用動態(tài)分派允許 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>'