---

Ⅰ. 插件描述

Run ruby test in vim

Ⅱ. 基本信息

创建日期：  2009-04-18 使用用户：  41 Github星：  71 插件作者：  jan

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'janx/rubytest-vim'

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

:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'janx/rubytest-vim'

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

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'janx/rubytest-vim'

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

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/janx/vim-rubytest

Ⅳ. 文档说明

Rubytest.vim

Rubytest.vim is a vim (http://www.vim.org) plugin, which helps you to run ruby test (including vanilla test, rspec, shoulda etc.) in vim.

Installation

Copy all files to your ~/.vim directory.

Usage

After installation, press <Leader>t will run the test under your cursor if you are editing a ruby test file.

Example:

$ cd <your rails/merb root>
$ vim test/unit/user_test.rb

(move cursor into a test case, press <Leader>t)

(<Leader> is mapping to '' by default in vim)

Be default, the plugin will print output in terminal. You can change this behavior by putting this line in your vimrc file:

let g:rubytest_output = <output>

The following <output> values are supported:

• quickfix - show failed tests in a quickfix window
• vim_terminal - run the tests in a vim terminal (vim version 8.1 or higher)

With this set, test errors will be displayed in quickfix window, and you can jump to the error location quickly by select the error message and hit return (or Ctrl-w return to open it in new window).

You can customize the command which will be used to run the test case by setting these options in your vimrc file:

let g:rubytest_cmd_test = "ruby %p"
let g:rubytest_cmd_testcase = "ruby %p -n '/%c/'"
let g:rubytest_cmd_spec = "spec -f specdoc %p"
let g:rubytest_cmd_example = "spec -f specdoc %p -e '%c'"
let g:rubytest_cmd_feature = "cucumber %p"
let g:rubytest_cmd_story = "cucumber %p -n '%c'"

Using Spork

let g:rubytest_cmd_test = "bundle exec testdrb %p"
let g:rubytest_cmd_testcase = "bundle exec testdrb %p -- -n '/%c/'"

Using Spring

let g:rubytest_cmd_test = "bundle exec spring testunit %p"
let g:rubytest_cmd_testcase = "bundle exec spring testunit %p -n '/%c/'"

Using Zeus

Note that Zeus is not typically run from within the project's bundle context, so bundle exec is omitted from example

let g:rubytest_cmd_test = "zeus test %p"
let g:rubytest_cmd_testcase = "zeus test %p -n '/%c/'"

Placeholders:

• %p: path of test file
• %c: test case name
• %s: only for minitest, replaced by closest suite name (class whose name begin with 'Test'). This can be used to match test case more exactly:

  let g:rubytest_cmd_testcase = "ruby %p -n '%s#%c'"

Default Key Bindings

• <Leader>t: run test case under cursor
• <Leader>T: run all tests in file
• <Leader>l: run the last test, from any buffer

You can change default key bindings:

map <Leader>\ <Plug>RubyTestRun     " change from <Leader>t to <Leader>\
map <Leader>] <Plug>RubyFileRun     " change from <Leader>T to <Leader>]
map <Leader>/ <Plug>RubyTestRunLast " change from <Leader>l to <Leader>/

Tip

• Rubytest.vim works perfectly with vim-localvimrc, which enables you to set different test run command for different projects. Check details at: https://github.com/embear/vim-localvimrc

Contributors

• Bogdan Gusiev
• Yung Hwa Kwon (nowk)
• J. Weir
• Ben Simpson (bsimpson)
• Alexander Belyaev (alexbel)
• Ivan Tkalin (ivalkeen)
• Dejan Simić (dejan)