MEP8: PEP8#
状态#
已取代
当前的样式指南,包括 pep8 的使用,维护在 我们的拉取请求指南 中。
我们目前正在新代码贡献上强制执行pep8的一个子集。
分支和拉取请求#
目前没有内容。
摘要#
matplotlib 代码库早于 PEP8,因此在某些方面风格上不够一致。使代码库符合 PEP8 将大大提高其可读性。
详细描述#
一些文件使用四个空格缩进,一些使用三个。有些在同一个文件中使用不同的缩进级别。
大多数情况下,类/函数/变量命名遵循 PEP8 规范,但在必要时进行修正也无妨。
实现#
实现应该是相当机械化的:在代码上运行 pep8 工具,并在适当的地方进行修复。
这应该在2.0版本发布后合并,因为这些更改可能会使合并任何待处理的拉取请求变得更加困难。
此外,可选地,可以通过自动化构建系统跟踪PEP8合规性。
向后兼容性#
需要更改的类和函数的公共名称(这些应该不多)应首先被弃用,然后在下一个发布周期中移除。
替代方案#
PEP8 是 Python 代码风格的一个流行标准,得到了 Python 核心开发者的认可,使得任何替代方案都不那么理想。