github php doc.vim,vim 中自动生成 python 函数注释文档 - 基于 Pydocstring

Pydocstring - Python文档字符串的生成器

能够自动生成函数文档注释、类文档注释，包含以下功能。

插入一行文档字符串

插入多行文档字符串

插入评论

这个插件深受 phpdoc.vim和sonictemplate.vim的启发。

原仓库地址：https://github.com/heavenshell/vim-pydocstring

效果图：https://github.com/heavenshell/vim-pydocstring/blob/master/assets/vim-pydocstring.gif

用法

将光标移动到 def 或 class 关键字所在行，按下 ctrl + l 或在命令行输入Pydocstring， 就可以看到文档字符串模板神奇地出现在当前行下方。

设置

Pydocstring 的缩进取决于 softtabstop 值。你需要给 vim 配置这样的语句 set softtabstop=4。

例 .vimrc 中输入

autocmd FileType python setlocal tabstop = 4 shiftwidth = 4 softtabstop = 4 expandtab

关键映射

如果要更改默认键映射，请在.vimrc中设置以下内容。

nmap (pydocstring)

函数文档效果图

生成效果图

指定参数和返回值的类型

相关文档: https://python3-cookbook.readthedocs.io/zh_CN/latest/c07/p03_attach_informatinal_matadata_to_function_arguments.html

指定类型