---

Ⅰ. 插件描述

Testing neovim live updates

Ⅱ. 基本信息

创建日期：  2016-10-29 使用用户：  1 Github星：  2 插件作者：  Peter

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'phodge/vim-hiword'

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

:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'phodge/vim-hiword'

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

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'phodge/vim-hiword'

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

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/phodge/vim-hiword

Ⅳ. 文档说明

Hiword

This is an experimental plugin to test the liveupdate feature of neovim.

Setup

Install with your preferred plugin manager, and then drop something like this in your .vimrc:

fun! <SID>Hiwords()
  if exists(':Hiword')
    syntax off
    Hiword Conditional if
    Hiword Conditional else
    Hiword Conditional elseif
    Hiword Statement elseif
    " and so on
  endif
endfun
" run Hiword commands when vim has finished loading the plugin
au! VimEnter * call <SID>Hiwords()
" run Hiword commands right now if they are ready (for example when the
" user sources this file)
call <SID>Hiwords()

Each Hiword command spawns a new python process using jobstart(). Each
python process will monitor the contents of every buffer using the live update
feature and highlighting for a single word. E.g., if you call Hiword with 20
different words then 20 python processes will be spawned, all of them watching
every single buffer for updates.

!!!FIXME!!!

So this tool has a pretty obvious race condition where it can receive a
LiveUpdate notification, spend some time working out the new highlights for the
line that needs changing, and then by the time it sends API calls to neovim
specifying which lines to modify hl for, the user has already added a new line
above the one that was originally changed meaning the line numbers in the API
call are all wrong. :-(

The solution is to write out the main loop logic like this:

def mainloop():
    pending_highlights = []
    while pending_highlights or nvim.wait_for_message():
        while nvim.have_messages():
            # process any LiveUpdate messages coming in from neovim
            pending_highlights += handle_notifications()
        # lock nvim so the user can't make any buffer changes
        with nvim.lock_buffer(bufnr):
            if not nvim.have_messages():
                # send the HL updates to neovim now
                send_highlights(pending_highlights)
                pending_highlights = []