5.19.1 Repr Objects
Repr instances provide several members which can be used to provide size limits for the representations of different object types, and methods which format specific object types.
-
Depth limit on the creation of recursive representations. The
default is
6
.
- Limits on the number of entries represented for the named object
type. The default is
4
for maxdict,5
for maxarray, and6
for the others. New in version 2.4: maxset, maxfrozenset, and set. .
-
Maximum number of characters in the representation for a long
integer. Digits are dropped from the middle. The default is
40
.
-
Limit on the number of characters in the representation of the
string. Note that the ``normal'' representation of the string is
used as the character source: if escape sequences are needed in the
representation, these may be mangled when the representation is
shortened. The default is
30
.
-
This limit is used to control the size of object types for which no
specific formatting method is available on the Repr object.
It is applied in a similar manner as maxstring. The
default is
20
.
- The equivalent to the built-in repr() that uses the formatting imposed by the instance.
-
Recursive implementation used by repr(). This uses the
type of obj to determine which formatting method to call,
passing it obj and level. The type-specific methods
should call repr1() to perform recursive formatting, with
level - 1
for the value of level in the recursive call.
-
Formatting methods for specific types are implemented as methods
with a name based on the type name. In the method name, type
is replaced by
string.join(string.split(type(obj).__name__, '_'))
. Dispatch to these methods is handled by repr1(). Type-specific methods which need to recursively format a value should call "self.repr1(subobj, level - 1)".
See About this document... for information on suggesting changes.