MEP8: PEP8#

状态#

已取代

当前的样式指南,包括 pep8 的使用,维护在 我们的拉取请求指南 中。

我们目前正在新代码贡献上强制执行pep8的一个子集。

分支和拉取请求#

目前没有内容。

摘要#

matplotlib 代码库早于 PEP8,因此在某些方面风格上不够一致。使代码库符合 PEP8 将大大提高其可读性。

详细描述#

一些文件使用四个空格缩进,一些使用三个。有些在同一个文件中使用不同的缩进级别。

大多数情况下,类/函数/变量命名遵循 PEP8 规范,但在必要时进行修正也无妨。

实现#

实现应该是相当机械化的:在代码上运行 pep8 工具,并在适当的地方进行修复。

这应该在2.0版本发布后合并,因为这些更改可能会使合并任何待处理的拉取请求变得更加困难。

此外,可选地,可以通过自动化构建系统跟踪PEP8合规性。

向后兼容性#

需要更改的类和函数的公共名称(这些应该不多)应首先被弃用,然后在下一个发布周期中移除。

替代方案#

PEP8 是 Python 代码风格的一个流行标准,得到了 Python 核心开发者的认可,使得任何替代方案都不那么理想。