编程指引¶
以下条目由OpenERP质量团队维护并且作为质量审查的一部分。 包含了OpenERP的推荐的/不推荐的实现方式,以及通用的Python编程建议。
这两部分是每一个OpenERP的开发、贡献者都必须阅读的。
请谨记以下几点普遍的规则:
你写的每一行代码将会被别人(包括你自己)读很多次
相信大家都知道以上的风险,意味着你在按照其他指引的时候, 必须依靠自己准确的判断以实现最好的代码可读性。 为写出可读性高的代码而努力是非常值得的。
- 1 Python代码风格指南
- 1.1 魔术方法
- 1.2 .clone()
- 1.3 “clone 和 update”
- 1.4 “手动 update”
- 1.5 Java 的字典创建方式
- 1.6 “临时的 kwargs”
- 1.7 (正式和非正式)过时的方法
- 1.8 没必要的中间变量
- 1.9 让冗余代码三振出局
- 1.10 简单的多个返回点是可以接受的
- 1.11 尽量避免类型测试
- 1.12 除非你知道要的是什么类型,否则不要使用
type
- 1.13 如果真的想用,那就用python提供的类型测试
- 1.14 不要只是为了调用函数而创造新函数
- 1.15 了解内建函数
- 1.16 学习列表推导式
- 1.17 学习你的标准库
- 1.18 Collections 也是布尔类型
- 1.19 你可以把一个对象添加到列表中
- 1.20 列表相加
- 1.21 学习你的标准库 (2)
- 1.22 遍历可迭代对象
- 1.23 链接调用是可以的,只要你不要滥用
- 1.24 使用 dict.setdefault
- 1.25 使用默认值,远离“神奇数字”
- 2 OpenERP 特别指引
- 3 YAML 自动测试指南