Python：如何使用epytext记录返回多个值时的返回值？

Question

一个简单的功能：

def foo():
    a = 1
    b = 2
    return a, b

你如何使用epytext风格记录（多个）返回值？

作为单个元组？

def foo():
    """
    This function
    @return (a, b): a tuple of a and b representing...
    """
    a = 1
    b = 2
    return a, b

或者为每个变量分别使用@return标签？ （它甚至是“合法的”吗？）

def foo():
    """
    This function
    @return a: a int representing...
    @return b: a int representing...
    """
    a = 1
    b = 2
    return a, b

Answer 1

在Python中，一个元组文字由逗号创建，而不是parens（除了空元组文字()，这是一个特例），所以return a, b首先创建一个tuple然后返回它。 IOW，你不是“返回多个值”而只是一个tuple对象，所以答案是显而易见的。