" File: UltiSnips.vim " Author: Holger Rapp " Description: The Ultimate Snippets solution for Vim " Last Modified: July 21, 2009 " " Testing Info: {{{ " See directions at the top of the test.py script located one " directory above this file. " }}} if exists('did_UltiSnips_vim') || &cp || version < 700 || !has("python") finish endif " Global Variables {{{ " The trigger used to expand a snippet. " NOTE: expansion and forward jumping can, but needn't be the same trigger if !exists("g:UltiSnipsExpandTrigger") let g:UltiSnipsExpandTrigger = "" endif " The trigger used to display all triggers that could possible " match in the current position. if !exists("g:UltiSnipsListSnippets") let g:UltiSnipsListSnippets = "" endif " The trigger used to jump forward to the next placeholder. " NOTE: expansion and forward jumping can, but needn't be the same trigger if !exists("g:UltiSnipsJumpForwardTrigger") let g:UltiSnipsJumpForwardTrigger = "" endif " The trigger to jump backward inside a snippet if !exists("g:UltiSnipsJumpBackwardTrigger") let g:UltiSnipsJumpBackwardTrigger = "" endif " Should UltiSnips unmap select mode mappings automagically? if !exists("g:UltiSnipsRemoveSelectModeMappings") let g:UltiSnipsRemoveSelectModeMappings = 1 end " If UltiSnips should remove Mappings, which should be ignored if !exists("g:UltiSnipsMappingsToIgnore") let g:UltiSnipsMappingsToIgnore = [] endif " UltiSnipsEdit will use this variable to decide if a new window " is opened when editing. default is "normal", allowed are also " "vertical", "horizontal" if !exists("g:UltiSnipsEditSplit") let g:UltiSnipsEditSplit = 'normal' endif " }}} "" Global Commands {{{ " reset/reload snippets command! -nargs=0 UltiSnipsReset :py UltiSnips_Manager.reset() function! UltiSnipsEdit(...) if a:0 == 1 && a:1 != '' let type = a:1 elseif &filetype != '' let type = split(&filetype, '\.')[0] else let type = 'all' endif if exists('g:UltiSnipsSnippetsDir') let mode = 'e' if exists('g:UltiSnipsEditSplit') if g:UltiSnipsEditSplit == 'vertical' let mode = 'vs' elseif g:UltiSnipsEditSplit == 'horizontal' let mode = 'sp' endif endif exe ':'.mode.' '.g:UltiSnipsSnippetsDir.'/'.type.'.snippets' else for dir in split(&runtimepath, ',') if isdirectory(dir.'/UltiSnips') let g:UltiSnipsSnippetsDir = dir.'/UltiSnips' call UltiSnipsEdit(type) break endif endfor endif endfunction " edit snippets, default of current file type or the specified type command! -nargs=? UltiSnipsEdit :call UltiSnipsEdit() "" }}} "" FUNCTIONS {{{ function! CompensateForPUM() """ The CursorMovedI event is not triggered while the popup-menu is visible, """ and it's by this event that UltiSnips updates its vim-state. The fix is """ to explicitly check for the presence of the popup menu, and update """ the vim-state accordingly. if pumvisible() py UltiSnips_Manager.cursor_moved() endif endfunction function! UltiSnips_ExpandSnippet() py UltiSnips_Manager.expand() return "" endfunction function! UltiSnips_ExpandSnippetOrJump() call CompensateForPUM() py UltiSnips_Manager.expand_or_jump() return "" endfunction function! UltiSnips_ListSnippets() py UltiSnips_Manager.list_snippets() return "" endfunction function! UltiSnips_JumpBackwards() call CompensateForPUM() py UltiSnips_Manager.jump_backwards() return "" endfunction function! UltiSnips_JumpForwards() call CompensateForPUM() py UltiSnips_Manager.jump_forwards() return "" endfunction function! UltiSnips_AddSnippet(trigger, value, descr, options, ...) " Takes the same arguments as SnippetManager.add_snippet: " (trigger, value, descr, options, ft = "all", globals = None) py << EOB args = vim.eval("a:000") trigger = vim.eval("a:trigger") value = vim.eval("a:value") descr = vim.eval("a:descr") options = vim.eval("a:options") UltiSnips_Manager.add_snippet(trigger, value, descr, options, *args) EOB return "" endfunction function! UltiSnips_Anon(value, ...) " Takes the same arguments as SnippetManager.expand_anon: " (value, trigger="", descr="", options="", globals = None) py << EOB args = vim.eval("a:000") value = vim.eval("a:value") UltiSnips_Manager.expand_anon(value, *args) EOB return "" endfunction function! UltiSnips_MapKeys() " Map the keys correctly if g:UltiSnipsExpandTrigger == g:UltiSnipsJumpForwardTrigger exec "inoremap " . g:UltiSnipsExpandTrigger . " =UltiSnips_ExpandSnippetOrJump()" exec "snoremap " . g:UltiSnipsExpandTrigger . " :call UltiSnips_ExpandSnippetOrJump()" else exec "inoremap " . g:UltiSnipsExpandTrigger . " =UltiSnips_ExpandSnippet()" exec "snoremap " . g:UltiSnipsExpandTrigger . " :call UltiSnips_ExpandSnippet()" exec "inoremap " . g:UltiSnipsJumpForwardTrigger . " =UltiSnips_JumpForwards()" exec "snoremap " . g:UltiSnipsJumpForwardTrigger . " :call UltiSnips_JumpForwards()" endif exec "inoremap " . g:UltiSnipsJumpBackwardTrigger . " =UltiSnips_JumpBackwards()" exec "snoremap " . g:UltiSnipsJumpBackwardTrigger . " :call UltiSnips_JumpBackwards()" exec "inoremap " . g:UltiSnipsListSnippets . " =UltiSnips_ListSnippets()" exec "snoremap " . g:UltiSnipsListSnippets . " :call UltiSnips_ListSnippets()" " Do not remap this. snoremap :py UltiSnips_Manager.backspace_while_selected() endf " }}} "" STARTUP CODE {{{ " Expand our path python << EOF import vim, os, sys for p in vim.eval("&runtimepath").split(','): dname = p + os.path.sep + "plugin" if os.path.exists(dname + os.path.sep + "UltiSnips"): if dname not in sys.path: sys.path.append(dname) break from UltiSnips import UltiSnips_Manager UltiSnips_Manager.expand_trigger = vim.eval("g:UltiSnipsExpandTrigger") UltiSnips_Manager.forward_trigger = vim.eval("g:UltiSnipsJumpForwardTrigger") UltiSnips_Manager.backward_trigger = vim.eval("g:UltiSnipsJumpBackwardTrigger") EOF au CursorMovedI * py UltiSnips_Manager.cursor_moved() au InsertEnter * py UltiSnips_Manager.entered_insert_mode() call UltiSnips_MapKeys() let did_UltiSnips_vim=1 " }}}