Python 函数注释
Python 函数注释
-
- 1. Google 风格
- 2. python 3.5 引入的类型提示
- 3. Reference
1. Google 风格
代码中常用的注释风格，也是我比较喜欢使用的。具体形式如下：
def test(param1, param2)
"""
This is a groups style docs.
Parameters:
param1 - this is the first param
param2 - this is a second param
Returns:
This is a description of what is returned
Raises:
KeyError - raises an exception
"""
return param1 + param2
可以看到上述的包括了函数及其各个参数的具体用途，甚至包括了异常的类型。当然，我们也可进一步指定参数和返回值的类型。整个注释非常的清晰明了。
2. python 3.5 引入的类型提示
这种方法有点类似Java的函数定义，可以使用冒号与箭头来指定参数与返回值的类型。具体形式如下
def test(a:int, b:str) -> str:
print(a, b)
return 1000
if __name__ == '__main__':
test('test', 'abc')
注解 Python 运行时不强制执行函数和变量类型注解，但这些注解可用于类型检查器、IDE、静态检查器等第三方工具。这种注释方式在阅读代码时是非常方便的，而且注释也是相当灵活的。也是最近阅读别人代码时发现的，后面先试用一段时间再说
3. Reference
- https://blog.csdn.net/sunt2018/article/details/83022493
- https://www.pythonf.cn/read/135762
- https://docs.python.org/zh-cn/3/library/typing.html