YouCompleteMe/autoload/youcompleteme.vim

240 lines
8.1 KiB
VimL
Raw Normal View History

2012-04-15 23:28:46 -04:00
" Copyright (C) 2011, 2012 Strahinja Val Markovic <val@markovic.io>
2012-04-15 19:57:10 -04:00
"
" 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_clang = 0
2012-04-15 19:57:10 -04:00
let g:ycm_min_num_of_chars_for_completion = 2
" TODO: check for a non-broken version of Vim and stop executing (with an error
" message) if the detected version is too old
2012-04-15 19:57:10 -04:00
function! youcompleteme#Enable()
augroup youcompleteme
autocmd!
autocmd CursorMovedI * call s:OnMovedI()
" TODO: BufWinEnter/Leave?
autocmd BufRead,BufEnter * call s:OnBufferVisit()
autocmd CursorHold,CursorHoldI * call s:OnCursorHold()
2012-04-15 19:57:10 -04:00
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
" We need this in spite of binding SetCompleteFunc to bufread and bufenter
" because neither event is called when vim is started and the cursor is placed
" in the file that was previously open (with for instance the session.vim
" plugin)
call s:SetCompleteFunc()
" 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>"
py import vim
exe 'python sys.path = sys.path + ["' . s:script_folder_path . '/../python"]'
py import ycm
py csystem = ycm.CompletionSystem()
py clangcomp = ycm.ClangComplete()
2012-04-15 19:57:10 -04:00
endfunction
function! s:OnBufferVisit()
call s:SetCompleteFunc()
py csystem.AddBufferIdentifiers()
endfunction
function! s:OnCursorHold()
py csystem.AddBufferIdentifiers()
endfunction
2012-04-15 19:57:10 -04:00
function! s:SetCompleteFunc()
let &completefunc = 'youcompleteme#Complete'
let &l:completefunc = 'youcompleteme#Complete'
endfunction
2012-04-15 19:57:10 -04:00
function! s:OnMovedI()
" Technically, what we are doing here is not thread-safe. We are adding a new
" identifier to the database while a background thread may be going through
" that db, searching for matches for the previous query. BUT, we don't care
" what junk that thread may get; those results don't matter anymore since
" right after this function is called, we start a new candidate search with a
" new query, and the old one is thrown away. The background thread never
" modifies the db, only reads it.
call s:AddIdentifierIfNeeded()
2012-04-15 19:57:10 -04:00
call s:InvokeCompletion()
endfunction
function! s:AddIdentifierIfNeeded()
py vim.command( "let should_add_identifier = " +
\ str( int( ycm.ShouldAddIdentifier() ) ) )
if should_add_identifier != 1
return
endif
py csystem.AddPreviousIdentifier()
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
2012-04-15 19:57:10 -04:00
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
2012-04-15 19:57:10 -04:00
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
2012-04-15 19:57:10 -04:00
" first candidate when completion is invoked, and selecting a candidate
" automatically replaces the current text with it. Calling <c-p> forces Vim to
2012-04-15 19:57:10 -04:00
" 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:IdentifierCompletion(query)
if strlen( a:query ) < g:ycm_min_num_of_chars_for_completion
return []
endif
2012-04-15 19:57:10 -04:00
py csystem.CandidatesForQueryAsync( vim.eval('a:query') )
let l:results_ready = 0
while !l:results_ready
py << EOF
results_ready = csystem.AsyncCandidateRequestReady()
if results_ready:
vim.command( 'let l:results_ready = 1' )
EOF
if complete_check()
return { 'words' : [], 'refresh' : 'always'}
endif
endwhile
let l:results = []
2012-04-15 19:57:10 -04:00
py << EOF
results = csystem.CandidatesFromStoredRequest()
2012-04-15 19:57:10 -04:00
if results:
vim.command( 'let l:results = ' + str( results ) )
EOF
let s:searched_and_no_results_found = len( l:results ) == 0
" We need a very recent version of vim for this to work; otherwise, even
" when we set refresh = always, vim won't call our completefunc on every
" keystroke. The problem is still present in vim 7.3.390 but is fixed in
" 7.3.475. It's possible that patch 404 was the one that fixed this issue,
" but I haven't tested this assumption.
" A bug in vim causes the '.' register to break when we use set this... sigh
return { 'words' : l:results, 'refresh' : 'always' }
endfunction
function! s:ClangCompletion( query )
py vim.command( 'let l:results = ' +
\ str( clangcomp.CandidatesForQuery( vim.eval( 'a:query' ) ) ) )
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 )
if a:findstart
py << EOF
start_column = ycm.CompletionStartColumn()
vim.command( 'let l:start_column = ' + str( start_column ) )
vim.command( 'let s:should_use_clang = ' +
str( int( ycm.ShouldUseClang( start_column ) ) ) )
EOF
if ( s:should_use_clang )
return start_column
else
let l:current_column = col('.') - 1
let l:query_length = current_column - start_column
if ( query_length < g:ycm_min_num_of_chars_for_completion )
" for vim, -2 means not found but don't trigger an error message
" see :h complete-functions
return -2
endif
return start_column
endif
else
if ( s:should_use_clang )
return s:ClangCompletion( a:base )
else
return s:IdentifierCompletion( a:base )
endif
2012-04-15 19:57:10 -04:00
endif
endfunction
" This is basic vim plugin boilerplate
let &cpo = s:save_cpo
unlet s:save_cpo