2024年让Python输出更漂亮：PrettyPrinter_python prettyprint(2)

为什么Python还需要额外的美化打印包呢？

无论是IDE还是开发者手动运行命令，将数据打印到屏幕上是程序运行过程中程序员和数值交互的最基础的界面。改进该界面有助于提升开发体验和生产效率。Python本身和第三方库都提供了一些工具来达到此目的：

• **__repr__和__str__**两个下划线方法返回普通字符串。__repr__应该尽可能返回语法正确的Python表达式，断言判断失败及控制台计算结果打印最常用的就是该方法。由于其完全基于字符串格式化，因此并不具备美化打印的功能。
• 标准库中的pprint模块为dicts, lists, tuples, sets, and frozensets等内置数据类型提供了美化打印的功能。它将__repr__方法应用在用户自定义的类实例上。然而，它使用了非常贪婪的布局算法，导致在很多情况下的美化打印出现问题。由于自定义的美化打印受__repr__所限制，pprint的作用也就限制于内置数据类型了。
• 第三方库pprintpp是对pprint的改进及替代方案，也可以对输出进行优化，不过和pprint一样受限于__repr__使用的代码美化定义。
• IPython中默认的打印模块IPython.lib.pretty的目标是pprint更进阶的替代方案。和pprint相比，它在很多方面都表现得更好:大多数情况下算法都能对输出进行美化，而且提供了针对用户自定义类型美化输出的定义工具，能和输出的其他部分实现比较好的结合。不过，为了实现你自己的美化打印方式，你需要对布局算法有所了解。另外，该API 也有一些与生俱来的副作用：调用美化打印工具将数据直接推送至布局缓冲区，不允许原始布局对数据进行初步检测。

以上所有工具都达不到我对美化打印体验的要求，因此我开始做以下几点改进：

• 实现一个能尽可能多的美化打印的算法，即便在效率上做出一些牺牲。花十分之一秒对输出结果进行美化是非常划算的，因为当你需要在结果中寻找自己需要的数据时它将为你节约两秒钟的时间。
• 实现一个超级简单、描述性的接口来实现用户自定义的美化打印工具。Python成员几乎不会重写__repr__方法，因为这很痛苦；几乎没有人愿意为用户定义的类型编写整齐打印规则，除非类型非常简单。
• 实现不会在无效Python语法上中断的语法高亮显示。并不是所有__repr__方法都会返回有效的语法，一旦发生语法错误会打断正常的语法高亮。

新的代码美化包的使用体验令我非常惊讶。算法运行的很出色，效率也满足需求。而用户自定义美化规则的方法也很简单，仅仅需要了解两个描述性的函数 register_pretty和pretty_call即可。语法高亮看上去非常漂亮，且不会被无效语法处中断。特别是语法高亮，会使你很难再回到普通的美化打印工具，它大大提升了程序员的开发体验。

最有趣的改进是描述性API，下面是它的工作原理。

简单、描述性的API

在PrettyPrinter中定义输出美化方法主要基于（创建）函数调用。所有非字符的Python值都需要用函数结果表示。该库的主力函数是pretty_call， 它允许你来描述PrettyPrinter应该输出何种类型的函数调用。下面就是pretty_call调用的一个例子：

PrettyPrinter处理原始布局的过程类似于以下语句：

（第一个参数ctx允许用户控制案例中[5,3,6,1]列表中嵌套的数据，reverse参数的True值依据此进行渲染。大部分情况都直接使用默认值即可。）

上面介绍了如何使用Pretty_call，接下来定义我们自己的类型。

使用register_pretty修饰符，可以为MyClass类定义美化方式：

cpprint的输出如下：

点击 the PrettyPrinter definition code for standard library types，查看更多案例。

带状态实例的表示

调用函数的一个缺陷是无法很好的表示带状态的实例。通常你想要额外输出一些信息来表示实例的状态。PrettyPrinter使用解释性评论解决了这一问题，我对这一强大的特性颇为满意。使用评论来标注Python值（或者表示Python值的原始布局），该评论将神奇的出现在输出的结果中。

感谢每一个认真阅读我文章的人，看着粉丝一路的上涨和关注，礼尚往来总是要有的：

①　2000多本Python电子书（主流和经典的书籍应该都有了）

②　Python标准库资料（最全中文版）

③　项目源码（四五十个有趣且经典的练手项目及源码）

④　Python基础入门、爬虫、web开发、大数据分析方面的视频（适合小白学习）

⑤ Python学习路线图（告别不入流的学习）

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化学习资料的朋友，可以戳这里无偿获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！
一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！**