代码风格
在为vn.py写代码的时候,需要遵循一些基本的规则,否则你的代码可能无法被merge。 这些规则包括:
命名规则
我们的代码的命名规则如下:
类属性、类方法、参数和变量使用小写加下划线的形式
类名使用驼峰式命名
常量使用大写加下划线的形式
例如:
DEFAULT_PATH = "/tmp/vn.py/"
class ClassA:
def __init__(self, arg_one: int, arg_two: str):
if arg_two is None:
arg_two = DEFAULT_PATH
self.property_one = arg_one
variable_one = "some string"
代码格式
我们对代码格式没有特别严格的要求,但是至少要符合pep8标准,并且额外要在类和所有函数下面带上docstring(就是一段””””””)。
要让代码符合pep8标准,写完代码之后使用autopep8格式化你的代码就可以了:
autopep8 --in-place --recursive .
代码质量检查
使用flake8检查你的代码,确保没有error和warning。 在项目根目录下运行flake8
就可以检查出代码中书写不严谨的地方了。如果检查出error或者warning,说明你的代码需要进行一些修改以提升质量。