---

Ⅰ. 插件描述

A plugin to make managing python project easier with Vim.

Ⅱ. 基本信息

创建日期：  2011-08-09 使用用户：  3 Github星：  16 插件作者：  Amit Ranjit

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'amitdev/vimpy-state-of-grace'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'amitdev/vimpy-state-of-grace'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'amitdev/vimpy-state-of-grace'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/amitdev/vimpy

Ⅳ. 文档说明

VimPy

This Vim plugin is to make navigation of Python files easier with Vim. If you have a large python project, navigating to multiple files may not be easy. There are various ways to make it easier like using ctags/ptags, gf over the python path etc. But it does not work well with multiple files with same name, going to a praticular class/function etc.

Features

Currently it provides two functions - Open and Goto.
Open can be used to open any python module in the project by module name, class name or function.
Goto can be used to goto a module name, class name or function based on token in a file.

Usage

Usage is similar to how ctags/ptags work in Vim. Basically there are 2 steps:

1. Create the index file.
   Use :VimpyCreate <project-name> path [exclude-path] to create index. (Alternatively, the vimpy.py script can be invoked using python to create the index file. See 'python vimpy.py' for usage.)

This is a one time operation. The index will be automatically updated if you edit the files using vim, otherwise this can be rerun and only the changed files will be updated.

1. Load the index file in Vim. This can be done using ':VimpyLoad <file-name>' inside Vim. This can automated by adding in the vimrc.
   Now it is ready to use! Following commands (the Keybindings can be changed in vimpy.vim) can be used to navigate to any desired module:

- <leader> om : Open Module. Go to a module with a given name. 
- <leader> oc : Open Class. Go to a class with a given name. 
- <leader> of : Open Function. Go to a funtion with a given name. 
- <leader> gm : Goto Module given by word under cursor (Eg. use this to navigate to a module under an 'import' statement).
- <leader> gc : Goto Class given by word under cursor. 
- <leader> gf : Goto Function given by word under cursor. 

All of them has auto completion support, so you just need to type in few characters and press <tab>.
[<leader> is typically the '' character, but you can change it to anything (One good option is ',')].

TODO

There are lots of things to do. Major ones being:

• Support packages
• Make the goto option more intelligent