" config which can be overridden (shared lines) if !exists('g:snipMate') let g:snipMate = {} endif let s:c = g:snipMate try call tlib#input#List('mi', '', []) catch /.*/ echoe "you're missing tlib. See install instructions at ".expand(':h:h').'/README.rst' endtry " match $ which doesn't follow a \ let s:d = '\%([\\]\@" to make snipmate not swallow tab (make sure to not have " expandtab set). Remember that you can always enter tabs by then " you don't need this let s:c['no_match_completion_feedkeys_chars'] = get(s:c, 'no_match_completion_feedkeys_chars', "\t") fun! Filename(...) let filename = expand('%:t:r') if filename == '' | return a:0 == 2 ? a:2 : '' | endif return !a:0 || a:1 == '' ? filename : substitute(a:1, '$1', filename, 'g') endf let s:state_proto = {} fun! s:state_proto.remove() unlet! b:snip_state " Remove all buffer-local autocommands in the snipmate_changes group au! snipmate_changes * endf fun! snipMate#expandSnip(snip, col) let lnum = line('.') | let col = a:col let snippet = s:ProcessSnippet(a:snip) " Avoid error if eval evaluates to nothing if snippet == '' | return '' | endif " Expand snippet onto current position with the tab stops removed let snipLines = split(substitute(snippet, ''.s:d .'\d\+\|'.s:d .'{\d\+.\{-}}', '', 'g'), "\n", 1) let line = getline(lnum) let afterCursor = strpart(line, col - 1) " Keep text after the cursor if afterCursor != "\t" && afterCursor != ' ' let line = strpart(line, 0, col - 1) let snipLines[-1] .= afterCursor else let afterCursor = '' " For some reason the cursor needs to move one right after this if line != '' && col == 1 && &ve != 'all' && &ve != 'onemore' let col += 1 endif endif " Insert snippet with proper indentation let indent = indent(lnum) + 1 call setline(lnum, line . snipLines[0]) call append(lnum, map(snipLines[1:], "empty(v:val) ? v:val : '" . strpart(line, 0, indent - 1) . "' . v:val")) " Open any folds snippet expands into if &fen | sil! exe lnum.','.(lnum + len(snipLines) - 1).'foldopen' | endif let b:snip_state = copy(s:state_proto) let [b:snip_state.stops, b:snip_state.stop_count] = s:BuildTabStops(snippet, lnum, col - indent, indent) if b:snip_state.stop_count aug snipmate_changes au CursorMovedI,InsertEnter call b:snip_state.update_changes() aug END call b:snip_state.set_stop(0) return b:snip_state.select_word() else unlet b:snip_state " Place cursor at end of snippet if no tab stop is given let newlines = len(snipLines) - 1 call cursor(lnum + newlines, indent + len(snipLines[-1]) - len(afterCursor) \ + (newlines ? 0: col - 1)) endif return '' endf " Update state information to correspond to the given tab stop function! s:state_proto.set_stop(stop) let self.stop_no = a:stop let self.cur_stop = self.stops[self.stop_no] let self.end_col = self.cur_stop[1] + self.cur_stop[2] let self.start_col = self.cur_stop[1] call cursor(self.cur_stop[0], self.cur_stop[1]) let self.prev_len = col('$') let self.has_vars = exists('self.cur_stop[3]') let self.old_vars = self.has_vars ? deepcopy(self.cur_stop[3]) : [] endfunction " Prepare snippet to be processed by s:BuildTabStops fun! s:ProcessSnippet(snip) let snippet = a:snip if exists('g:snipmate_content_visual') let visual = g:snipmate_content_visual | unlet g:snipmate_content_visual else let visual = '' endif let snippet = substitute(snippet,'{VISUAL}', escape(visual,'%\'), 'g') " Evaluate eval (`...`) expressions. " Backquotes prefixed with a backslash "\" are ignored. " And backslash can be escaped by doubling it. " Using a loop here instead of a regex fixes a bug with nested "\=". if stridx(snippet, '`') != -1 let new = [] let snip = split(snippet, '\%(\\\@ a:lnum \ ? len(matchstr(beforeMark, '.*\n\zs.*')) \ : a:col + len(beforeMark)) let withoutOthers = substitute(withoutOthers, ''.s:d .''.i.'\ze\(\D\|$\)', '', '') endw endif let i += 1 endw return [snipPos, i - 1] endf function! s:state_proto.jump_stop(backwards) " Update changes just in case " This seems to be only needed because insert completion does not trigger " the CursorMovedI event call self.update_changes() " Update stop and var locations call self.update_stops() " Store the changed col/length of the current stop let self.cur_stop[1] = self.start_col let self.cur_stop[2] = self.end_col - self.start_col let self.stop_no += a:backwards ? -1 : 1 " Loop over the snippet when going backwards from the beginning if self.stop_no < 0 | let self.stop_no = self.stop_count - 1 | endif if self.stop_no == self.stop_count call self.remove() return -1 endif call self.set_stop(self.stop_no) return self.select_word() endfunction " Updates tab stops/vars function! s:state_proto.update_stops() let changeLen = self.end_col - self.cur_stop[2] - self.start_col " Update tab stops in snippet if text has been added via "$#" " (e.g., in "${1:foo}bar$1${2}"). if changeLen != 0 let curLine = line('.') for pos in self.stops if pos == self.cur_stop | continue | endif let changed = pos[0] == curLine && pos[1] > self.start_col let changedVars = 0 let endPlaceholder = pos[2] - 1 + pos[1] " Subtract changeLen from each tab stop that was after any of " the current tab stop's placeholders. for [lnum, col] in self.old_vars if lnum > pos[0] | break | endif if pos[0] == lnum if pos[1] > col || (pos[2] == -1 && pos[1] == col) let changed += 1 elseif col < endPlaceholder let changedVars += 1 endif endif endfor let pos[1] += changeLen * changed " Parse variables within placeholders, e.g., "${1:foo} ${2:$1bar}" let pos[2] += changeLen * changedVars " Do the same to any placeholders in the other tab stops. if exists('pos[3]') for nPos in pos[3] let changed = nPos[0] == curLine && nPos[1] > self.start_col for [lnum, col] in self.old_vars if lnum > nPos[0] | break | endif if nPos[0] == lnum && nPos[1] > col let changed += 1 endif endfor let nPos[1] += changeLen * changed endfor endif endfor endif endfunction " Select the placeholder for the current tab stop function! s:state_proto.select_word() let len = self.cur_stop[2] if !len | return '' | endif let l = col('.') != 1 ? 'l' : '' if &sel == 'exclusive' return "\".l.'v'.len."l\" endif return len == 1 ? "\".l.'gh' : "\".l.'v'.(len - 1)."l\" endfunction " Update the snippet as text is typed. The self.update_vars() function does " the actual work. " If the cursor moves outside of a placeholder, call self.remove() function! s:state_proto.update_changes() let change_len = col('$') - self.prev_len let self.end_col += change_len let col = col('.') if line('.') != self.cur_stop[0] || col < self.start_col || col > self.end_col call self.remove() elseif self.has_vars call self.update_vars(change_len) endif let self.prev_len = col('$') endfunction " Actually update the vars for any changed text function! s:state_proto.update_vars(change) let newWordLen = self.end_col - self.start_col let newWord = strpart(getline('.'), self.start_col - 1, newWordLen) let changeLen = a:change let curLine = line('.') let oldStartSnip = self.start_col let updateTabStops = changeLen != 0 let i = 0 for [lnum, col] in self.cur_stop[3] if updateTabStops let start = self.start_col if lnum == curLine && col <= start let self.start_col += changeLen let self.end_col += changeLen endif for nPos in self.cur_stop[3][(i):] " This list is in ascending order, so quit if we've gone too far. if nPos[0] > lnum | break | endif if nPos[0] == lnum && nPos[1] > col let nPos[1] += changeLen endif endfor if lnum == curLine && col > start let col += changeLen let self.cur_stop[3][i][1] = col endif let i += 1 endif let theline = getline(lnum) " subtract -1 to go from column byte index to string byte index " subtract another -1 to exclude the col'th element call setline(lnum, theline[0:(col-2)] . newWord . theline[(col+self.end_col-self.start_col-a:change-1):]) endfor " Reposition the cursor in case a var updates on the same line but before " the current tabstop if oldStartSnip != self.start_col call cursor(0, col('.') + self.start_col - oldStartSnip) endif endfunction " should be moved to utils or such? fun! snipMate#SetByPath(dict, path, value) let d = a:dict for p in a:path[:-2] if !has_key(d,p) | let d[p] = {} | endif let d = d[p] endfor let d[a:path[-1]] = a:value endf " reads a .snippets file " returns list of " ['triggername', 'name', 'contents'] " if triggername is not set 'default' is assumed fun! snipMate#ReadSnippetsFile(file) let result = [] let new_scopes = [] if !filereadable(a:file) | return [result, new_scopes] | endif let r_guard = '^guard\s\+\zs.*' let inSnip = 0 let guard = 1 for line in readfile(a:file) + ["\n"] if inSnip == 2 && line =~ r_guard let guard = matchstr(line, r_guard) elseif inSnip && (line[0] == "\t" || line == '') let content .= strpart(line, 1)."\n" continue elseif inSnip call add(result, [trigger, name == '' ? 'default' : name, content[:-2], guard]) let inSnip = 0 let guard = "1" endif if inSnip == 2 let inSnip = 1 endif if line[:6] == 'snippet' " 2 signals first line let inSnip = 2 let trigger = strpart(line, 8) let name = '' let space = stridx(trigger, ' ') + 1 if space " Process multi snip let name = strpart(trigger, space) let trigger = strpart(trigger, 0, space - 1) endif let content = '' elseif line[:6] == 'extends' call extend(new_scopes, map(split(strpart(line, 8)), \ "substitute(v:val, ',*$', '', '')")) endif endfor return [result, new_scopes] endf " adds scope aliases to list. " returns new list " the aliases of aliases are added recursively fun! s:AddScopeAliases(list) let did = {} let scope_aliases = get(s:c,'scope_aliases', {}) let new = a:list let new2 = [] while !empty(new) for i in new if !has_key(did, i) let did[i] = 1 call extend(new2, split(get(scope_aliases,i,''),',')) endif endfor let new = new2 let new2 = [] endwhile return keys(did) endf function! s:Glob(path, expr) let res = [] for p in split(a:path, ',') let h = fnamemodify(a:expr, ':h') if isdirectory(p . '/' . h) call extend(res, split(glob(p . '/' . a:expr), "\n")) endif endfor return filter(res, 'filereadable(v:val)') endfunction " returns dict of " { path: { 'type': one of 'snippet' 'snippets', " 'exists': 1 or 0 " " for single snippet files: " 'name': name of snippet " 'trigger': trigger of snippet " } " } " use trigger = '*' to match all snippet files " use mustExist = 1 to return existing files only " " mustExist = 0 is used by OpenSnippetFiles function! snipMate#GetSnippetFiles(mustExist, scopes, trigger) let paths = join(funcref#Call(s:c.snippet_dirs), ',') let result = {} let scopes = s:AddScopeAliases(a:scopes) let trigger = escape(a:trigger, "*[]?{}`'$") " collect existing files for scope in scopes for f in s:Glob(paths, 'snippets/' . scope . '.snippets') + \ s:Glob(paths, 'snippets/' . scope . '/*.snippets') let result[f] = { 'exists' : 1, 'type' : 'snippets', \ 'name_prefix' : fnamemodify(f, ':t:r') } endfor for f in s:Glob(paths, 'snippets/'.scope.'/'.trigger.'.snippet') let result[f] = {'exists': 1, 'type': 'snippet', 'name': 'default', \ 'trigger': a:trigger, 'name_prefix' : scope } endfor for f in s:Glob(paths, 'snippets/'.scope.'/'.trigger.'/*.snippet') let result[f] = {'exists': 1, 'type': 'snippet', 'name' : fnamemodify(f, ':t:r'), \ 'trigger': a:trigger, 'name_prefix' : scope } endfor if !a:mustExist for p in split(paths, ',') let p .= '/snippets/' . scope . '.snippets' let result[p] = get(result, p, {'exists': 0, 'type': 'snippets'}) endfor endif endfor return result endfunction fun! snipMate#EvalGuard(guard) " left: everything left of expansion " word: the expanded word " are guaranteed to be in scpe if a:guard == '1' | return 1 | endif let word = s:c.word " eval is evil, but backticks are allowed anyway. let left = getline('.')[:col('.')-3 - len(word)] exec 'return '.a:guard endf " default triggers based on paths fun! snipMate#DefaultPool(scopes, trigger, result) let triggerR = substitute(a:trigger,'*','.*','g') let extra_scopes = [] for [f,opts] in items(snipMate#GetSnippetFiles(1, a:scopes, a:trigger)) let opts.name_prefix = matchstr(f, '\v[^/]+\ze/snippets') . ' ' . opts.name_prefix if opts.type == 'snippets' let [snippets, extension] = cached_file_contents#CachedFileContents(f, s:c.read_snippets_cached, 0) for [trigger, name, contents, guard] in snippets if trigger !~ escape(triggerR,'~') | continue | endif if snipMate#EvalGuard(guard) call snipMate#SetByPath(a:result, [trigger, opts.name_prefix.' '.name], contents) endif endfor call extend(extra_scopes, extension) elseif opts.type == 'snippet' call snipMate#SetByPath(a:result, [opts.trigger, opts.name_prefix.' '.opts.name], funcref#Function('return readfile('.string(f).')')) else throw "unexpected" endif endfor if !empty(extra_scopes) call snipMate#DefaultPool(extra_scopes, a:trigger, a:result) endif endf " return a dict of snippets found in runtimepath matching trigger " scopes: list of scopes. usually this is the filetype. eg ['c','cpp'] " trigger may contain glob patterns. Thus use '*' to get all triggers " fun! snipMate#GetSnippets(scopes, trigger) let result = {} let triggerR = escape(substitute(a:trigger,'*','.*','g'), '~') " escape '~' for use as regexp " let scopes = s:AddScopeAliases(a:scopes) for F in values(g:snipMateSources) call funcref#Call(F, [a:scopes, a:trigger, result]) endfor return result endf " adds leading tab " and replaces leading spaces by tabs " see ftplugin/snippet.vim fun! snipMate#RetabSnip() range let leadingTab = expand('%:e') == 'snippets' let lines = getline(a:firstline, a:lastline) " remove leading "\t" let allIndented = 1 for l in lines if l[0] != '\t' | let allIndented = 0 | endif endfor " retab if allIndented call map(lines, 'v:val[1:]') endif let leadingSp = filter(map(copy(lines),'matchstr(v:val,"^\\s*") '),'v:val !=""') if !empty(leadingSp) " lines containing leading spaces found let smallestInd = len(sort(leadingSp)[-1]) let ind = input('retab, spaces per tab: ', smallestInd) for i in range(0, len(lines)-1) let ml = matchlist(lines[i], '^\(\s*\)\(.*\)') let lines[i] = repeat("\t", len(ml[1]) / ind) \ . repeat( " ", len(ml[1]) % ind) \ . ml[2] endfor endif " readd tab let tab = leadingTab ? "\t" : "" for i in range(0,len(lines)-1) call setline(a:firstline + i, tab.lines[i]) endfor endf fun! snipMate#OpenSnippetFiles() let dict = snipMate#GetSnippetFiles(0, snipMate#ScopesByFile(), '*') " sort by files wether they exist - put existing files first let exists = [] let notExists = [] for [file, v] in items(dict) let v['file'] = file if v['exists'] call add(exists, v) else call add(notExists, v) endif endfor let all = exists + notExists let show = map(copy(all),'(v:val["exists"] ? "exists:" : "does not exist yet:")." ".v:val["file"]') let select = tlib#input#List('mi', 'select files to be opened in splits', show) for idx in select exec 'sp '.all[idx - 1]['file'] endfor endf fun! snipMate#ScopesByFile() " duplicates are removed in AddScopeAliases return filter(funcref#Call(s:c.get_scopes), "v:val != ''") endf " used by both: completion and insert snippet fun! snipMate#GetSnippetsForWordBelowCursor(word, suffix, break_on_first_match) " Setup lookups: '1.2.3' becomes [1.2.3] + [3, 2.3] let parts = split(a:word, '\W\zs') if len(parts) > 2 let parts = parts[-2:] " max 2 additional items, this might become a setting endif let lookups = [a:word.a:suffix] let lookup = '' for w in reverse(parts) let lookup = w . lookup if index(lookups, lookup) == -1 call add(lookups, lookup.a:suffix) endif endfor " allow matching '.' if a:word =~ '\.$' call add(lookups, '.'.a:suffix) endif call filter(lookups, 'v:val != ""') " echo lookups let matching_snippets = [] let snippet = '' " prefer longest word for word in lookups let s:c.word = word " echomsg string(lookups).' current: '.word for [k,snippetD] in items(funcref#Call(s:c['get_snippets'], [snipMate#ScopesByFile(), word])) if a:suffix == '' " hack: require exact match if k !=# word | continue | endif endif call add(matching_snippets, [k, snippetD]) if a:break_on_first_match | break| endif endfor endfor return matching_snippets endf " snippets: dict containing snippets by name " usually this is just {'default' : snippet_contents } fun! s:ChooseSnippet(snippets) let snippet = [] let keys = keys(a:snippets) let i = 1 for snip in keys let snippet += [i.'. '.snip] let i += 1 endfor if len(snippet) == 1 " there's only a single snippet, choose it let idx = 0 else let idx = tlib#input#List('si','select snippet by name',snippet) -1 if idx == -1 return '' endif endif " if a:snippets[..] is a String Call returns it " If it's a function or a function string the result is returned return funcref#Call(a:snippets[keys(a:snippets)[idx]]) endf fun! snipMate#ShowAvailableSnips() let col = col('.') let word = matchstr(getline('.'), '\S\+\%'.col.'c') let snippets = map(snipMate#GetSnippetsForWordBelowCursor(word, '*', 0),'v:val[0]') let matches = filter(snippets, "v:val =~# '\\V\\^" . escape(word, '\') . "'") " Pretty hacky, but really can't have the tab swallowed! if len(matches) == 0 call feedkeys(s:c['no_match_completion_feedkeys_chars'], 'n') return "" endif call complete(col - len(word), sort(matches)) return '' endf " user interface implementation {{{1 fun! snipMate#TriggerSnippet() if exists('g:SuperTabMappingForward') if g:SuperTabMappingForward == "" let SuperTabPlug = maparg('SuperTabForward', 'i') if SuperTabPlug == "" let SuperTabKey = "\" else exec "let SuperTabKey = \"" . escape(SuperTabPlug, '<') . "\"" endif elseif g:SuperTabMappingBackward == "" let SuperTabPlug = maparg('SuperTabBackward', 'i') if SuperTabPlug == "" let SuperTabKey = "\" else exec "let SuperTabKey = \"" . escape(SuperTabPlug, '<') . "\"" endif endif endif if pumvisible() " Update snippet if completion is used, or deal with supertab if exists('SuperTabKey') call feedkeys(SuperTabKey) | return '' endif call feedkeys("\a", 'n') " Close completion menu call feedkeys("\") | return '' endif if exists('b:snip_state') let jump = b:snip_state.jump_stop(0) if type(jump) == 1 " returned a string return jump endif endif let word = matchstr(getline('.'), '\S\+\%'.col('.').'c') let list = snipMate#GetSnippetsForWordBelowCursor(word, '', 1) if empty(list) let snippet = '' else let [trigger, snippetD] = list[0] let s = s:ChooseSnippet(snippetD) if type(s) == type([]) let snippet = join(s, "\n") else let snippet = s end " Before expanding snippet, create new undo point |i_CTRL-G| let &undolevels = &undolevels let col = col('.') - len(trigger) sil exe 's/\V'.escape(trigger, '/\.').'\%#//' return snipMate#expandSnip(snippet, col) endif " should allow other plugins to register hooks instead (duplicate code) if exists('SuperTabKey') call feedkeys(SuperTabKey) return '' endif return word == '' \ ? "\" \ : "\=snipMate#ShowAvailableSnips()\" endf fun! snipMate#BackwardsSnippet() if exists('b:snip_state') | return b:snip_state.jump_stop(1) | endif if exists('g:SuperTabMappingForward') if g:SuperTabMappingForward == "" let SuperTabPlug = maparg('SuperTabForward', 'i') if SuperTabPlug == "" let SuperTabKey = "\" else exec "let SuperTabKey = \"" . escape(SuperTabPlug, '<') . "\"" endif elseif g:SuperTabMappingBackward == "" let SuperTabPlug = maparg('SuperTabBackward', 'i') if SuperTabPlug == "" let SuperTabKey = "\" else exec "let SuperTabKey = \"" . escape(SuperTabPlug, '<') . "\"" endif endif endif " should allow other plugins to register hooks instead (duplicate code) if exists('SuperTabKey') call feedkeys(SuperTabKey) return '' endif return "\" endf " vim:noet:sw=4:ts=4:ft=vim