何も返されない場合のdocstrings

Question

関数が何も返さない場合のdocstring規約は何ですか？

例えば：

def f(x):
    """Prints the element given as input

    Args:
        x: any element
    Returns:
    """
    print "your input is %s" % x
    return

DocstringのReturns:の後に何を追加すればよいですか？今のように何もない？

Answer 1

関数が実際に返すのはNoneです。

"""Prints the element given as input

Args:
    x: any element
Returns:
    None
"""

Python return somethingのすべての関数。値を明示的に返さない場合、関数はデフォルトでNoneを返します：

>>> def func():
...     return
...
>>> print func()
None
>>>