python - 来自文档字符串的 Python 函数参数签名

Question

是否有从文档字符串中提取函数 args 签名的解决方案？

首先，解析器应该寻找注解，如果没有注解则回退到文档字符串。我发现了一个专门针对 numpy docstring 的类似问题。我想要一个适用于任何文档字符串格式的通用解决方案。如果你知道如何用绝地做到这一点，请告诉我。

我也知道typed_ast。但是，它再次针对文档字符串的特定格式（而不是注释行）量身定制。

例子。

def my_func(arg1):
    """
    Parameters
    ----------
    arg1: str
    """
    return arg1 + "1"

解析的结果应该是 smth like {'arg1': str}。