---

Ⅰ. 插件描述

python client and plugin host for Nvim

Ⅱ. 基本信息

创建日期：  2014-05-07 使用用户：  4 Github星：  697 插件作者：  Neovim

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'neovim/pynvim'

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

:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'neovim/pynvim'

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

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'neovim/pynvim'

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

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/neovim/pynvim

Ⅳ. 文档说明

Pynvim: Python client to Neovim

Pynvim implements support for python plugins in Nvim. It also works as a library for
connecting to and scripting Nvim processes through its msgpack-rpc API.

Install

Supports python 2.7, and 3.4 or later.

pip2 install pynvim
pip3 install pynvim

If you only use one of python2 or python3, it is enough to install that

1. You can install the package without being root by adding the --user
   flag.

Anytime you upgrade Neovim, make sure to upgrade pynvim as well:

pip2 install --upgrade pynvim
pip3 install --upgrade pynvim

Alternatively, the master version could be installed by executing the following
in the root of this repository:

pip2 install .
pip3 install .

Python Plugin API

Pynvim supports python remote plugins (via the language-agnostic Nvim rplugin
interface), as well as Vim plugins (via the :python[3] interface). Thus when
pynvim is installed Neovim will report support for the +python[3] Vim feature.

The rplugin interface allows plugins to handle vimL function calls as well as
defining commands and autocommands, and such plugins can operate asynchronously
without blocking nvim. For details on the new rplugin interface,
see the Remote Plugin documentation.

Pynvim defines some extensions over the vim python API:

• Builtin and plugin vimL functions are available as nvim.funcs
• API functions are available as vim.api and for objects such as buffer.api
• Lua functions can be defined using vim.exec_lua and called with vim.lua
• Support for thread-safety and async requests.

See the Python Plugin API documentation for usage of this new functionality.

Development

Use (and activate) a local virtualenv.

python3 -m venv env36
source env36/bin/activate

If you change the code, you must reinstall for the changes to take effect:

pip install .

Use pytest to run the tests. Invoking with python -m prepends the current
directory to sys.path (otherwise pytest might find other versions!):

python -m pytest

For details about testing and troubleshooting, see the
development
documentation.

Usage from the Python REPL

A number of different transports are supported, but the simplest way to get
started is with the python REPL. First, start Nvim with a known address (or use
the $NVIM_LISTEN_ADDRESS of a running instance):

$ NVIM_LISTEN_ADDRESS=/tmp/nvim nvim

In another terminal, connect a python REPL to Nvim (note that the API is similar
to the one exposed by the [python-vim
bridge](http://vimdoc.sourceforge.net/htmldoc/if_pyth.html#python-vim)):

>>> from pynvim import attach
# Create a python API session attached to unix domain socket created above:
>>> nvim = attach('socket', path='/tmp/nvim')
# Now do some work. 
>>> buffer = nvim.current.buffer # Get the current buffer
>>> buffer[0] = 'replace first line'
>>> buffer[:] = ['replace whole buffer']
>>> nvim.command('vsplit')
>>> nvim.windows[1].width = 10
>>> nvim.vars['global_var'] = [1, 2, 3]
>>> nvim.eval('g:global_var')
[1, 2, 3]

You can embed Neovim into your python application instead of connecting to
a running Neovim instance.

>>> from pynvim import attach
>>> nvim = attach('child', argv=["/bin/env", "nvim", "--embed", "--headless"])

• The --headless argument tells nvim not to wait for a UI to connect.
• Alternatively, use --embed without --headless if your client is a UI
  and you want nvim to wait for your client to nvim_ui_attach before

continuing startup.

See the tests for more examples.

Release

1. Create a release commit with title Pynvim x.y.z

   • list significant changes in the commit message
   • bump the version in pynvim/util.py and setup.py (3 places in total)
2. Make a release on GitHub with the same commit/version tag and copy the message.
3. Run scripts/disable_log_statements.sh

4. Run python setup.py sdist

   • diff the release tarball dist/pynvim-x.y.z.tar.gz against the previous one.

5. Run twine upload -r pypi dist/pynvim-x.y.z.tar.gz

   • Assumes you have a pypi account with permissions.
6. Run scripts/enable_log_statements.sh or git reset --hard to restore the working dir.