能够自动生成函数文档注释、类文档注释,包含以下功能。
插入一行文档字符串
插入多行文档字符串
原仓库地址: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
函数文档效果图
生成效果图
指定参数和返回值的类型
相关文档:https://python3-cookbook.readthedocs.io/zh_CN/latest/c07/p03_attach_informatinal_matadata_to_function_arguments.html