bpo-30670: Add pp function to the pprint module #11769
Conversation
Add sort_dicts to pprint.PrettyPrinter, pprint.pformat and pprint.pprint
| Added the *sort_dicts* parameter. | ||
|
|
||
|
|
||
| .. function:: pp(object, *args, sort_dicts=False, **kwargs) |
There was a problem hiding this comment.
Would it be worth explicitely saying that this is an alias of pprint() with sort_dict=False ?
There was a problem hiding this comment.
There is already a mention of *args and **kwargs being passed to pprint and sort_dicts=False is in the signature of pp so I don't think it is necessary.
I would like to also like to avoid giving to much details about pp implementation because we may change some things if another data structure of Python changes like dicts did.
There was a problem hiding this comment.
(if we were to do change what this function does, we would also change the doc, but I'm good with that.)
There was a problem hiding this comment.
Would it be worth explicitely saying that this is an alias of pprint() with sort_dict=False ?
At first glance I was puzzled why both pp() and pprint() existed, and it took a moment to spot the different default sort_dict value - and I ended up having to confirm via source code inspection that there were no other differences between the two.
As such, the above mentioned docs would have been useful for me personally :-)
|
Thanks @vadmium! |
* Add "pp" to __all__ * Drop mention of alphabetical sorting. It is just plain sorting (i.e. dict with integer keys get sorted as well). * Fix spelling of "parameter"
Add sort_dicts to pprint.PrettyPrinter, pprint.pformat and pprint.pprint
https://bugs.python.org/issue30670