资讯专栏INFORMATION COLUMN

使用python写vim插件

woshicixide / 1668人阅读

摘要:原文地址有各种强大的插件,这不仅归功于其提供的用来编写插件的脚本语言,还得益于它良好的接口实现,从而支持等语言编写插件。当编译时带有特性时就能使用编写插件,则支持,可以使用来查看的编译特性。具体可以查看帮助参考如何用写插件

原文地址

vim有各种强大的插件,这不仅归功于其提供的用来编写插件的脚本语言vimL,还得益于它良好的接口实现,从而支持python等语言编写插件。当vim编译时带有+python特性时就能使用python2.x编写插件,+python3则支持python3.x,可以使用vim --version来查看vim的编译特性。

要使用python接口,可以用:h python来查看vim提供的帮助文档,本文做一个简单的介绍。我们都知道在vim里可以执行bash命令,只需要:!command即可,那么vim里可以执行python语句吗?当然可以了,vim那么强大!不是吗,是吗?!

vim中执行python命令

在vim中可以使用py[thon] {stmt}来执行python语句{stmt},你可以用:python print "Hello World!"来验证一下。

只能执行一条语句,没什么用,不是吗?所以有更加强大的接口,语法如下:

py[thon] << {endmarker}
{script}
{endmarker}

这样我们就可以执行python脚本{script}中的内容了。{endmarker}是一个标记符号,可以是任何内容,不过{endmarker}后面不能有任何的空白字符。看一个简单的例子,假设下面代码保存为script_demo.vim:

function! Foo()
python << EOF
class Foo_demo:
    def __init__(self):
        print "Foo_demo init"
Foo_demo()
EOF
endfunction

那么在vim中我们先用:source path_to_script/script_demo.vim来加载脚本,然后就可以用:call Foo()来运行python脚本了,整个过程如图所示:

此外,我们还可以将python脚本放到一个多带带的.py文件中,然后用pyf[ile] {file}来运行python文件中的程序,要注意这里pyf[ile]后面的所有参数被看做是一个文件的名字。

vim模块

我们已经可以在vim中执行python命令了,但是python怎么获取vim中的一些信息呢?比如说我想知道vim当前缓冲区一共有多少行内容,然后获取最后一行的内容,用python该怎么做呢?

于是vim提供了一个python模块,有趣的是模块名字就叫做vim,我们可以用它来获取vim编辑器里面的所有信息。上面问题用以下python脚本就可以解决了:

function! Bar()
python << EOF
import vim
cur_buf = vim.current.buffer
print "Lines: {0}".format(len(cur_buf))
print "Contents: {0}".format(cur_buf[-1])
EOF
endfunction

你可以自己加载脚本运行一下见证奇迹!上面代码出现了vim.current.buffer,想必你已经从名字猜到了它的意思了,不过还是来详细看下吧:

vim模块中的常量

vim.buffers: 用来访问vim中缓冲区的列表对象,可以进行如下操作:

    :py b = vim.buffers[i]      # Indexing (read-only)
    :py b in vim.buffers      # Membership test
    :py n = len(vim.buffers)  # Number of elements
    :py for b in vim.buffers: # Iterating over buffer list

vim.windows: 用来访问vim中窗口的列表对象,和vim.buffers支持的操作基本相。

vim.current: 用来访问vim中当前位置的各种信息,比如:

vim.current.line
vim.current.buffer
vim.current.window
vim.current.tabpage
vim.current.range

vim.vvars: 类似字典的对象,用来存储global(g:)变量或者vim(v:)变量。

还有其他的一些常量,这里不做叙述。注意这里的常量并不是真正意义上的常量,你可以重新给他们赋值。但是我们应该避免这样做,因为这样会丢失该常量引用的值。现在为止我们已经能获取vim中数据,然后用python来对其进行操作,似乎完美了。

不过vim并没有止步于此,它可是Stronger than Stronger!因为我们可以在python里使用vim强大的命令集,这样就可以用python写一些常用的批处理插件,看下面简单的例子:

function! Del(number)
python << EOF
import vim
num = vim.eval("a:number")
vim.command("normal gg{0}dd".format(num))
vim.command("w")
EOF
endfunction

可以调用上面函数Del(n)用来删除当前缓冲区前n行的内容(只是示例而已,现实中别这么做!)上面用到了eval和command函数,如下:

vim模块中两个主要的方法

vim.command(str): 执行vim中的命令str(ex-mode,命令模式下的命令),返回值为None,比如:

    :py vim.command("%s/aaa/bbb/g")

也可以用`vim.command("normal "+str)`来执行normal模式下的命令,比如说用以下命令删除当前行的内容:

    :py vim.command("normal "+"dd")
    

vim.eval(str): 用vim内部的解释器来计算str中的内容,返回值可以是字符串、字典、或者列表,比如计算12+12的值:

    :py print vim.eval("12+12")

将返回结算结果24。

前面的Del函数还提供了一个number参数,在vimL里面可以通过let arg=a:number来使用,在python中通过vim.eval("a:number")来使用。也可以通过参数位置来访问,比如let arg=a:0或者是vim.eval("a:0")。我们可以使用"..."来代替命名参数来定义一个能接收任意数量参数的函数,不过这样只能通过位置来访问。

vim模块还提供了一个异常处理对象vim.error,使用vim模块时一旦出现错误,将会触发一个vim.error异常,简单的例子如下:

try:
    vim.command("put a")
except vim.error:
    # nothing in register a
vim模块提供的对象

到这里你基本能用python来对缓冲区进行基本的操作,比如删除行或者是在指定行添加内容等。不过在缓冲区添加内容会很不pythoner,因为你得使用command来调用vim的i/I/a/A命令。好在有更科学的方式,那就是利用vim模块提供的对象来进行操作,看下面简单的例子:

function! Append()
python << EOF
import vim
cur_buf = vim.current.buffer
lens = len(cur_buf)
cur_buf.append("" Demo", lens)
EOF
endfunction

Append函数在当前缓冲区的结尾添加注释内容" Demo,缓冲区对象是怎么一会儿事呢?

缓冲区对象

vim模块提供了缓冲区对象来让我们对缓冲区进行操作,该对象有两个只读属性name和number,name为当前缓冲区文件的名称(包含绝对路径),number为缓冲区的数量。还有一个bool属性valid,用来标识相关缓冲区是否被擦除。

缓冲区对象有以下几种方法:

b.append(str): 在当前行的下面插入新的行,内容为str;

b.append(str, n): 在第n行的下面插入新的行,内容为str;

b.append(list)

b.append(list, n): 插入多行到缓冲区中;

b.range(s,e): 返回一个range对象表示缓冲区中s到e行的内容。

注意使用append添加新行str时,str中一定不能包含换行符" "。str结尾可以有" ",但会被忽略掉。

缓冲区对象的range方法会返回一个range对象来代表部分的缓冲区内容,那么range对象又有那些属性以及方法呢? 其实在操作上range对象和缓冲区对象基本相同,除了range对象的操作均是在指定的区域上。range对象有两个属性start和end,分别是range对象的起始和结尾行。它的方法有r.append(str),r.append(str, n)和r.append(list),r.append(list, n)。

我们可以通过vim.windows来获取vim中的窗口对象,我们只能通过窗口对象的属性来对其进行操作,因为它没有提供方法或者其他接口来操作。其中只读属性有buffer、number、tabpage等,读写属性有cursor、height、width、valid等。具体可以查看帮助:h python-window

参考
Scripting Vim with Python
如何用python写vim插件

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/24796.html

相关文章

  • 使用pythonvim插件

    摘要:原文地址有各种强大的插件,这不仅归功于其提供的用来编写插件的脚本语言,还得益于它良好的接口实现,从而支持等语言编写插件。当编译时带有特性时就能使用编写插件,则支持,可以使用来查看的编译特性。具体可以查看帮助参考如何用写插件 原文地址 vim有各种强大的插件,这不仅归功于其提供的用来编写插件的脚本语言vimL,还得益于它良好的接口实现,从而支持python等语言编写插件。当vim编译时带...

    antz 评论0 收藏0
  • Vim插件简单介绍

    摘要:转换时支持模板文件,配合强大的模板文件,可以自己创建,或者是实现语法高亮,还支持数学公式编辑。标签文件允许这些项目能够被一个文本编辑器或其它工具简捷迅速的定位。 原文地址 Vim作为一个强大的编辑器,再配合强大的插件,就可以称得上为编辑神器了。 pathogen pathogen为管理插件的插件,类似的还有vundle。在 Pathogen 之前,安装插件就是把插件文件放在.vim目录...

    dackel 评论0 收藏0
  • 你也用VimJava代码?

    摘要:献给所有曾试图写而痛苦挣扎的请不要害怕我也是你们的一员序文章源起于论坛中的一个问题由于回答的有点尽性便转为文章题主应该是个初学者这里不对题主报有任何贬义的情感谁都是从初学过来的问题主要是如何在中编译运行代码勾起了我痛苦的回忆便借题发挥了更何 献给所有曾试图写Java而痛苦挣扎的Vimers, 请不要害怕, 我也是你们的一员 序 文章源起于segmentfault论坛中的一个问题, 由于...

    helloworldcoding 评论0 收藏0
  • 你也用VimJava代码?

    摘要:献给所有曾试图写而痛苦挣扎的请不要害怕我也是你们的一员序文章源起于论坛中的一个问题由于回答的有点尽性便转为文章题主应该是个初学者这里不对题主报有任何贬义的情感谁都是从初学过来的问题主要是如何在中编译运行代码勾起了我痛苦的回忆便借题发挥了更何 献给所有曾试图写Java而痛苦挣扎的Vimers, 请不要害怕, 我也是你们的一员 序 文章源起于segmentfault论坛中的一个问题, 由于...

    KitorinZero 评论0 收藏0
  • VIM 代码片段插件 ultisnips 使用教程

    摘要:博客原文同步安装插件安装分两部分,一个是插件本身,另外一个是代码片段仓库。一般来说把默认的代码片段仓库下载下来按需修改后上传到自己的即可。这时需要使用参数选项使用正则代码片段通常写代码的时候需要使用等来打印上下文中的变量。 博客原文同步 安装 Ultisnips 插件安装分两部分,一个是 ultisnips 插件本身,另外一个是代码片段仓库。一般来说把默认的代码片段仓库下载下来按需修改...

    jsummer 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<