标签：Python 编码规范

阅读(538)

python中Main的使用规范，即使是一个打算被用作脚本的文件, 也应该是可导入的. 并且简单的导入不应该导致这个脚本的主功能(main functionality)被执行, 这是一种副作用. 主功能应该放在一个main()函数中. 在P...

阅读(423)

python命名规范，module_name, package_name, ClassName, method_name, ExceptionName, function_name, GLOBAL_VAR_NAME, instance_va...

阅读(336)

python访问控制使用规范，在Python中, 对于琐碎又不太重要的访问函数, 你应该直接使用公有变量来取代它们, 这样可以避免额外的函数调用开销. 当添加更多功能时, 你可以用属性(property)来保持语法的一致性. (译者注: 重...

阅读(354)

python语句规范，通常每个语句应该独占一行，不过, 如果测试结果与测试语句在一行放得下, 你也可以将它们放在同一行. 如果是if语句, 只有在没有else时才能这样做. 特别地, 绝不要对 try/except 这样做, 因为try和e...

阅读(330)

python导入格式使用规范，每个导入应该独占一行 Yes: import os import sys No: import os, sys 导入总应该放在文件顶部, 位于模块注释和文档字符串之后, 模块全局变量和常量之前. 导入应该按照从...

阅读(403)

python的TODO注释使用规范，为临时代码使用TODO注释, 它是一种短期解决方案. 不算完美, 但够好了. TODO注释应该在所有开头处包含”TODO”字符串, 紧跟着是用括号括起来的你的名字, email地址...

阅读(356)

python文件和sockets的使用规范，在文件和sockets结束时, 显式的关闭它. 除文件外, sockets或其他类似文件的对象在没有必要的情况下打开, 会有许多副作用, 例如: 它们可能会消耗有限的系统资源, 如文件描述符. 如...

阅读(326)

python字符串的使用规范， Yes: x = a + b x = '%s, %s!' % (imperative, expletive) x = '{}, {}!'.format(imperative, expletive) x = '...

阅读(349)

python类的使用规范，如果一个类不继承自其它类, 就显式的从object继承. 嵌套类也一样. Yes: class SampleClass(object): pass class OuterClass(object): class I...

阅读(500)

python注释的使用规范，确保对模块, 函数, 方法和行内注释使用正确的风格 文档字符串 Python有一种独一无二的的注释方式: 使用文档字符串. 文档字符串是包, 模块, 类或函数里的第一个语句. 这些字符串可以通过对象的__doc_...