在def行中添加返回类型？

Question

我刚刚看到了

def foo(x) -> 'int':
    return x*2

print(foo(3))  # >>> 6

，它实际上是可执行的。但是，即使我写了，它甚至可以允许：

def foo(x) -> 'str':
    return x*2

print(foo(3)) # >>> 6

这是我没有听说过的Python新功能吗？要声明返回类型，例如Java？但这并没有强制执行。

但是，在python中，有一些标准方法可以在python中完成相同的工作，例如，集成pycharm的google样式：

def foo(x):
    """

    Args:
        x: non-negative integer

    Returns: square of x

    """
    return x**2

或javadoc样式：

"""
This is a javadoc style.

@param param1: this is a first param
@param param2: this is a second param
@return: this is a description of what is returned
@raise keyError: raises an exception
"""

从现在开始，我们如何管理它的使用？

请参阅从官方文档中可以看到此内容的地方。