---

Ⅰ. 插件描述

"which" and "exec" functions targeted at local node project bin, with "which" fallback

Ⅱ. 基本信息

创建日期：  2016-04-14 使用用户：  24 Github星：  31 插件作者：  jaawerth

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'jaawerth/nrun-vim'

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

:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'jaawerth/nrun-vim'

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

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'jaawerth/nrun-vim'

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

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/jaawerth/nrun.vim

Ⅳ. 文档说明

# nrun.vim
Vim-native "which" and "exec" functions targeted at local node project bin, falling back to which, for easy vim integration with dev-depenendencies in node-based build processes.

Install

Place autoload/nrun.vim in your autoload directory, or add to your config with plugin tool of your choice (Plug 'jaawerth/nrun.vim' with vim-plug, Plugin 'jaawerth/nrun.vim' with Vundle, etc)

Usage Examples

With vim + Syntastic

In your ~/.vimrc or in a javascript ftplugin

au BufEnter *.js let b:syntastic_javascript_eslint_exec = nrun#Which('eslint')

With neovim + Neomake

This is my favorite setup. In your ~/<nvim-config>/init.vim or ~/<nvim-config>/ftplugin/javascript.vim:

" you can set your enabled makers globally (like below) or on the buffer level as part of an autocmd - see Neomake docs for details
let g:neomake_javascript_enabled_makers = ['eslint']
" when switching/opening a JS buffer, set neomake's eslint path, and enable it as a maker
au BufEnter *.js let b:neomake_javascript_eslint_exe = nrun#Which('eslint')

For more on Neomake config, see their docs - I like to combine the above with:

au BufWinEnter,BufWritePost *.js,*.jsx,*.whateverelse Neomake

or simply

au BufWinEnter,BufWritePost * Neomake

Functions

nrun#Which('command')

A "which" that first tries to see if you're in a node project (traversing the current directly up looking for package.json and node_modules/.bin/<command>), falling back to "which" if root or home folders are hit without a match.

nrun#Exec('command')

Executes the above and passes the results to system() for you. Throws if no command found.

nrun#StrTrim(string)

Trim the whitespace around a string (used internally to account for the newline from which)

Configuration

Single function call

To change the fallback command, pass it in as the second argument. For example, on Windows shell you may want to use where: nrun#Which('tape', 'where')

To disable fallback so it only looks within the local project, pass in 0 as the second argumetN: nrun#Which('tape', 0)

Global

g:nrun_which_cmd can be set to globally set a fallback, and let g:nrun_disable_which = 1 will disable it unless overriden by the function call.

What's the point?

Eases the pain of integrating vim into your JavaScript/node build tools.

Many of the development and build processes inherent to node require the use of locally-installed executables for linting, testing, building, etc. While npm scripts often work well for this, it can be inconvenient to set an npm script for every runnable dependency. There's npm bin to find your local bin directory, but it's noticeably slow, and can bog down vim plugins.

For a time I used a bash script, or the node-based npm-which, but preferred a self-contained vimscript implementation with no global dependencies (which aside).