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