completion-nvim is an auto completion framework that aims to provide a better completion experience with neovim's built-in LSP. Other LSP functionality is not supported.

• Asynchronous completion using the libuv api.
• Automatically open hover windows when popupmenu is available.
• Automatically open signature help if it's available.
• Snippets integration with UltiSnips and Neosnippet.
• Chain completion support inspired by

Demo using sumneko_lua

• Neovim nightly
• You should set up your language server of choice with the help of nvim-lsp

• Install with any plugin manager by using the path on GitHub.

Plug 'haorenW1025/completion-nvim'

• completion-nvim requires several autocommands set up to work properly. You should set it up using the on_attach function like this.

lua require'nvim_lsp'.pyls.setup{on_attach=require'completion'.on_attach}

• Change pyls to whichever language server you're using.
• If you want completion-nvim to be set up for all buffers instead of only being used when lsp is enabled, call the on_attach function directly:

" Use completion-nvim in every buffer
autocmd BufEnter * lua require'completion'.on_attach()

NOTE It's okay to set up completion-nvim without lsp. It will simply use another completion source instead(Ex: snippets).

" Use <Tab> and <S-Tab> to navigate through popup menu
inoremap <expr> <Tab>   pumvisible() ? "\<C-n>" : "\<Tab>"
inoremap <expr> <S-Tab> pumvisible() ? "\<C-p>" : "\<S-Tab>"

" Set completeopt to have a better completion experience
set completeopt=menuone,noinsert,noselect

" Avoid showing message extra message when using completion
set shortmess+=c

• By default auto popup is enabled, turn it off by

let g:completion_enable_auto_popup = 0

• Or you can toggle auto popup on the fly by using command CompletionToggle
• You can manually trigger completion with mapping key by

inoremap <silent><expr> <c-p> completion#trigger_completion() "map <c-p> to manually trigger completion

• Or you want to use <Tab> as trigger keys

function! s:check_back_space() abort
    let col = col('.') - 1
    return !col || getline('.')[col - 1]  =~ '\s'
endfunction

inoremap <silent><expr> <TAB>
  \ pumvisible() ? "\<C-n>" :
  \ <SID>check_back_space() ? "\<TAB>" :
  \ completion#trigger_completion()

• By default other snippets source support are disabled, turn them on by

let g:completion_enable_snippet = 'UltiSnips'

• Support UltiSnips and Neosnippet

• completion-nvim supports chain completion, which use other completion sources and ins-completion as a fallback for lsp completion.

• See for details on how to set this up.

• By default <CR> is used to confirm completion and expand snippets, change it by

let g:completion_confirm_key = "\<C-y>"

• Make sure to use " " and add escape key \ to avoid parsing issues.
• If the confirm key has a fallback mapping, for example when using the auto pairs plugin, it maps to <CR>. Provide it like this:

"Fallback for https://github.com/Raimondi/delimitMate expanding on enter
let g:completion_confirm_key_rhs = "\<Plug>delimitMateCR"

• By default when navigating through completion items, LSP's hover is automatically called and displays in a floating window. Disable it by

let g:completion_enable_auto_hover = 0

• By default signature help opens automatically whenever it's available. Disable it by

let g:completion_enable_auto_signature = 0

• You can set a number limit for the maximum completion items. For example, if you just want at most 10 items in your popup menu, set it by

let g:completion_max_items = 10

NOTE that this only works for non ins-complete completion source.

• By default, completion-nvim respect the trigger character of your language server, if you want more trigger characters, add it by

let g:completion_trigger_character = ['.', '::']

NOTE use :lua print(vim.inspect(vim.lsp.buf_get_clients()[1].server_capabilities.completionProvider.triggerCharacters)) to see the trigger character of your language server.

• If you want different trigger character for different languages, wrap it in an autocommand like

augroup CompleteionTriggerCharacter
    autocmd!
    autocmd BufEnter * let g:completion_trigger_character = ['.']
    autocmd BufEnter *.c,*.cpp let g:completion_trigger_character = ['.', '::']
augroup end

• completion-nvim uses a timer to control the rate of completion. You can adjust the timer rate by

let g:completion_timer_cycle = 200 "default value is 80

• This plugin is in the early stages and might have unexpected issues. Please follow for trouble shooting.
• Feel free to post issues on any unexpected behavior or open a feature request!