使用当前参数列表生成python docstring模板

Question

我有一个即将发布的python软件包，所以现在我开始使用vim将文档字符串缓慢添加到文件中。所以对于像

def foo(x, y, z=None, **kwargs):

我必须一整天重复手动输入以下内容

""" foo does this stuff.

Parameters
----------
x: 
y:
z: optional
kwargs:

Returns
-------

"""

有没有一种方法可以通过定义一些vim宏来动态生成此模板文档字符串（我对此一无所知，因此有关如何启动的建议也很好）。谢谢。

Answer 1

的作者vim-pydocstring已经将与Numpy样式的docstrings的兼容性添加到了程序包中，这似乎是对该问题的最佳答案。

您可以从这里拉/下载vim插件