" Copyright (C) 2011, 2012 Strahinja Val Markovic " " 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 . " 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( ':p:h' ), '\' ) let s:searched_and_results_found = 0 let s:should_use_filetype_completion = 0 let s:completion_start_column = 0 let s:omnifunc_mode = 0 let s:old_cursor_position = [] let s:cursor_moved = 0 let s:moved_vertically_in_insert_mode = 0 let s:previous_num_chars_on_current_line = -1 function! youcompleteme#Enable() " When vim is in diff mode, don't run if &diff 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() autocmd InsertEnter * call s:OnInsertEnter() augroup END call s:SetUpCompleteopt() if g:ycm_allow_changing_updatetime set ut=2000 endif " Needed so that YCM is used as the syntastic checker let g:syntastic_cpp_checkers = ['ycm'] let g:syntastic_c_checkers = ['ycm'] let g:syntastic_objc_checkers = ['ycm'] let g:syntastic_objcpp_checkers = ['ycm'] " With this command, when the completion window is visible, the tab key " (default) will select the next candidate in the window. In vim, this also " changes the typed-in text to that of the candidate completion. exe 'inoremap ' . g:ycm_key_select_completion . \ ' pumvisible() ? "\" : "\' . g:ycm_key_select_completion .'"' " This selects the previous candidate for shift-tab (default) exe 'inoremap ' . g:ycm_key_previous_completion . \ ' pumvisible() ? "\" : "\' . g:ycm_key_previous_completion .'"' " trigger omni completion, deselects the first completion " candidate that vim selects by default exe 'inoremap ' . g:ycm_key_invoke_completion . ' ' exe 'nnoremap ' . g:ycm_key_detailed_diagnostics . \ ' :call ShowDetailedDiagnostic()' py import sys py import vim exe 'python sys.path.insert( 0, "' . s:script_folder_path . '/../python" )' py import ycm py ycm_state = ycm.YouCompleteMe() " 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:AllowedToCompleteInCurrentFile() " If the user set the current filetype as a filetype that YCM should ignore, " then we don't do anything return !get( g:ycm_filetypes_to_completely_ignore, &filetype, 0 ) endfunction function! s:SetUpCompleteopt() " Some plugins (I'm looking at you, vim-notes) change completeopt by for " instance adding 'longest'. This breaks YCM. So we force our settings. " There's no two ways about this: if you want to use YCM then you have to " have these completeopt settings, otherwise YCM won't work at all. " 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 endfunction function! s:OnBufferVisit() if !s:AllowedToCompleteInCurrentFile() return endif call s:SetUpCompleteopt() call s:SetCompleteFunc() call s:OnFileReadyToParse() endfunction function! s:OnCursorHold() if !s:AllowedToCompleteInCurrentFile() return endif call s:SetUpCompleteopt() " Order is important here; we need to extract any done diagnostics before " reparsing the file again call s:UpdateDiagnosticNotifications() call s:OnFileReadyToParse() 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() if !s:AllowedToCompleteInCurrentFile() return endif call s:UpdateCursorMoved() " Basically, we need to only trigger the completion menu when the user has " inserted or deleted a character, NOT just when the user moves in insert mode " (with, say, the arrow keys). If we trigger the menu even on pure moves, then " it's impossible to move in insert mode since the up/down arrows start moving " the selected completion in the completion menu. Yeah, people shouldn't be " moving in insert mode at all (that's what normal mode is for) but explain " that to the users who complain... if !s:BufferTextChangedSinceLastMoveInInsertMode() return endif call s:IdentifierFinishedOperations() call s:ClosePreviewWindowIfNeeded() call s:InvokeCompletion() endfunction function! s:OnCursorMovedNormalMode() if !s:AllowedToCompleteInCurrentFile() return endif call s:UpdateDiagnosticNotifications() endfunction function! s:OnInsertLeave() if !s:AllowedToCompleteInCurrentFile() return endif let s:omnifunc_mode = 0 call s:UpdateDiagnosticNotifications() py ycm_state.OnInsertLeave() call s:ClosePreviewWindowIfNeeded() endfunction function! s:OnInsertEnter() if !s:AllowedToCompleteInCurrentFile() return endif let s:old_cursor_position = [] endfunction function! s:UpdateCursorMoved() let current_position = getpos('.') let s:cursor_moved = current_position != s:old_cursor_position let s:moved_vertically_in_insert_mode = s:old_cursor_position != [] && \ current_position[ 1 ] != s:old_cursor_position[ 1 ] let s:old_cursor_position = current_position endfunction function! s:BufferTextChangedSinceLastMoveInInsertMode() if s:moved_vertically_in_insert_mode let s:previous_num_chars_on_current_line = -1 return 0 endif let num_chars_in_current_cursor_line = strlen( getline('.') ) if s:previous_num_chars_on_current_line == -1 let s:previous_num_chars_on_current_line = num_chars_in_current_cursor_line return 0 endif let changed_text_on_current_line = num_chars_in_current_cursor_line != \ s:previous_num_chars_on_current_line let s:previous_num_chars_on_current_line = num_chars_in_current_cursor_line return changed_text_on_current_line endfunction function! s:ClosePreviewWindowIfNeeded() if !g:ycm_autoclose_preview_window_after_completion return endif if s:searched_and_results_found " This command does the actual closing of the preview window. If no preview " window is shown, nothing happens. pclose endif 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. Second, 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. We prevent this infinite loop from starting by making sure that " the user has moved the cursor since the last time we provided completion " results. if !s:cursor_moved return endif " invokes the user's completion function (which we have set to " youcompleteme#Complete), and 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 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( "\\\", '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() let s:searched_and_results_found = 0 return { 'words' : [], 'refresh' : 'always'} endif endwhile let l:results = pyeval( 'completer.CandidatesFromStoredRequest()' ) let s:searched_and_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 " InvokeCompletion has this check but we also need it here because of random " Vim bugs and unfortunate interactions with the autocommands of other " plugins if !s:cursor_moved " for vim, -2 means not found but don't trigger an error message " see :h complete-functions return -2 endif 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 function! s:ShowDetailedDiagnostic() py ycm_state.ShowDetailedDiagnostic() 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 function! s:DebugInfo() echom "Printing YouCompleteMe debug information..." let debug_info = pyeval( 'ycm_state.DebugInfo()' ) for line in split( debug_info, "\n" ) echom '-- ' . line endfor endfunction command! YcmDebugInfo call s:DebugInfo() function! s:ForceCompile() if !pyeval( 'ycm_state.FiletypeCompletionEnabledForCurrentFile()' ) echom "Filetype completion not supported for current file, " \ . "cannot force recompilation." endif echom "Forcing compilation, this will block Vim until done." py ycm_state.OnFileReadyToParse() while 1 let diagnostics_ready = pyeval( \ 'ycm_state.DiagnosticsForCurrentFileReady()' ) if diagnostics_ready break endif sleep 100m endwhile endfunction function! s:ForceCompileAndDiagnostics() call s:ForceCompile() call s:UpdateDiagnosticNotifications() echom "Diagnostics refreshed." endfunction command! YcmForceCompileAndDiagnostics call s:ForceCompileAndDiagnostics() function! s:ShowDiagnostics() call s:ForceCompile() let diags = pyeval( 'ycm_state.GetDiagnosticsForCurrentFile()' ) if !empty( diags ) call setloclist( 0, diags ) lopen else echom "No warnings or errors detected" endif endfunction command! YcmDiags call s:ShowDiagnostics() " This is basic vim plugin boilerplate let &cpo = s:save_cpo unlet s:save_cpo