---

Ⅰ. 插件描述

vim plugin to specify text object targets for python classes and functions

Ⅱ. 基本信息

创建日期：  2011-01-09 使用用户：  4 Github星：  9 插件作者：  Nat Williams

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'natw/vim-pythontextobj'

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

:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'natw/vim-pythontextobj'

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

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'natw/vim-pythontextobj'

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

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/natw/vim-pythontextobj

Ⅳ. 文档说明

This plugin provides custom text objects for selecting python functions or classes.

I don't believe that it depends on any other plugins or other weirdness. I run vim 7.3, but I tested it for about 30 seconds in 7.2 and nothing broke horribly.

Usage

The two new text object targets contained herein are c and f, describing classes and functions respectively.
As you might expect, this gives you the objects ac, ic, af, and if.

Unfortunately what exactly should constitute the "inner" and "outer" portions of a function or class is not entirely clear to me at this time.
So for the moment, the only difference is that the outer objects include any trailing blank lines, while the inner ones do not.
Watch this space for developments in this matter.

Actual usage should be pretty intuitive to anyone familiar with text objects.
With the cursor on any line inside of a function, vaf will visually select the entire function along with whatever blank lines that follow it.
And so on.

Issues

I'm still adjusting my expectations of what inner vs outer objects should do in this case so that behavior might change.
I do know that outer should include decorators, so that's something I still need to do.
I'm not really sure if there's ever a case for working on the actual insides of a function, as in everything but the definition.

Nested functions are a little squirelly at the moment.

But in common, garden-path cases, I think this pretty much works.

Installation

Since this only really applies to python, I put pythontextobj.vim in ~/.vim/ftplugin/python/.
Though, if you wanted to put it in ~/.vim/plugin/, I don't suppose that would actually break anything, and perhaps it might even be useful for some other language.

Credits

A lot of this code was lifted from Alfredo Deza's chapa.
Austin Taylor's indentobj was also informative, but I don't think I stole anything from him.