本文是向 Melange 项目贡献 Python 代码的编码风格指南。
SoC framework项目以及在此之上构建的Melange web applications都是用 Python 语言实现的(因为 Python 是Google App Engine目前支持的唯一一种编程语言)。本编码风格指南是向 Melange 项目贡献 Python 代码的“要做”和“不要做”的列表。
下面这些规则不是原则或建议,而是严格的规定。你不能不理会这些规定除非是确实需要使用并被允许了,但仍然要注意本指南结尾处一致性部分的建议。
如果你有关于这些准则的问题,可以向开发者邮件列表发邮件询问。请在邮件标题写上“Python style:”,以便在邮件列表归档中更容易定位这些讨论。
本编码风格指南写在 Melange 项目的 Wiki 上,可以遵循已有的文档复查流程?进行修改。但不应该轻易修改本文,因为一致性是本指南的一个关键目标,而且不能因为新的风格指南变化而需要更新旧代码。
https://www.open-open.com/lib/view/open1420789115343.html