YouCompleteMe/autoload/youcompleteme.vim
Strahinja Val Markovic 15561b9f1e Adding 'preview' to completeopt if not forbidden
The user can opt-out of this, but we set it by default since most people don't
know that the option exists. Those that are annoyed by it can just toggle an
option in their vimrc.
2012-08-05 19:55:06 -07:00

286 lines
9.4 KiB
VimL

" Copyright (C) 2011, 2012 Strahinja Val Markovic <val@markovic.io>
"
" This file is part of YouCompleteMe.
"
" YouCompleteMe is free software: you can redistribute it and/or modify
" it under the terms of the GNU General Public License as published by
" the Free Software Foundation, either version 3 of the License, or
" (at your option) any later version.
"
" YouCompleteMe is distributed in the hope that it will be useful,
" but WITHOUT ANY WARRANTY; without even the implied warranty of
" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
" GNU General Public License for more details.
"
" You should have received a copy of the GNU General Public License
" along with YouCompleteMe. If not, see <http://www.gnu.org/licenses/>.
" This is basic vim plugin boilerplate
let s:save_cpo = &cpo
set cpo&vim
" This needs to be called outside of a function
let s:script_folder_path = escape( expand( '<sfile>:p:h' ), '\' )
let s:searched_and_no_results_found = 0
let s:should_use_filetype_completion = 0
let s:completion_start_column = 0
let s:omnifunc_mode = 0
function! youcompleteme#Enable()
" When vim is in diff mode, don't run
if &diff
return
endif
" If the user set the current filetype as a filetype that YCM should ignore,
" then we don't do anything
if get( g:ycm_filetypes_to_ignore, &filetype, 0 )
return
endif
augroup youcompleteme
autocmd!
autocmd CursorMovedI * call s:OnCursorMovedInsertMode()
autocmd CursorMoved * call s:OnCursorMovedNormalMode()
" Note that these events will NOT trigger for the file vim is started with;
" so if you do "vim foo.cc", these events will not trigger when that buffer
" is read. This is because youcompleteme#Enable() is called on VimEnter and
" that happens *after" BufRead/BufEnter has already triggered for the
" initial file.
autocmd BufRead,BufEnter * call s:OnBufferVisit()
autocmd CursorHold,CursorHoldI * call s:OnCursorHold()
autocmd InsertLeave * call s:OnInsertLeave()
augroup END
" We need menuone in completeopt, otherwise when there's only one candidate
" for completion, the menu doesn't show up.
set completeopt-=menu
set completeopt+=menuone
" This is unnecessary with our features. People use this option to insert
" the common prefix of all the matches and then add more differentiating chars
" so that they can select a more specific match. With our features, they
" don't need to insert the prefix; they just type the differentiating chars.
" Also, having this option set breaks the plugin.
set completeopt-=longest
if g:ycm_add_preview_to_completeopt
set completeopt+=preview
endif
if g:ycm_allow_changing_updatetime
set ut=2000
endif
" With this command, when the completion window is visible, the tab key will
" select the next candidate in the window. In vim, this also changes the
" typed-in text to that of the candidate completion.
inoremap <expr><TAB> pumvisible() ? "\<C-n>" : "\<TAB>"
" This selects the previous candidate for ctrl-tab
inoremap <expr><C-TAB> pumvisible() ? "\<C-p>" : "\<TAB>"
py import vim
exe 'python sys.path = sys.path + ["' . s:script_folder_path . '/../python"]'
py import ycm
py ycm_state = ycm.YouCompleteMe()
if g:ycm_filetype_completion_enabled
" <c-x><c-o> trigger omni completion, <c-p> deselects the first completion
" candidate that vim selects by default
inoremap <unique> <C-Space> <C-X><C-O><C-P>
endif
" Calling this once solves the problem of BufRead/BufEnter not triggering for
" the first loaded file. This should be the last command executed in this
" function!
call s:OnBufferVisit()
endfunction
function! s:OnBufferVisit()
call s:SetCompleteFunc()
call s:OnFileReadyToParse()
endfunction
function! s:OnCursorHold()
call s:OnFileReadyToParse()
call s:UpdateDiagnosticNotifications()
endfunction
function! s:OnFileReadyToParse()
py ycm_state.OnFileReadyToParse()
endfunction
function! s:SetCompleteFunc()
let &completefunc = 'youcompleteme#Complete'
let &l:completefunc = 'youcompleteme#Complete'
if pyeval( 'ycm_state.FiletypeCompletionEnabledForCurrentFile()' )
let &omnifunc = 'youcompleteme#OmniComplete'
let &l:omnifunc = 'youcompleteme#OmniComplete'
endif
endfunction
function! s:OnCursorMovedInsertMode()
call s:IdentifierFinishedOperations()
call s:InvokeCompletion()
endfunction
function! s:OnCursorMovedNormalMode()
call s:UpdateDiagnosticNotifications()
endfunction
function! s:OnInsertLeave()
let s:omnifunc_mode = 0
call s:UpdateDiagnosticNotifications()
py ycm_state.OnInsertLeave()
endfunction
function! s:UpdateDiagnosticNotifications()
if get( g:, 'loaded_syntastic_plugin', 0 ) &&
\ pyeval( 'ycm_state.FiletypeCompletionEnabledForCurrentFile()' ) &&
\ pyeval( 'ycm_state.DiagnosticsForCurrentFileReady()' )
SyntasticCheck
endif
endfunction
function! s:IdentifierFinishedOperations()
if !pyeval( 'ycm.CurrentIdentifierFinished()' )
return
endif
py ycm_state.OnCurrentIdentifierFinished()
let s:omnifunc_mode = 0
endfunction
function! s:InsideCommentOrString()
" Has to be col('.') -1 because col('.') doesn't exist at this point. We are
" in insert mode when this func is called.
let syntax_group = synIDattr( synID( line( '.' ), col( '.' ) - 1, 1 ), 'name')
if stridx(syntax_group, 'Comment') > -1 || stridx(syntax_group, 'String') > -1
return 1
endif
return 0
endfunction
function! s:InvokeCompletion()
if &completefunc != "youcompleteme#Complete"
return
endif
if s:InsideCommentOrString()
return
endif
" This is tricky. First, having 'refresh' set to 'always' in the dictionary
" that our completion function returns makes sure that our completion function
" is called on every keystroke when the completion menu is showing
" (pumvisible() == true). So there's no point in invoking the completion menu
" with our feedkeys call then.
" Secondly, when the sequence of characters the user typed produces no
" results in our search an infinite loop can occur. The problem is that our
" feedkeys call triggers the OnCursorMovedI event which we are tied to.
" So we solve this with the searched_and_no_results_found script-scope
" variable that prevents this infinite loop from starting.
if pumvisible() || s:searched_and_no_results_found
let s:searched_and_no_results_found = 0
return
endif
" <c-x><c-u> invokes the user's completion function (which we have set to
" youcompleteme#Complete), and <c-p> tells Vim to select the previous
" completion candidate. This is necessary because by default, Vim selects the
" first candidate when completion is invoked, and selecting a candidate
" automatically replaces the current text with it. Calling <c-p> forces Vim to
" deselect the first candidate and in turn preserve the user's current text
" until he explicitly chooses to replace it with a completion.
call feedkeys( "\<C-X>\<C-U>\<C-P>", 'n' )
endfunction
function! s:CompletionsForQuery( query, use_filetype_completer )
if a:use_filetype_completer
py completer = ycm_state.GetFiletypeCompleterForCurrentFile()
else
py completer = ycm_state.GetIdentifierCompleter()
endif
" TODO: don't trigger on a dot inside a string constant
py completer.CandidatesForQueryAsync( vim.eval( 'a:query' ) )
let l:results_ready = 0
while !l:results_ready
let l:results_ready = pyeval( 'completer.AsyncCandidateRequestReady()' )
if complete_check()
return { 'words' : [], 'refresh' : 'always'}
endif
endwhile
let l:results = pyeval( 'completer.CandidatesFromStoredRequest()' )
let s:searched_and_no_results_found = len( l:results ) == 0
return { 'words' : l:results, 'refresh' : 'always' }
endfunction
" This is our main entry point. This is what vim calls to get completions.
function! youcompleteme#Complete( findstart, base )
" After the user types one character after the call to the omnifunc, the
" completefunc will be called because of our mapping that calls the
" completefunc on every keystroke. Therefore we need to delegate the call we
" 'stole' back to the omnifunc
if s:omnifunc_mode
return youcompleteme#OmniComplete( a:findstart, a:base )
endif
if a:findstart
let s:completion_start_column = pyeval( 'ycm.CompletionStartColumn()' )
let s:should_use_filetype_completion =
\ pyeval( 'ycm_state.ShouldUseFiletypeCompleter(' .
\ s:completion_start_column . ')' )
if !s:should_use_filetype_completion &&
\ !pyeval( 'ycm_state.ShouldUseIdentifierCompleter(' .
\ s:completion_start_column . ')' )
" for vim, -2 means not found but don't trigger an error message
" see :h complete-functions
return -2
endif
return s:completion_start_column
else
return s:CompletionsForQuery( a:base, s:should_use_filetype_completion )
endif
endfunction
function! youcompleteme#OmniComplete( findstart, base )
if a:findstart
let s:omnifunc_mode = 1
let s:completion_start_column = pyeval( 'ycm.CompletionStartColumn()' )
return s:completion_start_column
else
return s:CompletionsForQuery( a:base, 1 )
endif
endfunction
" This is what Syntastic calls indirectly when it decides an auto-check is
" required (currently that's on buffer save) OR when the SyntasticCheck command
" is invoked
function! youcompleteme#CurrentFileDiagnostics()
return pyeval( 'ycm_state.GetDiagnosticsForCurrentFile()' )
endfunction
" This is basic vim plugin boilerplate
let &cpo = s:save_cpo
unlet s:save_cpo