Georg Brandl | fed6bb7 | 2007-09-12 19:00:10 +0000 | [diff] [blame] | 1 | """Redo the builtin repr() (representation) but with limits on most sizes.""" |
Guido van Rossum | babe2bf | 1992-01-22 22:21:31 +0000 | [diff] [blame] | 2 | |
Skip Montanaro | 0de6580 | 2001-02-15 22:15:14 +0000 | [diff] [blame] | 3 | __all__ = ["Repr","repr"] |
| 4 | |
Walter Dörwald | 70a6b49 | 2004-02-12 17:35:32 +0000 | [diff] [blame] | 5 | import __builtin__ |
Raymond Hettinger | ba6cd36 | 2004-05-21 10:00:15 +0000 | [diff] [blame] | 6 | from itertools import islice |
Walter Dörwald | 70a6b49 | 2004-02-12 17:35:32 +0000 | [diff] [blame] | 7 | |
Guido van Rossum | babe2bf | 1992-01-22 22:21:31 +0000 | [diff] [blame] | 8 | class Repr: |
Raymond Hettinger | ba6cd36 | 2004-05-21 10:00:15 +0000 | [diff] [blame] | 9 | |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 10 | def __init__(self): |
| 11 | self.maxlevel = 6 |
| 12 | self.maxtuple = 6 |
| 13 | self.maxlist = 6 |
Tim Peters | 6ee0480 | 2003-02-05 18:29:34 +0000 | [diff] [blame] | 14 | self.maxarray = 5 |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 15 | self.maxdict = 4 |
Raymond Hettinger | ba6cd36 | 2004-05-21 10:00:15 +0000 | [diff] [blame] | 16 | self.maxset = 6 |
| 17 | self.maxfrozenset = 6 |
Raymond Hettinger | 1453e4a | 2004-05-21 23:01:18 +0000 | [diff] [blame] | 18 | self.maxdeque = 6 |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 19 | self.maxstring = 30 |
| 20 | self.maxlong = 40 |
| 21 | self.maxother = 20 |
Raymond Hettinger | ba6cd36 | 2004-05-21 10:00:15 +0000 | [diff] [blame] | 22 | |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 23 | def repr(self, x): |
| 24 | return self.repr1(x, self.maxlevel) |
Raymond Hettinger | ba6cd36 | 2004-05-21 10:00:15 +0000 | [diff] [blame] | 25 | |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 26 | def repr1(self, x, level): |
Guido van Rossum | a995c91 | 2001-08-09 18:56:27 +0000 | [diff] [blame] | 27 | typename = type(x).__name__ |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 28 | if ' ' in typename: |
Eric S. Raymond | 6b71e74 | 2001-02-09 08:56:30 +0000 | [diff] [blame] | 29 | parts = typename.split() |
| 30 | typename = '_'.join(parts) |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 31 | if hasattr(self, 'repr_' + typename): |
| 32 | return getattr(self, 'repr_' + typename)(x, level) |
| 33 | else: |
Walter Dörwald | 70a6b49 | 2004-02-12 17:35:32 +0000 | [diff] [blame] | 34 | s = __builtin__.repr(x) |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 35 | if len(s) > self.maxother: |
Guido van Rossum | 6fd0f0a | 2001-09-05 02:27:04 +0000 | [diff] [blame] | 36 | i = max(0, (self.maxother-3)//2) |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 37 | j = max(0, self.maxother-3-i) |
| 38 | s = s[:i] + '...' + s[len(s)-j:] |
| 39 | return s |
Raymond Hettinger | ba6cd36 | 2004-05-21 10:00:15 +0000 | [diff] [blame] | 40 | |
Raymond Hettinger | 1453e4a | 2004-05-21 23:01:18 +0000 | [diff] [blame] | 41 | def _repr_iterable(self, x, level, left, right, maxiter, trail=''): |
Raymond Hettinger | ba6cd36 | 2004-05-21 10:00:15 +0000 | [diff] [blame] | 42 | n = len(x) |
| 43 | if level <= 0 and n: |
| 44 | s = '...' |
| 45 | else: |
| 46 | newlevel = level - 1 |
| 47 | repr1 = self.repr1 |
| 48 | pieces = [repr1(elem, newlevel) for elem in islice(x, maxiter)] |
| 49 | if n > maxiter: pieces.append('...') |
| 50 | s = ', '.join(pieces) |
Raymond Hettinger | 1453e4a | 2004-05-21 23:01:18 +0000 | [diff] [blame] | 51 | if n == 1 and trail: right = trail + right |
Raymond Hettinger | ba6cd36 | 2004-05-21 10:00:15 +0000 | [diff] [blame] | 52 | return '%s%s%s' % (left, s, right) |
| 53 | |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 54 | def repr_tuple(self, x, level): |
Neal Norwitz | e99cb23 | 2007-06-11 07:34:07 +0000 | [diff] [blame] | 55 | return self._repr_iterable(x, level, '(', ')', self.maxtuple, ',') |
Raymond Hettinger | ba6cd36 | 2004-05-21 10:00:15 +0000 | [diff] [blame] | 56 | |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 57 | def repr_list(self, x, level): |
Raymond Hettinger | ba6cd36 | 2004-05-21 10:00:15 +0000 | [diff] [blame] | 58 | return self._repr_iterable(x, level, '[', ']', self.maxlist) |
Tim Peters | 6ee0480 | 2003-02-05 18:29:34 +0000 | [diff] [blame] | 59 | |
| 60 | def repr_array(self, x, level): |
Tim Peters | 6ee0480 | 2003-02-05 18:29:34 +0000 | [diff] [blame] | 61 | header = "array('%s', [" % x.typecode |
Raymond Hettinger | ba6cd36 | 2004-05-21 10:00:15 +0000 | [diff] [blame] | 62 | return self._repr_iterable(x, level, header, '])', self.maxarray) |
| 63 | |
| 64 | def repr_set(self, x, level): |
Georg Brandl | fed6bb7 | 2007-09-12 19:00:10 +0000 | [diff] [blame] | 65 | x = _possibly_sorted(x) |
Raymond Hettinger | ba6cd36 | 2004-05-21 10:00:15 +0000 | [diff] [blame] | 66 | return self._repr_iterable(x, level, 'set([', '])', self.maxset) |
| 67 | |
| 68 | def repr_frozenset(self, x, level): |
Georg Brandl | fed6bb7 | 2007-09-12 19:00:10 +0000 | [diff] [blame] | 69 | x = _possibly_sorted(x) |
Raymond Hettinger | ba6cd36 | 2004-05-21 10:00:15 +0000 | [diff] [blame] | 70 | return self._repr_iterable(x, level, 'frozenset([', '])', |
| 71 | self.maxfrozenset) |
Tim Peters | 6ee0480 | 2003-02-05 18:29:34 +0000 | [diff] [blame] | 72 | |
Raymond Hettinger | 1453e4a | 2004-05-21 23:01:18 +0000 | [diff] [blame] | 73 | def repr_deque(self, x, level): |
| 74 | return self._repr_iterable(x, level, 'deque([', '])', self.maxdeque) |
| 75 | |
Tim Peters | a427a2b | 2001-10-29 22:25:45 +0000 | [diff] [blame] | 76 | def repr_dict(self, x, level): |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 77 | n = len(x) |
| 78 | if n == 0: return '{}' |
| 79 | if level <= 0: return '{...}' |
Raymond Hettinger | ba6cd36 | 2004-05-21 10:00:15 +0000 | [diff] [blame] | 80 | newlevel = level - 1 |
| 81 | repr1 = self.repr1 |
| 82 | pieces = [] |
Georg Brandl | fed6bb7 | 2007-09-12 19:00:10 +0000 | [diff] [blame] | 83 | for key in islice(_possibly_sorted(x), self.maxdict): |
Raymond Hettinger | ba6cd36 | 2004-05-21 10:00:15 +0000 | [diff] [blame] | 84 | keyrepr = repr1(key, newlevel) |
| 85 | valrepr = repr1(x[key], newlevel) |
| 86 | pieces.append('%s: %s' % (keyrepr, valrepr)) |
| 87 | if n > self.maxdict: pieces.append('...') |
| 88 | s = ', '.join(pieces) |
| 89 | return '{%s}' % (s,) |
| 90 | |
Tim Peters | 6d6c1a3 | 2001-08-02 04:15:00 +0000 | [diff] [blame] | 91 | def repr_str(self, x, level): |
Walter Dörwald | 70a6b49 | 2004-02-12 17:35:32 +0000 | [diff] [blame] | 92 | s = __builtin__.repr(x[:self.maxstring]) |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 93 | if len(s) > self.maxstring: |
Guido van Rossum | 54e54c6 | 2001-09-04 19:14:14 +0000 | [diff] [blame] | 94 | i = max(0, (self.maxstring-3)//2) |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 95 | j = max(0, self.maxstring-3-i) |
Walter Dörwald | 70a6b49 | 2004-02-12 17:35:32 +0000 | [diff] [blame] | 96 | s = __builtin__.repr(x[:i] + x[len(x)-j:]) |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 97 | s = s[:i] + '...' + s[len(s)-j:] |
| 98 | return s |
Raymond Hettinger | ba6cd36 | 2004-05-21 10:00:15 +0000 | [diff] [blame] | 99 | |
Tim Peters | 6d6c1a3 | 2001-08-02 04:15:00 +0000 | [diff] [blame] | 100 | def repr_long(self, x, level): |
Walter Dörwald | 70a6b49 | 2004-02-12 17:35:32 +0000 | [diff] [blame] | 101 | s = __builtin__.repr(x) # XXX Hope this isn't too slow... |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 102 | if len(s) > self.maxlong: |
Guido van Rossum | 54e54c6 | 2001-09-04 19:14:14 +0000 | [diff] [blame] | 103 | i = max(0, (self.maxlong-3)//2) |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 104 | j = max(0, self.maxlong-3-i) |
| 105 | s = s[:i] + '...' + s[len(s)-j:] |
| 106 | return s |
Raymond Hettinger | ba6cd36 | 2004-05-21 10:00:15 +0000 | [diff] [blame] | 107 | |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 108 | def repr_instance(self, x, level): |
| 109 | try: |
Walter Dörwald | 70a6b49 | 2004-02-12 17:35:32 +0000 | [diff] [blame] | 110 | s = __builtin__.repr(x) |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 111 | # Bugs in x.__repr__() can cause arbitrary |
| 112 | # exceptions -- then make up something |
Georg Brandl | fed6bb7 | 2007-09-12 19:00:10 +0000 | [diff] [blame] | 113 | except Exception: |
Fred Drake | 83a6430 | 2004-07-01 20:28:47 +0000 | [diff] [blame] | 114 | return '<%s instance at %x>' % (x.__class__.__name__, id(x)) |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 115 | if len(s) > self.maxstring: |
Guido van Rossum | 54e54c6 | 2001-09-04 19:14:14 +0000 | [diff] [blame] | 116 | i = max(0, (self.maxstring-3)//2) |
Tim Peters | 0c9886d | 2001-01-15 01:18:21 +0000 | [diff] [blame] | 117 | j = max(0, self.maxstring-3-i) |
| 118 | s = s[:i] + '...' + s[len(s)-j:] |
| 119 | return s |
Guido van Rossum | babe2bf | 1992-01-22 22:21:31 +0000 | [diff] [blame] | 120 | |
Georg Brandl | fed6bb7 | 2007-09-12 19:00:10 +0000 | [diff] [blame] | 121 | |
| 122 | def _possibly_sorted(x): |
| 123 | # Since not all sequences of items can be sorted and comparison |
| 124 | # functions may raise arbitrary exceptions, return an unsorted |
| 125 | # sequence in that case. |
| 126 | try: |
| 127 | return sorted(x) |
| 128 | except Exception: |
| 129 | return list(x) |
| 130 | |
Guido van Rossum | 7bc817d | 1993-12-17 15:25:27 +0000 | [diff] [blame] | 131 | aRepr = Repr() |
Guido van Rossum | babe2bf | 1992-01-22 22:21:31 +0000 | [diff] [blame] | 132 | repr = aRepr.repr |