---

Ⅰ. 插件描述

Vim operators to execute text objects

Ⅱ. 基本信息

创建日期：  2017-12-10 使用用户：  2 Github星：  17 插件作者：  gokcehan

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'gokcehan/vim-opex'

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

:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'gokcehan/vim-opex'

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

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'gokcehan/vim-opex'

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

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/gokcehan/vim-opex

Ⅳ. 文档说明

# vim-opex

Opex is a simple plugin that defines two custom operators to execute text objects (:h motion.txt).
First execution operator executes the code and displays any output in messages (:h message.txt).
Second appending operator executes the code and appends any output as a comment below the text object.

Languages

Following languages are supported with their corresponding interfaces:

• lua (:h if_lua.txt)
• perl (:h if_perl.txt)
• python (:h if_pyth.txt)
• ruby (:h if_ruby.txt)
• scheme (:h if_mzsch.txt)
• tcl (:h if_tcl.txt)
• sh (:h system())
• vim (:h execute())

Opex is automatically loaded if you have the required feature enabled in vim (e.g. +lua for lua files).
If you have installed vim from a repository, you are likely missing most of these features.
Therefore, you may need to compile vim from source with corresponding features enabled at compile time.

Installation

Drop autoload/opex.vim to ~/.vim/autoload and any of the files under ftplugin to ~/.vim/ftplugin.

If you are using vim8 you can simply clone this repository as such (:h packages):

mkdir -p ~/.vim/pack/plugins/start
cd ~/.vim/pack/plugins/start
git clone https://github.com/gokcehan/vim-opex.git

If you are using another plugin manager you should know what to do.

Configuration

You can configure mappings for execution (default gx) and appending (default gz) as below:

nmap ge  <plug>(opex-execute)
vmap ge  <plug>(opex-execute)
nmap gee <plug>(opex-execute-line)

nmap ga  <plug>(opex-append)
vmap ga  <plug>(opex-append)
nmap gaa <plug>(opex-append-line)

If you want to disable opex for a specific filetype you can use the following:

let b:loaded_opex_lua = 1

You can change the value of commentstring option to configure output style:

autocmd Filetype lua setlocal commentstring=--[[%s]]

Known Issues

• Any limitation on the builtin interpreter also applies to opex (e.g. gui, threading).
• If you accidentally execute an infinite loop, you may need to manually kill the vim process.
• If you crash the interpreter somehow, plugins that use the same interface may stop working until you restart vim.

License

Public domain.