reprlib — 대안 repr() 구현¶
소스 코드: Lib/reprlib.py
The reprlib module provides a means for producing object representations
with limits on the size of the resulting strings. This is used in the Python
debugger and may be useful in other contexts as well.
이 모듈은 클래스, 인스턴스 및 함수를 제공합니다.:
- class reprlib.Repr¶
내장
repr()과 유사한 함수를 구현하는 데 유용한 포매팅 서비스를 제공하는 클래스; 과도하게 긴 표현의 생성을 피하고자 객체 형별로 크기 제한이 추가됩니다.
- reprlib.aRepr¶
아래에 설명된
repr()로 함수를 제공하는 데 사용되는Repr의 인스턴스입니다. 이 객체의 어트리뷰트를 변경하면repr()과 파이썬 디버거에서 사용되는 크기 제한에 영향을 줍니다.
- reprlib.repr(obj)¶
aRepr의repr()메서드입니다. 같은 이름의 내장 함수에 의해 반환된 것과 비슷한 문자열을 반환하지만, 대부분의 크기에는 제한이 있습니다.
In addition to size-limiting tools, the module also provides a decorator for
detecting recursive calls to __repr__() and substituting a
placeholder string instead.
- @reprlib.recursive_repr(fillvalue='...')¶
Decorator for
__repr__()methods to detect recursive calls within the same thread. If a recursive call is made, the fillvalue is returned, otherwise, the usual__repr__()call is made. For example:>>> 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¶
재귀적 표현의 생성에 대한 심도 한계. 기본값은
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.maxother¶
이 제한은
Repr객체에서 구체적인 포맷 메서드를 사용할 수 없는 객체 형의 크기를 제어하는 데 사용됩니다.maxstring과 비슷한 방식으로 적용됩니다. 기본값은20입니다.
- Repr.repr1(obj, level)¶
repr()에서 사용되는 재귀적 구현. obj의 형을 사용하여 호출할 포매팅 메서드를 결정하고, obj 와 level을 전달합니다. 형별 메서드는 재귀적 포매팅을 수행하기 위해repr1()을 호출해야 하는데, 재귀 호출에서 level 값으로level - 1을 사용합니다.
- Repr.repr_TYPE(obj, level)
특정 형의 포매팅 메서드는 형 이름에 기반하는 이름의 메서드로 구현됩니다. 메서드 이름에서, TYPE 은
'_'.join(type(obj).__name__.split())으로 치환됩니다. 이 메서드로의 디스패치는repr1()에 의해 처리됩니다. 재귀적으로 값을 포맷해야 하는 형별 메서드는self.repr1(subobj, level - 1)을 호출해야 합니다.
Repr 객체 서브 클래싱¶
The use of dynamic dispatching by Repr.repr1() allows subclasses of
Repr to add support for additional built-in object types or to modify
the handling of types already supported. This example shows how special support
for file objects could be added:
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>'
<stdin>