一、增加Docmentation String
- 这是只是一个惯例,不是强制标准,不能要求程序员一定为函数提供说明文档
- 加入函数定义更新了,文档未必同步更新
例子如下:
def multiply(x,y):
"""
:param x:int
:param y:int
:return:int
"""
return x*y
print(help(multiply))
二、增加类型标注
- python3.5开始引入
- 对函数的参数进行类型标注
- 对函数的返回值进行类型标注
- 只对函数参数做一个辅助说明,并不对函数参数进行类型检查
- 提供给第三方工具,做代码分析,发现隐形bug
- 函数注解的信息,保存在__annotations__属性中
- python3.6中引入变量注解
- 例子 i:str = 'type'
def multiply(x:int,y:int)->int:
"""
:param x:int
:param y:int
:return:int
"""
return x*y
print(help(multiply))
print(multiply(6,7))
print(multiply("honey","bee"))