davidsu/deoplete.nvim

:stars: Dark powered asynchronous completion framework for neovim

deoplete.nvim

Deoplete is the abbreviation of "dark powered neo-completion". It provides an asynchronous keyword completion system in the current buffer. To view the current options, please consult the documentation.

Installation

Note: deoplete requires Neovim(latest is recommended) with Python3 and timers(neovim ver.0.1.5+) enabled. See requirements if you aren't sure whether you have this.

1. Extract the files and put them in your Neovim directory (usually $XDG_CONFIG_HOME/nvim/).
2. Execute the :UpdateRemotePlugins and restart Neovim.
3. Write call deoplete#enable() or let g:deoplete#enable_at_startup = 1 in your init.vim

For vim-plug

Plug 'Shougo/deoplete.nvim', { 'do': ':UpdateRemotePlugins' }

For dein.vim

call dein#add('Shougo/deoplete.nvim')

Requirements

deoplete requires Neovim with if_python3. If :echo has("python3") returns 1, then you're done; otherwise, see below.

You can enable Python3 interface with pip:

pip3 install neovim

Sources

deoplete will display completions via omnifunc by default.

Here are some completion sources specifically made for deoplete.nvim.

Note: deoplete needs neovim-python ver.0.1.8+.

You need update neovim-python module.

pip3 install --upgrade neovim

If you want to read the Neovim-python/python3 interface install documentation, you should read :help provider-python and the Wiki. https://github.com/zchee/deoplete-jedi/wiki/Setting-up-Python-for-Neovim

Note: Python3 must be enabled before updating remote plugins

If Deoplete was installed prior to Python support being added to Neovim, :UpdateRemotePlugins should be executed manually in order to enable auto-completion.

Screenshots

Deoplete for JavaScript https://www.youtube.com/watch?v=oanoPTpiSF4

Python completion using deoplete-jedi

C++ completion using clang_complete

Java completion using vim-javacomplete2

Vim Script completion using neco-vim

Configuration Examples

" Use deoplete.
let g:deoplete#enable_at_startup = 1