在 numpydoc 中记录鸭子类型的参数

Question

根据guide to numpy/scipy documentation 中的约定，函数参数应按以下方式记录：

def foo(x):
    """" This function does nothing

    Parameters
    ----------
    x : type
       Description of parameter `x`.
    """"
    pass

如果 type 是一个独特的类型，例如 int 或 str，这很简单。

现在我希望参数是 BaseClass 的实例或任何公开相同接口的对象（例如从 BaseClass 派生的类）。是否有一个约定如何简明扼要地记录参数 x 应该公开某个接口（通过派生或鸭子类型）？

Answer 1

您描述的方法几乎是标准方法。

另一种方法是使用抽象基类来定义必须实现的特定方法，然后将其指定为an answer to a related question 建议的类型。