Pydocstring - Python

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

插入一行文档字符串

插入多行文档字符串

原仓库地址: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

你可能感兴趣的:(Pydocstring - Python)