All patches and comments are welcome. Please squash your changes to logical
commits before using git-format-patch and git-send-email to
patches@git.madduck.net.
If you'd read over the Git project's submission guidelines and adhered to them,
I'd be especially grateful.
1 " vint: -ProhibitUnusedVariable
4 let s:t_dict = type({})
6 let s:default_completion_item_kinds = {
26 \ '20': 'enum member',
31 \ '25': 'type parameter',
34 let s:completion_item_kinds = {}
36 let s:completion_status_success = 'success'
37 let s:completion_status_failed = 'failed'
38 let s:completion_status_pending = 'pending'
40 let s:is_user_data_support = has('patch-8.0.1493')
41 let s:managed_user_data_key_base = 0
42 let s:managed_user_data_map = {}
47 let s:completion = {'counter': 0, 'status': '', 'matches': []}
49 function! lsp#omni#complete(findstart, base) abort
50 let l:info = s:find_complete_servers()
51 if empty(l:info['server_names'])
52 return a:findstart ? -1 : []
58 if !g:lsp_async_completion
59 let s:completion['status'] = s:completion_status_pending
62 let l:left = strpart(getline('.'), 0, col('.')-1)
64 " Initialize the default startcol. It will be updated if the completion items has textEdit.
65 let s:completion['startcol'] = s:get_startcol(l:left, l:info['server_names'])
67 " The `l:info` variable will be filled with completion results after request was finished.
68 call s:send_completion_request(l:info)
70 if g:lsp_async_completion
71 " If g:lsp_async_completion == v:true, the `s:display_completions` " will be called by `s:send_completion_request`.
73 return exists('v:none') ? v:none : []
75 " Wait for finished the textDocument/completion request and then call `s:display_completions` explicitly.
76 call lsp#utils#_wait(-1, {-> s:completion['status'] isnot# s:completion_status_pending || complete_check()}, 10)
77 call timer_start(0, { timer -> s:display_completions(timer, l:info) })
79 return exists('v:none') ? v:none : []
84 function! s:get_filter_label(item) abort
85 return lsp#utils#_trim(a:item['word'])
88 function! s:prefix_filter(item, last_typed_word) abort
89 let l:label = s:get_filter_label(a:item)
92 return stridx(tolower(l:label), tolower(a:last_typed_word)) == 0
94 return stridx(l:label, a:last_typed_word) == 0
98 function! s:contains_filter(item, last_typed_word) abort
99 let l:label = s:get_filter_label(a:item)
102 return stridx(tolower(l:label), tolower(a:last_typed_word)) >= 0
104 return stridx(l:label, a:last_typed_word) >= 0
116 function! s:display_completions(timer, info) abort
117 " TODO: Allow multiple servers
118 let l:server_name = a:info['server_names'][0]
119 let l:server_info = lsp#get_server_info(l:server_name)
121 let l:current_line = strpart(getline('.'), 0, col('.') - 1)
122 let l:last_typed_word = strpart(l:current_line, s:completion['startcol'] - 1)
124 let l:filter = has_key(l:server_info, 'config') && has_key(l:server_info['config'], 'filter') ? l:server_info['config']['filter'] : { 'name': 'prefix' }
125 if l:filter['name'] ==? 'prefix'
126 let s:completion['matches'] = filter(s:completion['matches'], {_, item -> s:prefix_filter(item, l:last_typed_word)})
127 if has_key(s:pair, l:last_typed_word[0])
128 let [l:lhs, l:rhs] = [l:last_typed_word[0], s:pair[l:last_typed_word[0]]]
129 for l:item in s:completion['matches']
130 let l:str = l:item['word']
131 if len(l:str) > 1 && l:str[0] ==# l:lhs && l:str[-1:] ==# l:rhs
132 let l:item['word'] = l:str[:-2]
136 elseif l:filter['name'] ==? 'contains'
137 let s:completion['matches'] = filter(s:completion['matches'], {_, item -> s:contains_filter(item, l:last_typed_word)})
140 let s:completion['status'] = ''
143 call complete(s:completion['startcol'], s:completion['matches'])
147 function! s:handle_omnicompletion(server_name, complete_counter, info, data) abort
148 if s:completion['counter'] != a:complete_counter
149 " ignore old completion results
153 if lsp#client#is_error(a:data) || !has_key(a:data, 'response') || !has_key(a:data['response'], 'result')
154 let s:completion['status'] = s:completion_status_failed
158 let l:result = s:get_completion_result(a:server_name, a:data)
159 let s:completion['matches'] = l:result['items']
160 let s:completion['startcol'] = min([l:result['startcol'], s:completion['startcol']])
161 let s:completion['status'] = s:completion_status_success
163 if g:lsp_async_completion
164 call s:display_completions(0, a:info)
168 function! lsp#omni#get_kind_text(completion_item, ...) abort
169 let l:server = get(a:, 1, '')
170 if empty(l:server) " server name
171 let l:completion_item_kinds = s:default_completion_item_kinds
173 if !has_key(s:completion_item_kinds, l:server)
174 let l:server_info = lsp#get_server_info(l:server)
175 if has_key (l:server_info, 'config') && has_key(l:server_info['config'], 'completion_item_kinds')
176 let s:completion_item_kinds[l:server] = extend(copy(s:default_completion_item_kinds), l:server_info['config']['completion_item_kinds'])
178 let s:completion_item_kinds[l:server] = s:default_completion_item_kinds
181 let l:completion_item_kinds = s:completion_item_kinds[l:server]
184 return has_key(a:completion_item, 'kind') && has_key(l:completion_item_kinds, a:completion_item['kind'])
185 \ ? l:completion_item_kinds[a:completion_item['kind']] : ''
188 function! s:get_kind_text_mappings(server) abort
189 let l:server_name = a:server['name']
190 if has_key(s:completion_item_kinds, l:server_name)
191 return s:completion_item_kinds[l:server_name]
193 if has_key(a:server, 'config') && has_key(a:server['config'], 'completion_item_kinds')
194 let s:completion_item_kinds[l:server_name] = extend(copy(s:default_completion_item_kinds), a:server['config']['completion_item_kinds'])
196 let s:completion_item_kinds[l:server_name] = s:default_completion_item_kinds
198 return s:completion_item_kinds[l:server_name]
202 " auxiliary functions {{{
204 function! s:find_complete_servers() abort
205 let l:server_names = []
206 for l:server_name in lsp#get_allowed_servers()
207 if lsp#capabilities#has_completion_provider(l:server_name)
208 " TODO: support triggerCharacters
209 call add(l:server_names, l:server_name)
213 return { 'server_names': l:server_names }
216 function! s:send_completion_request(info) abort
217 let s:completion['counter'] = s:completion['counter'] + 1
218 let l:server_name = a:info['server_names'][0]
219 " TODO: support multiple servers
220 call lsp#send_request(l:server_name, {
221 \ 'method': 'textDocument/completion',
223 \ 'textDocument': lsp#get_text_document_identifier(),
224 \ 'position': lsp#get_position(),
225 \ 'context': { 'triggerKind': 1 },
227 \ 'on_notification': function('s:handle_omnicompletion', [l:server_name, s:completion['counter'], a:info]),
231 function! s:get_completion_result(server_name, data) abort
232 let l:result = a:data['response']['result']
235 \ 'server': lsp#get_server_info(a:server_name),
236 \ 'position': lsp#get_position(),
237 \ 'response': a:data['response'],
240 return lsp#omni#get_vim_completion_items(l:options)
243 function! s:sort_by_sorttext(i1, i2) abort
244 let l:text1 = get(a:i1, 'sortText')
245 let l:text2 = get(a:i2, 'sortText')
247 " sortText is possibly empty string
248 let l:text1 = !empty(l:text1) ? l:text1 : a:i1['label']
249 let l:text2 = !empty(l:text2) ? l:text2 : a:i2['label']
252 return l:text1 ==? l:text2 ? 0 : l:text1 >? l:text2 ? 1 : -1
254 return l:text1 ==# l:text2 ? 0 : l:text1 ># l:text2 ? 1 : -1
258 " Create vim's completed items from LSP response.
261 " server: {}, " needs to be server_info and not server_name
262 " position: lsp#get_position(),
263 " response: {}, " needs to be the entire lsp response. errors need to be
264 " handled before calling the fuction
267 " * The returned` startcol` may be the same as the cursor position, in which case you need to decide which one to use.
269 " @return { 'items': v:completed_item[], 'incomplete': v:t_bool, 'startcol': number }
271 function! lsp#omni#get_vim_completion_items(options) abort
272 let l:server = a:options['server']
273 let l:server_name = l:server['name']
274 let l:kind_text_mappings = s:get_kind_text_mappings(l:server)
275 let l:complete_position = a:options['position']
276 let l:current_line = getline('.')
277 let l:default_startcol = s:get_startcol(strcharpart(l:current_line, 0, l:complete_position['character']), [l:server_name])
278 let l:default_start_character = strchars(strpart(l:current_line, 0, l:default_startcol - 1))
279 let l:refresh_pattern = s:get_refresh_pattern([l:server_name])
281 let l:result = a:options['response']['result']
282 if type(l:result) == type([])
283 let l:items = l:result
285 elseif type(l:result) == type({})
286 let l:items = l:result['items']
287 let l:incomplete = l:result['isIncomplete']
293 let l:sort = has_key(l:server, 'config') && has_key(l:server['config'], 'sort') ? l:server['config']['sort'] : v:null
295 if len(l:items) > 0 && type(l:sort) == s:t_dict && len(l:items) <= l:sort['max']
296 " If first item contains sortText, maybe we can use sortText
297 call sort(l:items, function('s:sort_by_sorttext'))
300 let l:start_character = l:complete_position['character']
302 let l:start_characters = [] " The mapping of item specific start_character.
303 let l:vim_complete_items = []
304 for l:completion_item in l:items
305 let l:expandable = get(l:completion_item, 'insertTextFormat', 1) == 2
306 let l:vim_complete_item = {
307 \ 'kind': get(l:kind_text_mappings, get(l:completion_item, 'kind', '') , ''),
312 let l:range = lsp#utils#text_edit#get_range(get(l:completion_item, 'textEdit', {}))
313 let l:complete_word = ''
314 if has_key(l:completion_item, 'textEdit') && type(l:completion_item['textEdit']) == s:t_dict && !empty(l:range) && has_key(l:completion_item['textEdit'], 'newText')
315 let l:text_edit_new_text = l:completion_item['textEdit']['newText']
316 if has_key(l:completion_item, 'filterText') && !empty(l:completion_item['filterText']) && matchstr(l:text_edit_new_text, '^' . l:refresh_pattern) ==# ''
317 " Use filterText as word.
318 let l:complete_word = l:completion_item['filterText']
320 " Use textEdit.newText as word.
321 let l:complete_word = l:text_edit_new_text
324 let l:item_start_character = l:range['start']['character']
325 let l:start_character = min([l:item_start_character, l:start_character])
326 let l:start_characters += [l:item_start_character]
327 elseif has_key(l:completion_item, 'insertText') && !empty(l:completion_item['insertText'])
328 let l:complete_word = l:completion_item['insertText']
329 let l:start_characters += [l:default_start_character]
331 let l:complete_word = l:completion_item['label']
332 let l:start_characters += [l:default_start_character]
336 let l:vim_complete_item['word'] = lsp#utils#make_valid_word(substitute(l:complete_word, '\$[0-9]\+\|\${\%(\\.\|[^}]\)\+}', '', 'g'))
337 let l:vim_complete_item['abbr'] = l:completion_item['label'] . '~'
339 let l:vim_complete_item['word'] = l:complete_word
340 let l:vim_complete_item['abbr'] = l:completion_item['label']
343 if s:is_user_data_support
344 let l:vim_complete_item['user_data'] = s:create_user_data(
347 \ l:complete_position,
348 \ l:start_characters[-1],
352 let l:vim_complete_items += [l:vim_complete_item]
355 " Add the additional text for startcol correction.
356 if l:start_character != l:default_start_character
357 for l:i in range(len(l:start_characters))
358 let l:item_start_character = l:start_characters[l:i]
359 if l:start_character < l:item_start_character
360 let l:item = l:vim_complete_items[l:i]
361 let l:item['word'] = strcharpart(l:current_line, l:start_character, l:item_start_character - l:start_character) . l:item['word']
365 let l:startcol = lsp#utils#position#lsp_character_to_vim('%', { 'line': l:complete_position['line'], 'character': l:start_character })
367 return { 'items': l:vim_complete_items, 'incomplete': l:incomplete, 'startcol': l:startcol }
371 " Clear internal user_data map.
373 " This function should call at `CompleteDone` only if not empty `v:completed_item`.
375 function! lsp#omni#_clear_managed_user_data_map() abort
376 let s:managed_user_data_key_base = 0
377 let s:managed_user_data_map = {}
381 " create item's user_data.
383 function! s:create_user_data(completion_item, server_name, complete_position, start_character, complete_word) abort
384 let l:user_data_key = s:create_user_data_key(s:managed_user_data_key_base)
385 let s:managed_user_data_map[l:user_data_key] = {
386 \ 'complete_position': a:complete_position,
387 \ 'server_name': a:server_name,
388 \ 'completion_item': a:completion_item,
389 \ 'start_character': a:start_character,
390 \ 'complete_word': a:complete_word,
392 let s:managed_user_data_key_base += 1
393 return l:user_data_key
396 function! lsp#omni#get_managed_user_data_from_completed_item(completed_item) abort
397 " the item has no user_data.
398 if !has_key(a:completed_item, 'user_data')
402 let l:user_data_string = get(a:completed_item, 'user_data', '')
403 if type(l:user_data_string) != type('')
407 " Check managed user_data.
408 if has_key(s:managed_user_data_map, l:user_data_string)
409 return s:managed_user_data_map[l:user_data_string]
413 if stridx(l:user_data_string, '"vim-lsp/key"') != -1
415 let l:user_data = json_decode(l:user_data_string)
416 if has_key(l:user_data, 'vim-lsp/key')
417 let l:user_data_key = s:create_user_data_key(l:user_data['vim-lsp/key'])
418 if has_key(s:managed_user_data_map, l:user_data_key)
419 return s:managed_user_data_map[l:user_data_key]
428 function! lsp#omni#get_completion_item_kinds() abort
429 return map(keys(s:default_completion_item_kinds), {idx, key -> str2nr(key)})
432 function! s:create_user_data_key(base) abort
433 return '{"vim-lsp/key":"' . a:base . '"}'
436 function! s:get_startcol(left, server_names) abort
437 " Initialize the default startcol. It will be updated if the completion items has textEdit.
438 let l:startcol = 1 + matchstrpos(a:left, s:get_refresh_pattern(a:server_names))[1]
439 return l:startcol == 0 ? strlen(a:left) + 1 : l:startcol
442 function! s:get_refresh_pattern(server_names) abort
443 for l:server_name in a:server_names
444 let l:server_info = lsp#get_server_info(l:server_name)
445 if has_key(l:server_info, 'config') && has_key(l:server_info['config'], 'refresh_pattern')
446 return l:server_info['config']['refresh_pattern']