##// END OF EJS Templates
Remove try/except handing Python2 (#14204)
Matthias Bussonnier -
r28460:5d64897b merge
parent child Browse files
Show More
@@ -1,953 +1,944 b''
1 1 # -*- coding: utf-8 -*-
2 2 """
3 3 Python advanced pretty printer. This pretty printer is intended to
4 4 replace the old `pprint` python module which does not allow developers
5 5 to provide their own pretty print callbacks.
6 6
7 7 This module is based on ruby's `prettyprint.rb` library by `Tanaka Akira`.
8 8
9 9
10 10 Example Usage
11 11 -------------
12 12
13 13 To directly print the representation of an object use `pprint`::
14 14
15 15 from pretty import pprint
16 16 pprint(complex_object)
17 17
18 18 To get a string of the output use `pretty`::
19 19
20 20 from pretty import pretty
21 21 string = pretty(complex_object)
22 22
23 23
24 24 Extending
25 25 ---------
26 26
27 27 The pretty library allows developers to add pretty printing rules for their
28 28 own objects. This process is straightforward. All you have to do is to
29 29 add a `_repr_pretty_` method to your object and call the methods on the
30 30 pretty printer passed::
31 31
32 32 class MyObject(object):
33 33
34 34 def _repr_pretty_(self, p, cycle):
35 35 ...
36 36
37 37 Here's an example for a class with a simple constructor::
38 38
39 39 class MySimpleObject:
40 40
41 41 def __init__(self, a, b, *, c=None):
42 42 self.a = a
43 43 self.b = b
44 44 self.c = c
45 45
46 46 def _repr_pretty_(self, p, cycle):
47 47 ctor = CallExpression.factory(self.__class__.__name__)
48 48 if self.c is None:
49 49 p.pretty(ctor(a, b))
50 50 else:
51 51 p.pretty(ctor(a, b, c=c))
52 52
53 53 Here is an example implementation of a `_repr_pretty_` method for a list
54 54 subclass::
55 55
56 56 class MyList(list):
57 57
58 58 def _repr_pretty_(self, p, cycle):
59 59 if cycle:
60 60 p.text('MyList(...)')
61 61 else:
62 62 with p.group(8, 'MyList([', '])'):
63 63 for idx, item in enumerate(self):
64 64 if idx:
65 65 p.text(',')
66 66 p.breakable()
67 67 p.pretty(item)
68 68
69 69 The `cycle` parameter is `True` if pretty detected a cycle. You *have* to
70 70 react to that or the result is an infinite loop. `p.text()` just adds
71 71 non breaking text to the output, `p.breakable()` either adds a whitespace
72 72 or breaks here. If you pass it an argument it's used instead of the
73 73 default space. `p.pretty` prettyprints another object using the pretty print
74 74 method.
75 75
76 76 The first parameter to the `group` function specifies the extra indentation
77 77 of the next line. In this example the next item will either be on the same
78 78 line (if the items are short enough) or aligned with the right edge of the
79 79 opening bracket of `MyList`.
80 80
81 81 If you just want to indent something you can use the group function
82 82 without open / close parameters. You can also use this code::
83 83
84 84 with p.indent(2):
85 85 ...
86 86
87 87 Inheritance diagram:
88 88
89 89 .. inheritance-diagram:: IPython.lib.pretty
90 90 :parts: 3
91 91
92 92 :copyright: 2007 by Armin Ronacher.
93 93 Portions (c) 2009 by Robert Kern.
94 94 :license: BSD License.
95 95 """
96 96
97 97 from contextlib import contextmanager
98 98 import datetime
99 99 import os
100 100 import re
101 101 import sys
102 102 import types
103 103 from collections import deque
104 104 from inspect import signature
105 105 from io import StringIO
106 106 from warnings import warn
107 107
108 108 from IPython.utils.decorators import undoc
109 109 from IPython.utils.py3compat import PYPY
110 110
111 111 __all__ = ['pretty', 'pprint', 'PrettyPrinter', 'RepresentationPrinter',
112 112 'for_type', 'for_type_by_name', 'RawText', 'RawStringLiteral', 'CallExpression']
113 113
114 114
115 115 MAX_SEQ_LENGTH = 1000
116 116 _re_pattern_type = type(re.compile(''))
117 117
118 118 def _safe_getattr(obj, attr, default=None):
119 119 """Safe version of getattr.
120 120
121 121 Same as getattr, but will return ``default`` on any Exception,
122 122 rather than raising.
123 123 """
124 124 try:
125 125 return getattr(obj, attr, default)
126 126 except Exception:
127 127 return default
128 128
129 129 @undoc
130 130 class CUnicodeIO(StringIO):
131 131 def __init__(self, *args, **kwargs):
132 132 super().__init__(*args, **kwargs)
133 133 warn(("CUnicodeIO is deprecated since IPython 6.0. "
134 134 "Please use io.StringIO instead."),
135 135 DeprecationWarning, stacklevel=2)
136 136
137 137 def _sorted_for_pprint(items):
138 138 """
139 139 Sort the given items for pretty printing. Since some predictable
140 140 sorting is better than no sorting at all, we sort on the string
141 141 representation if normal sorting fails.
142 142 """
143 143 items = list(items)
144 144 try:
145 145 return sorted(items)
146 146 except Exception:
147 147 try:
148 148 return sorted(items, key=str)
149 149 except Exception:
150 150 return items
151 151
152 152 def pretty(obj, verbose=False, max_width=79, newline='\n', max_seq_length=MAX_SEQ_LENGTH):
153 153 """
154 154 Pretty print the object's representation.
155 155 """
156 156 stream = StringIO()
157 157 printer = RepresentationPrinter(stream, verbose, max_width, newline, max_seq_length=max_seq_length)
158 158 printer.pretty(obj)
159 159 printer.flush()
160 160 return stream.getvalue()
161 161
162 162
163 163 def pprint(obj, verbose=False, max_width=79, newline='\n', max_seq_length=MAX_SEQ_LENGTH):
164 164 """
165 165 Like `pretty` but print to stdout.
166 166 """
167 167 printer = RepresentationPrinter(sys.stdout, verbose, max_width, newline, max_seq_length=max_seq_length)
168 168 printer.pretty(obj)
169 169 printer.flush()
170 170 sys.stdout.write(newline)
171 171 sys.stdout.flush()
172 172
173 173 class _PrettyPrinterBase(object):
174 174
175 175 @contextmanager
176 176 def indent(self, indent):
177 177 """with statement support for indenting/dedenting."""
178 178 self.indentation += indent
179 179 try:
180 180 yield
181 181 finally:
182 182 self.indentation -= indent
183 183
184 184 @contextmanager
185 185 def group(self, indent=0, open='', close=''):
186 186 """like begin_group / end_group but for the with statement."""
187 187 self.begin_group(indent, open)
188 188 try:
189 189 yield
190 190 finally:
191 191 self.end_group(indent, close)
192 192
193 193 class PrettyPrinter(_PrettyPrinterBase):
194 194 """
195 195 Baseclass for the `RepresentationPrinter` prettyprinter that is used to
196 196 generate pretty reprs of objects. Contrary to the `RepresentationPrinter`
197 197 this printer knows nothing about the default pprinters or the `_repr_pretty_`
198 198 callback method.
199 199 """
200 200
201 201 def __init__(self, output, max_width=79, newline='\n', max_seq_length=MAX_SEQ_LENGTH):
202 202 self.output = output
203 203 self.max_width = max_width
204 204 self.newline = newline
205 205 self.max_seq_length = max_seq_length
206 206 self.output_width = 0
207 207 self.buffer_width = 0
208 208 self.buffer = deque()
209 209
210 210 root_group = Group(0)
211 211 self.group_stack = [root_group]
212 212 self.group_queue = GroupQueue(root_group)
213 213 self.indentation = 0
214 214
215 215 def _break_one_group(self, group):
216 216 while group.breakables:
217 217 x = self.buffer.popleft()
218 218 self.output_width = x.output(self.output, self.output_width)
219 219 self.buffer_width -= x.width
220 220 while self.buffer and isinstance(self.buffer[0], Text):
221 221 x = self.buffer.popleft()
222 222 self.output_width = x.output(self.output, self.output_width)
223 223 self.buffer_width -= x.width
224 224
225 225 def _break_outer_groups(self):
226 226 while self.max_width < self.output_width + self.buffer_width:
227 227 group = self.group_queue.deq()
228 228 if not group:
229 229 return
230 230 self._break_one_group(group)
231 231
232 232 def text(self, obj):
233 233 """Add literal text to the output."""
234 234 width = len(obj)
235 235 if self.buffer:
236 236 text = self.buffer[-1]
237 237 if not isinstance(text, Text):
238 238 text = Text()
239 239 self.buffer.append(text)
240 240 text.add(obj, width)
241 241 self.buffer_width += width
242 242 self._break_outer_groups()
243 243 else:
244 244 self.output.write(obj)
245 245 self.output_width += width
246 246
247 247 def breakable(self, sep=' '):
248 248 """
249 249 Add a breakable separator to the output. This does not mean that it
250 250 will automatically break here. If no breaking on this position takes
251 251 place the `sep` is inserted which default to one space.
252 252 """
253 253 width = len(sep)
254 254 group = self.group_stack[-1]
255 255 if group.want_break:
256 256 self.flush()
257 257 self.output.write(self.newline)
258 258 self.output.write(' ' * self.indentation)
259 259 self.output_width = self.indentation
260 260 self.buffer_width = 0
261 261 else:
262 262 self.buffer.append(Breakable(sep, width, self))
263 263 self.buffer_width += width
264 264 self._break_outer_groups()
265 265
266 266 def break_(self):
267 267 """
268 268 Explicitly insert a newline into the output, maintaining correct indentation.
269 269 """
270 270 group = self.group_queue.deq()
271 271 if group:
272 272 self._break_one_group(group)
273 273 self.flush()
274 274 self.output.write(self.newline)
275 275 self.output.write(' ' * self.indentation)
276 276 self.output_width = self.indentation
277 277 self.buffer_width = 0
278 278
279 279
280 280 def begin_group(self, indent=0, open=''):
281 281 """
282 282 Begin a group.
283 283 The first parameter specifies the indentation for the next line (usually
284 284 the width of the opening text), the second the opening text. All
285 285 parameters are optional.
286 286 """
287 287 if open:
288 288 self.text(open)
289 289 group = Group(self.group_stack[-1].depth + 1)
290 290 self.group_stack.append(group)
291 291 self.group_queue.enq(group)
292 292 self.indentation += indent
293 293
294 294 def _enumerate(self, seq):
295 295 """like enumerate, but with an upper limit on the number of items"""
296 296 for idx, x in enumerate(seq):
297 297 if self.max_seq_length and idx >= self.max_seq_length:
298 298 self.text(',')
299 299 self.breakable()
300 300 self.text('...')
301 301 return
302 302 yield idx, x
303 303
304 304 def end_group(self, dedent=0, close=''):
305 305 """End a group. See `begin_group` for more details."""
306 306 self.indentation -= dedent
307 307 group = self.group_stack.pop()
308 308 if not group.breakables:
309 309 self.group_queue.remove(group)
310 310 if close:
311 311 self.text(close)
312 312
313 313 def flush(self):
314 314 """Flush data that is left in the buffer."""
315 315 for data in self.buffer:
316 316 self.output_width += data.output(self.output, self.output_width)
317 317 self.buffer.clear()
318 318 self.buffer_width = 0
319 319
320 320
321 321 def _get_mro(obj_class):
322 322 """ Get a reasonable method resolution order of a class and its superclasses
323 323 for both old-style and new-style classes.
324 324 """
325 325 if not hasattr(obj_class, '__mro__'):
326 326 # Old-style class. Mix in object to make a fake new-style class.
327 327 try:
328 328 obj_class = type(obj_class.__name__, (obj_class, object), {})
329 329 except TypeError:
330 330 # Old-style extension type that does not descend from object.
331 331 # FIXME: try to construct a more thorough MRO.
332 332 mro = [obj_class]
333 333 else:
334 334 mro = obj_class.__mro__[1:-1]
335 335 else:
336 336 mro = obj_class.__mro__
337 337 return mro
338 338
339 339
340 340 class RepresentationPrinter(PrettyPrinter):
341 341 """
342 342 Special pretty printer that has a `pretty` method that calls the pretty
343 343 printer for a python object.
344 344
345 345 This class stores processing data on `self` so you must *never* use
346 346 this class in a threaded environment. Always lock it or reinstanciate
347 347 it.
348 348
349 349 Instances also have a verbose flag callbacks can access to control their
350 350 output. For example the default instance repr prints all attributes and
351 351 methods that are not prefixed by an underscore if the printer is in
352 352 verbose mode.
353 353 """
354 354
355 355 def __init__(self, output, verbose=False, max_width=79, newline='\n',
356 356 singleton_pprinters=None, type_pprinters=None, deferred_pprinters=None,
357 357 max_seq_length=MAX_SEQ_LENGTH):
358 358
359 359 PrettyPrinter.__init__(self, output, max_width, newline, max_seq_length=max_seq_length)
360 360 self.verbose = verbose
361 361 self.stack = []
362 362 if singleton_pprinters is None:
363 363 singleton_pprinters = _singleton_pprinters.copy()
364 364 self.singleton_pprinters = singleton_pprinters
365 365 if type_pprinters is None:
366 366 type_pprinters = _type_pprinters.copy()
367 367 self.type_pprinters = type_pprinters
368 368 if deferred_pprinters is None:
369 369 deferred_pprinters = _deferred_type_pprinters.copy()
370 370 self.deferred_pprinters = deferred_pprinters
371 371
372 372 def pretty(self, obj):
373 373 """Pretty print the given object."""
374 374 obj_id = id(obj)
375 375 cycle = obj_id in self.stack
376 376 self.stack.append(obj_id)
377 377 self.begin_group()
378 378 try:
379 379 obj_class = _safe_getattr(obj, '__class__', None) or type(obj)
380 380 # First try to find registered singleton printers for the type.
381 381 try:
382 382 printer = self.singleton_pprinters[obj_id]
383 383 except (TypeError, KeyError):
384 384 pass
385 385 else:
386 386 return printer(obj, self, cycle)
387 387 # Next walk the mro and check for either:
388 388 # 1) a registered printer
389 389 # 2) a _repr_pretty_ method
390 390 for cls in _get_mro(obj_class):
391 391 if cls in self.type_pprinters:
392 392 # printer registered in self.type_pprinters
393 393 return self.type_pprinters[cls](obj, self, cycle)
394 394 else:
395 395 # deferred printer
396 396 printer = self._in_deferred_types(cls)
397 397 if printer is not None:
398 398 return printer(obj, self, cycle)
399 399 else:
400 400 # Finally look for special method names.
401 401 # Some objects automatically create any requested
402 402 # attribute. Try to ignore most of them by checking for
403 403 # callability.
404 404 if '_repr_pretty_' in cls.__dict__:
405 405 meth = cls._repr_pretty_
406 406 if callable(meth):
407 407 return meth(obj, self, cycle)
408 408 if cls is not object \
409 409 and callable(cls.__dict__.get('__repr__')):
410 410 return _repr_pprint(obj, self, cycle)
411 411
412 412 return _default_pprint(obj, self, cycle)
413 413 finally:
414 414 self.end_group()
415 415 self.stack.pop()
416 416
417 417 def _in_deferred_types(self, cls):
418 418 """
419 419 Check if the given class is specified in the deferred type registry.
420 420
421 421 Returns the printer from the registry if it exists, and None if the
422 422 class is not in the registry. Successful matches will be moved to the
423 423 regular type registry for future use.
424 424 """
425 425 mod = _safe_getattr(cls, '__module__', None)
426 426 name = _safe_getattr(cls, '__name__', None)
427 427 key = (mod, name)
428 428 printer = None
429 429 if key in self.deferred_pprinters:
430 430 # Move the printer over to the regular registry.
431 431 printer = self.deferred_pprinters.pop(key)
432 432 self.type_pprinters[cls] = printer
433 433 return printer
434 434
435 435
436 436 class Printable(object):
437 437
438 438 def output(self, stream, output_width):
439 439 return output_width
440 440
441 441
442 442 class Text(Printable):
443 443
444 444 def __init__(self):
445 445 self.objs = []
446 446 self.width = 0
447 447
448 448 def output(self, stream, output_width):
449 449 for obj in self.objs:
450 450 stream.write(obj)
451 451 return output_width + self.width
452 452
453 453 def add(self, obj, width):
454 454 self.objs.append(obj)
455 455 self.width += width
456 456
457 457
458 458 class Breakable(Printable):
459 459
460 460 def __init__(self, seq, width, pretty):
461 461 self.obj = seq
462 462 self.width = width
463 463 self.pretty = pretty
464 464 self.indentation = pretty.indentation
465 465 self.group = pretty.group_stack[-1]
466 466 self.group.breakables.append(self)
467 467
468 468 def output(self, stream, output_width):
469 469 self.group.breakables.popleft()
470 470 if self.group.want_break:
471 471 stream.write(self.pretty.newline)
472 472 stream.write(' ' * self.indentation)
473 473 return self.indentation
474 474 if not self.group.breakables:
475 475 self.pretty.group_queue.remove(self.group)
476 476 stream.write(self.obj)
477 477 return output_width + self.width
478 478
479 479
480 480 class Group(Printable):
481 481
482 482 def __init__(self, depth):
483 483 self.depth = depth
484 484 self.breakables = deque()
485 485 self.want_break = False
486 486
487 487
488 488 class GroupQueue(object):
489 489
490 490 def __init__(self, *groups):
491 491 self.queue = []
492 492 for group in groups:
493 493 self.enq(group)
494 494
495 495 def enq(self, group):
496 496 depth = group.depth
497 497 while depth > len(self.queue) - 1:
498 498 self.queue.append([])
499 499 self.queue[depth].append(group)
500 500
501 501 def deq(self):
502 502 for stack in self.queue:
503 503 for idx, group in enumerate(reversed(stack)):
504 504 if group.breakables:
505 505 del stack[idx]
506 506 group.want_break = True
507 507 return group
508 508 for group in stack:
509 509 group.want_break = True
510 510 del stack[:]
511 511
512 512 def remove(self, group):
513 513 try:
514 514 self.queue[group.depth].remove(group)
515 515 except ValueError:
516 516 pass
517 517
518 518
519 519 class RawText:
520 520 """ Object such that ``p.pretty(RawText(value))`` is the same as ``p.text(value)``.
521 521
522 522 An example usage of this would be to show a list as binary numbers, using
523 523 ``p.pretty([RawText(bin(i)) for i in integers])``.
524 524 """
525 525 def __init__(self, value):
526 526 self.value = value
527 527
528 528 def _repr_pretty_(self, p, cycle):
529 529 p.text(self.value)
530 530
531 531
532 532 class CallExpression:
533 533 """ Object which emits a line-wrapped call expression in the form `__name(*args, **kwargs)` """
534 534 def __init__(__self, __name, *args, **kwargs):
535 535 # dunders are to avoid clashes with kwargs, as python's name manging
536 536 # will kick in.
537 537 self = __self
538 538 self.name = __name
539 539 self.args = args
540 540 self.kwargs = kwargs
541 541
542 542 @classmethod
543 543 def factory(cls, name):
544 544 def inner(*args, **kwargs):
545 545 return cls(name, *args, **kwargs)
546 546 return inner
547 547
548 548 def _repr_pretty_(self, p, cycle):
549 549 # dunders are to avoid clashes with kwargs, as python's name manging
550 550 # will kick in.
551 551
552 552 started = False
553 553 def new_item():
554 554 nonlocal started
555 555 if started:
556 556 p.text(",")
557 557 p.breakable()
558 558 started = True
559 559
560 560 prefix = self.name + "("
561 561 with p.group(len(prefix), prefix, ")"):
562 562 for arg in self.args:
563 563 new_item()
564 564 p.pretty(arg)
565 565 for arg_name, arg in self.kwargs.items():
566 566 new_item()
567 567 arg_prefix = arg_name + "="
568 568 with p.group(len(arg_prefix), arg_prefix):
569 569 p.pretty(arg)
570 570
571 571
572 572 class RawStringLiteral:
573 573 """ Wrapper that shows a string with a `r` prefix """
574 574 def __init__(self, value):
575 575 self.value = value
576 576
577 577 def _repr_pretty_(self, p, cycle):
578 578 base_repr = repr(self.value)
579 579 if base_repr[:1] in 'uU':
580 580 base_repr = base_repr[1:]
581 581 prefix = 'ur'
582 582 else:
583 583 prefix = 'r'
584 584 base_repr = prefix + base_repr.replace('\\\\', '\\')
585 585 p.text(base_repr)
586 586
587 587
588 588 def _default_pprint(obj, p, cycle):
589 589 """
590 590 The default print function. Used if an object does not provide one and
591 591 it's none of the builtin objects.
592 592 """
593 593 klass = _safe_getattr(obj, '__class__', None) or type(obj)
594 594 if _safe_getattr(klass, '__repr__', None) is not object.__repr__:
595 595 # A user-provided repr. Find newlines and replace them with p.break_()
596 596 _repr_pprint(obj, p, cycle)
597 597 return
598 598 p.begin_group(1, '<')
599 599 p.pretty(klass)
600 600 p.text(' at 0x%x' % id(obj))
601 601 if cycle:
602 602 p.text(' ...')
603 603 elif p.verbose:
604 604 first = True
605 605 for key in dir(obj):
606 606 if not key.startswith('_'):
607 607 try:
608 608 value = getattr(obj, key)
609 609 except AttributeError:
610 610 continue
611 611 if isinstance(value, types.MethodType):
612 612 continue
613 613 if not first:
614 614 p.text(',')
615 615 p.breakable()
616 616 p.text(key)
617 617 p.text('=')
618 618 step = len(key) + 1
619 619 p.indentation += step
620 620 p.pretty(value)
621 621 p.indentation -= step
622 622 first = False
623 623 p.end_group(1, '>')
624 624
625 625
626 626 def _seq_pprinter_factory(start, end):
627 627 """
628 628 Factory that returns a pprint function useful for sequences. Used by
629 629 the default pprint for tuples and lists.
630 630 """
631 631 def inner(obj, p, cycle):
632 632 if cycle:
633 633 return p.text(start + '...' + end)
634 634 step = len(start)
635 635 p.begin_group(step, start)
636 636 for idx, x in p._enumerate(obj):
637 637 if idx:
638 638 p.text(',')
639 639 p.breakable()
640 640 p.pretty(x)
641 641 if len(obj) == 1 and isinstance(obj, tuple):
642 642 # Special case for 1-item tuples.
643 643 p.text(',')
644 644 p.end_group(step, end)
645 645 return inner
646 646
647 647
648 648 def _set_pprinter_factory(start, end):
649 649 """
650 650 Factory that returns a pprint function useful for sets and frozensets.
651 651 """
652 652 def inner(obj, p, cycle):
653 653 if cycle:
654 654 return p.text(start + '...' + end)
655 655 if len(obj) == 0:
656 656 # Special case.
657 657 p.text(type(obj).__name__ + '()')
658 658 else:
659 659 step = len(start)
660 660 p.begin_group(step, start)
661 661 # Like dictionary keys, we will try to sort the items if there aren't too many
662 662 if not (p.max_seq_length and len(obj) >= p.max_seq_length):
663 663 items = _sorted_for_pprint(obj)
664 664 else:
665 665 items = obj
666 666 for idx, x in p._enumerate(items):
667 667 if idx:
668 668 p.text(',')
669 669 p.breakable()
670 670 p.pretty(x)
671 671 p.end_group(step, end)
672 672 return inner
673 673
674 674
675 675 def _dict_pprinter_factory(start, end):
676 676 """
677 677 Factory that returns a pprint function used by the default pprint of
678 678 dicts and dict proxies.
679 679 """
680 680 def inner(obj, p, cycle):
681 681 if cycle:
682 682 return p.text('{...}')
683 683 step = len(start)
684 684 p.begin_group(step, start)
685 685 keys = obj.keys()
686 686 for idx, key in p._enumerate(keys):
687 687 if idx:
688 688 p.text(',')
689 689 p.breakable()
690 690 p.pretty(key)
691 691 p.text(': ')
692 692 p.pretty(obj[key])
693 693 p.end_group(step, end)
694 694 return inner
695 695
696 696
697 697 def _super_pprint(obj, p, cycle):
698 698 """The pprint for the super type."""
699 699 p.begin_group(8, '<super: ')
700 700 p.pretty(obj.__thisclass__)
701 701 p.text(',')
702 702 p.breakable()
703 703 if PYPY: # In PyPy, super() objects don't have __self__ attributes
704 704 dself = obj.__repr__.__self__
705 705 p.pretty(None if dself is obj else dself)
706 706 else:
707 707 p.pretty(obj.__self__)
708 708 p.end_group(8, '>')
709 709
710 710
711 711
712 712 class _ReFlags:
713 713 def __init__(self, value):
714 714 self.value = value
715 715
716 716 def _repr_pretty_(self, p, cycle):
717 717 done_one = False
718 718 for flag in ('TEMPLATE', 'IGNORECASE', 'LOCALE', 'MULTILINE', 'DOTALL',
719 719 'UNICODE', 'VERBOSE', 'DEBUG'):
720 720 if self.value & getattr(re, flag):
721 721 if done_one:
722 722 p.text('|')
723 723 p.text('re.' + flag)
724 724 done_one = True
725 725
726 726
727 727 def _re_pattern_pprint(obj, p, cycle):
728 728 """The pprint function for regular expression patterns."""
729 729 re_compile = CallExpression.factory('re.compile')
730 730 if obj.flags:
731 731 p.pretty(re_compile(RawStringLiteral(obj.pattern), _ReFlags(obj.flags)))
732 732 else:
733 733 p.pretty(re_compile(RawStringLiteral(obj.pattern)))
734 734
735 735
736 736 def _types_simplenamespace_pprint(obj, p, cycle):
737 737 """The pprint function for types.SimpleNamespace."""
738 738 namespace = CallExpression.factory('namespace')
739 739 if cycle:
740 740 p.pretty(namespace(RawText("...")))
741 741 else:
742 742 p.pretty(namespace(**obj.__dict__))
743 743
744 744
745 745 def _type_pprint(obj, p, cycle):
746 746 """The pprint for classes and types."""
747 747 # Heap allocated types might not have the module attribute,
748 748 # and others may set it to None.
749 749
750 750 # Checks for a __repr__ override in the metaclass. Can't compare the
751 751 # type(obj).__repr__ directly because in PyPy the representation function
752 752 # inherited from type isn't the same type.__repr__
753 753 if [m for m in _get_mro(type(obj)) if "__repr__" in vars(m)][:1] != [type]:
754 754 _repr_pprint(obj, p, cycle)
755 755 return
756 756
757 757 mod = _safe_getattr(obj, '__module__', None)
758 758 try:
759 759 name = obj.__qualname__
760 760 if not isinstance(name, str):
761 761 # This can happen if the type implements __qualname__ as a property
762 762 # or other descriptor in Python 2.
763 763 raise Exception("Try __name__")
764 764 except Exception:
765 765 name = obj.__name__
766 766 if not isinstance(name, str):
767 767 name = '<unknown type>'
768 768
769 769 if mod in (None, '__builtin__', 'builtins', 'exceptions'):
770 770 p.text(name)
771 771 else:
772 772 p.text(mod + '.' + name)
773 773
774 774
775 775 def _repr_pprint(obj, p, cycle):
776 776 """A pprint that just redirects to the normal repr function."""
777 777 # Find newlines and replace them with p.break_()
778 778 output = repr(obj)
779 779 lines = output.splitlines()
780 780 with p.group():
781 781 for idx, output_line in enumerate(lines):
782 782 if idx:
783 783 p.break_()
784 784 p.text(output_line)
785 785
786 786
787 787 def _function_pprint(obj, p, cycle):
788 788 """Base pprint for all functions and builtin functions."""
789 789 name = _safe_getattr(obj, '__qualname__', obj.__name__)
790 790 mod = obj.__module__
791 791 if mod and mod not in ('__builtin__', 'builtins', 'exceptions'):
792 792 name = mod + '.' + name
793 793 try:
794 794 func_def = name + str(signature(obj))
795 795 except ValueError:
796 796 func_def = name
797 797 p.text('<function %s>' % func_def)
798 798
799 799
800 800 def _exception_pprint(obj, p, cycle):
801 801 """Base pprint for all exceptions."""
802 802 name = getattr(obj.__class__, '__qualname__', obj.__class__.__name__)
803 803 if obj.__class__.__module__ not in ('exceptions', 'builtins'):
804 804 name = '%s.%s' % (obj.__class__.__module__, name)
805 805
806 806 p.pretty(CallExpression(name, *getattr(obj, 'args', ())))
807 807
808 808
809 809 #: the exception base
810 810 try:
811 811 _exception_base = BaseException
812 812 except NameError:
813 813 _exception_base = Exception
814 814
815 815
816 816 #: printers for builtin types
817 817 _type_pprinters = {
818 818 int: _repr_pprint,
819 819 float: _repr_pprint,
820 820 str: _repr_pprint,
821 821 tuple: _seq_pprinter_factory('(', ')'),
822 822 list: _seq_pprinter_factory('[', ']'),
823 823 dict: _dict_pprinter_factory('{', '}'),
824 824 set: _set_pprinter_factory('{', '}'),
825 825 frozenset: _set_pprinter_factory('frozenset({', '})'),
826 826 super: _super_pprint,
827 827 _re_pattern_type: _re_pattern_pprint,
828 828 type: _type_pprint,
829 829 types.FunctionType: _function_pprint,
830 830 types.BuiltinFunctionType: _function_pprint,
831 831 types.MethodType: _repr_pprint,
832 832 types.SimpleNamespace: _types_simplenamespace_pprint,
833 833 datetime.datetime: _repr_pprint,
834 834 datetime.timedelta: _repr_pprint,
835 835 _exception_base: _exception_pprint
836 836 }
837 837
838 838 # render os.environ like a dict
839 839 _env_type = type(os.environ)
840 840 # future-proof in case os.environ becomes a plain dict?
841 841 if _env_type is not dict:
842 842 _type_pprinters[_env_type] = _dict_pprinter_factory('environ{', '}')
843 843
844 try:
845 # In PyPy, types.DictProxyType is dict, setting the dictproxy printer
846 # using dict.setdefault avoids overwriting the dict printer
847 _type_pprinters.setdefault(types.DictProxyType,
848 _dict_pprinter_factory('dict_proxy({', '})'))
849 _type_pprinters[types.ClassType] = _type_pprint
850 _type_pprinters[types.SliceType] = _repr_pprint
851 except AttributeError: # Python 3
852 _type_pprinters[types.MappingProxyType] = \
853 _dict_pprinter_factory('mappingproxy({', '})')
854 _type_pprinters[slice] = _repr_pprint
844 _type_pprinters[types.MappingProxyType] = _dict_pprinter_factory("mappingproxy({", "})")
845 _type_pprinters[slice] = _repr_pprint
855 846
856 847 _type_pprinters[range] = _repr_pprint
857 848 _type_pprinters[bytes] = _repr_pprint
858 849
859 850 #: printers for types specified by name
860 851 _deferred_type_pprinters = {
861 852 }
862 853
863 854 def for_type(typ, func):
864 855 """
865 856 Add a pretty printer for a given type.
866 857 """
867 858 oldfunc = _type_pprinters.get(typ, None)
868 859 if func is not None:
869 860 # To support easy restoration of old pprinters, we need to ignore Nones.
870 861 _type_pprinters[typ] = func
871 862 return oldfunc
872 863
873 864 def for_type_by_name(type_module, type_name, func):
874 865 """
875 866 Add a pretty printer for a type specified by the module and name of a type
876 867 rather than the type object itself.
877 868 """
878 869 key = (type_module, type_name)
879 870 oldfunc = _deferred_type_pprinters.get(key, None)
880 871 if func is not None:
881 872 # To support easy restoration of old pprinters, we need to ignore Nones.
882 873 _deferred_type_pprinters[key] = func
883 874 return oldfunc
884 875
885 876
886 877 #: printers for the default singletons
887 878 _singleton_pprinters = dict.fromkeys(map(id, [None, True, False, Ellipsis,
888 879 NotImplemented]), _repr_pprint)
889 880
890 881
891 882 def _defaultdict_pprint(obj, p, cycle):
892 883 cls_ctor = CallExpression.factory(obj.__class__.__name__)
893 884 if cycle:
894 885 p.pretty(cls_ctor(RawText("...")))
895 886 else:
896 887 p.pretty(cls_ctor(obj.default_factory, dict(obj)))
897 888
898 889 def _ordereddict_pprint(obj, p, cycle):
899 890 cls_ctor = CallExpression.factory(obj.__class__.__name__)
900 891 if cycle:
901 892 p.pretty(cls_ctor(RawText("...")))
902 893 elif len(obj):
903 894 p.pretty(cls_ctor(list(obj.items())))
904 895 else:
905 896 p.pretty(cls_ctor())
906 897
907 898 def _deque_pprint(obj, p, cycle):
908 899 cls_ctor = CallExpression.factory(obj.__class__.__name__)
909 900 if cycle:
910 901 p.pretty(cls_ctor(RawText("...")))
911 902 elif obj.maxlen is not None:
912 903 p.pretty(cls_ctor(list(obj), maxlen=obj.maxlen))
913 904 else:
914 905 p.pretty(cls_ctor(list(obj)))
915 906
916 907 def _counter_pprint(obj, p, cycle):
917 908 cls_ctor = CallExpression.factory(obj.__class__.__name__)
918 909 if cycle:
919 910 p.pretty(cls_ctor(RawText("...")))
920 911 elif len(obj):
921 912 p.pretty(cls_ctor(dict(obj.most_common())))
922 913 else:
923 914 p.pretty(cls_ctor())
924 915
925 916
926 917 def _userlist_pprint(obj, p, cycle):
927 918 cls_ctor = CallExpression.factory(obj.__class__.__name__)
928 919 if cycle:
929 920 p.pretty(cls_ctor(RawText("...")))
930 921 else:
931 922 p.pretty(cls_ctor(obj.data))
932 923
933 924
934 925 for_type_by_name('collections', 'defaultdict', _defaultdict_pprint)
935 926 for_type_by_name('collections', 'OrderedDict', _ordereddict_pprint)
936 927 for_type_by_name('collections', 'deque', _deque_pprint)
937 928 for_type_by_name('collections', 'Counter', _counter_pprint)
938 929 for_type_by_name("collections", "UserList", _userlist_pprint)
939 930
940 931 if __name__ == '__main__':
941 932 from random import randrange
942 933 class Foo(object):
943 934 def __init__(self):
944 935 self.foo = 1
945 936 self.bar = re.compile(r'\s+')
946 937 self.blub = dict.fromkeys(range(30), randrange(1, 40))
947 938 self.hehe = 23424.234234
948 939 self.list = ["blub", "blah", self]
949 940
950 941 def get_foo(self):
951 942 print("foo")
952 943
953 944 pprint(Foo(), verbose=True)
General Comments 0
You need to be logged in to leave comments. Login now