python - 是否有一种标准方法可以在文档字符串中指定回调函数的类型？

Question

我有一个接受回调的函数。是否有标准方法来记录此参数的类型？

def example(callback):
    """Example function.

    Parameters
    ----------
    callback : type
       Description of `callback`.
    """
    print(callback(3, 14))

Answer 1

在制定问题时找到了答案，但问题本身在 Google 上没有给出任何结果。

PEP-0484在 python 中引入类型注释。例如，接受两个整数并返回一个字符串的回调函数的类型是:

from typing import Callable

Callable[[int, int], str]