使用ruby开发vim插件

作为一个Vimmer和Pythoner,之前折腾过用python编写vim插件。现在作为半个Rubist,又开始继续折腾。


在开始编写插件之前,你需要确认 Vim 是否支持 Ruby,通过以下命令来判别:


$ vim –version | grep +ruby

如果输出为空,则表示你当前的vim不支持Ruby,需要重新编译一下,并启用对Ruby的支持。


顺便说下我当前的环境是:



  • vim 7.4

  • ruby 2.1.0


环境检查没有问题那么就开始吧。

在~/.vim/plugin目录下创建一个 demo.vim 文件。


在开头写上以下代码:


if !has(‘ruby’)
echo “Error: Required vim compiled with +ruby”
finish
endif

这段代码就是用 VimL 编写的,它将检查 Vim 是否支持 Ruby。


接下来再判断该插件是否已经加载过了,以免重复加载:


if exists(‘g:loaded_ruby_demo_plugin’)
finish
endif
let g:loaded_ruby_demo_plugin = 1

所有的检查都没有问题,则开始插件的正文了。先定义一个函数。


function! DemoFun1()
ruby<<EOF
buf = VIM::Buffer.current
puts “current buffer name: #{buf.name} number: #{buf.number} length: #{buf.length}”
EOF
endfunction

function与endfunction是vim中用于定义函数的,在”ruby<<EOF”和”EOF”之间部分的是Ruby代码。这个例子是输出当前缓冲区的名字、编号以及总行数。

执行命令:call DemoFun1(),应该就可以看到输出结果了。


然后再举个例子说下函数的参数处理。


function! DemoFun2(arg1)
ruby<< EOF
puts “you input: #{VIM.evaluate(‘a:arg1’)}”
EOF
endfunction

这里定义了一个函数接收一个参数,然后将其输出。使用 VIM.evaluate 将vim的变量转化为Ruby的变量。


为了方便我们再定义两个命令,以简化对这两个函数的调用。


command! -nargs=0 DemoFun1 call DemoFun1()
command! -nargs=1 -rang DemoFun2 call DemoFun2(<f-args>)

要获取完整的代码可以访问: https://gist.github.com/wusuopu/c1182efefa85d4f6839b


接下来再简单说下vim中Ruby的使用。


vim为Ruby提供了一个VIM模块,通过它可以在Ruby中访问vim的接口。同时还提供了两个全局变量:$curwin、$curbuf,它们分别代表了当前窗口对象以及当前缓冲区对象。


VIM模块中有 Buffer 和 Window 两个对象,分别是用来对缓冲区和窗口进行操作的。同时VIM模块还提供了message、set_option、command和evaluate四个函数。


想要查看更多的帮忙信息,可以在vim中执行如下命令:


:help ruby

好了,先写这么多吧,其余的自己去尝试吧。