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

Question

根据numpy/scipy 文档功能参数指南中的约定，应按以下方式记录：

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

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

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

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

Answer 1

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

另一种方法是使用抽象基类来定义必须实现的特定方法，然后将其指定为相关问题的答案所建议的类型。