1
0
Fork 0
mirror of synced 2024-12-26 00:33:20 -05:00
ultimate-vim/autoload/pathogen.vim

265 lines
8.6 KiB
VimL
Raw Normal View History

2012-05-29 12:21:32 -04:00
" pathogen.vim - path option manipulation
" Maintainer: Tim Pope <http://tpo.pe/>
2022-05-19 08:37:15 -04:00
" Version: 2.4
2012-05-29 12:21:32 -04:00
" Install in ~/.vim/autoload (or ~\vimfiles\autoload).
"
" For management of individually installed plugins in ~/.vim/bundle (or
2014-02-08 05:14:01 -05:00
" ~\vimfiles\bundle), adding `execute pathogen#infect()` to the top of your
" .vimrc is the only other setup necessary.
2012-05-29 12:21:32 -04:00
"
2014-09-27 11:32:18 -04:00
" The API is documented inline below.
2012-05-29 12:21:32 -04:00
if exists("g:loaded_pathogen") || &cp
finish
endif
let g:loaded_pathogen = 1
2014-02-08 05:14:01 -05:00
" Point of entry for basic default usage. Give a relative path to invoke
2022-05-19 08:37:15 -04:00
" pathogen#interpose() or an absolute path to invoke pathogen#surround().
" Curly braces are expanded with pathogen#expand(): "bundle/{}" finds all
" subdirectories inside "bundle" inside all directories in the runtime path.
" If no arguments are given, defaults "bundle/{}", and also "pack/{}/start/{}"
" on versions of Vim without native package support.
2014-09-27 11:32:18 -04:00
function! pathogen#infect(...) abort
2022-05-19 08:37:15 -04:00
if a:0
let paths = filter(reverse(copy(a:000)), 'type(v:val) == type("")')
else
let paths = ['bundle/{}', 'pack/{}/start/{}']
endif
if has('packages')
call filter(paths, 'v:val !~# "^pack/[^/]*/start/[^/]*$"')
endif
let static = '^\%([$~\\/]\|\w:[\\/]\)[^{}*]*$'
for path in filter(copy(paths), 'v:val =~# static')
call pathogen#surround(path)
endfor
for path in filter(copy(paths), 'v:val !~# static')
if path =~# '^\%([$~\\/]\|\w:[\\/]\)'
2014-02-08 05:14:01 -05:00
call pathogen#surround(path)
2014-09-27 11:32:18 -04:00
else
2022-05-19 08:37:15 -04:00
call pathogen#interpose(path)
2014-02-08 05:14:01 -05:00
endif
endfor
2012-05-29 12:21:32 -04:00
call pathogen#cycle_filetype()
2014-09-27 11:32:18 -04:00
if pathogen#is_disabled($MYVIMRC)
return 'finish'
endif
2014-02-08 05:14:01 -05:00
return ''
2014-09-27 11:32:18 -04:00
endfunction
2012-05-29 12:21:32 -04:00
" Split a path into a list.
2014-09-27 11:32:18 -04:00
function! pathogen#split(path) abort
2012-05-29 12:21:32 -04:00
if type(a:path) == type([]) | return a:path | endif
2014-09-27 11:32:18 -04:00
if empty(a:path) | return [] | endif
2012-05-29 12:21:32 -04:00
let split = split(a:path,'\\\@<!\%(\\\\\)*\zs,')
return map(split,'substitute(v:val,''\\\([\\,]\)'',''\1'',"g")')
2014-09-27 11:32:18 -04:00
endfunction
2012-05-29 12:21:32 -04:00
" Convert a list to a path.
2014-09-27 11:32:18 -04:00
function! pathogen#join(...) abort
2012-05-29 12:21:32 -04:00
if type(a:1) == type(1) && a:1
let i = 1
let space = ' '
else
let i = 0
let space = ''
endif
let path = ""
while i < a:0
if type(a:000[i]) == type([])
let list = a:000[i]
let j = 0
while j < len(list)
let escaped = substitute(list[j],'[,'.space.']\|\\[\,'.space.']\@=','\\&','g')
let path .= ',' . escaped
let j += 1
endwhile
else
let path .= "," . a:000[i]
endif
let i += 1
endwhile
return substitute(path,'^,','','')
2014-09-27 11:32:18 -04:00
endfunction
2012-05-29 12:21:32 -04:00
" Convert a list to a path with escaped spaces for 'path', 'tag', etc.
2014-09-27 11:32:18 -04:00
function! pathogen#legacyjoin(...) abort
2012-05-29 12:21:32 -04:00
return call('pathogen#join',[1] + a:000)
2014-09-27 11:32:18 -04:00
endfunction
2012-05-29 12:21:32 -04:00
" Turn filetype detection off and back on again if it was already enabled.
2014-09-27 11:32:18 -04:00
function! pathogen#cycle_filetype() abort
2012-05-29 12:21:32 -04:00
if exists('g:did_load_filetypes')
filetype off
filetype on
endif
2014-09-27 11:32:18 -04:00
endfunction
2012-05-29 12:21:32 -04:00
2014-09-27 11:32:18 -04:00
" Check if a bundle is disabled. A bundle is considered disabled if its
2022-05-19 08:37:15 -04:00
" basename or full name is included in the list g:pathogen_blacklist or the
" comma delimited environment variable $VIMBLACKLIST.
2014-09-27 11:32:18 -04:00
function! pathogen#is_disabled(path) abort
2012-05-29 12:21:32 -04:00
if a:path =~# '\~$'
return 1
endif
2014-09-27 11:32:18 -04:00
let sep = pathogen#slash()
2022-05-19 08:37:15 -04:00
let blacklist = get(g:, 'pathogen_blacklist', get(g:, 'pathogen_disabled', [])) + pathogen#split($VIMBLACKLIST)
if !empty(blacklist)
call map(blacklist, 'substitute(v:val, "[\\/]$", "", "")')
endif
2014-09-27 11:32:18 -04:00
return index(blacklist, fnamemodify(a:path, ':t')) != -1 || index(blacklist, a:path) != -1
2022-05-19 08:37:15 -04:00
endfunction
2012-05-29 12:21:32 -04:00
2014-02-08 05:14:01 -05:00
" Prepend the given directory to the runtime path and append its corresponding
2014-09-27 11:32:18 -04:00
" after directory. Curly braces are expanded with pathogen#expand().
function! pathogen#surround(path) abort
let sep = pathogen#slash()
2012-05-29 12:21:32 -04:00
let rtp = pathogen#split(&rtp)
2022-05-19 08:37:15 -04:00
let path = fnamemodify(a:path, ':s?[\\/]\=$??')
2014-09-27 11:32:18 -04:00
let before = filter(pathogen#expand(path), '!pathogen#is_disabled(v:val)')
2022-05-19 08:37:15 -04:00
let after = filter(reverse(pathogen#expand(path, sep.'after')), '!pathogen#is_disabled(v:val[0 : -7])')
2014-09-27 11:32:18 -04:00
call filter(rtp, 'index(before + after, v:val) == -1')
2014-02-08 05:14:01 -05:00
let &rtp = pathogen#join(before, rtp, after)
2012-05-29 12:21:32 -04:00
return &rtp
2014-09-27 11:32:18 -04:00
endfunction
2014-02-08 05:14:01 -05:00
" For each directory in the runtime path, add a second entry with the given
2014-09-27 11:32:18 -04:00
" argument appended. Curly braces are expanded with pathogen#expand().
function! pathogen#interpose(name) abort
let sep = pathogen#slash()
let name = a:name
if has_key(s:done_bundles, name)
2012-05-29 12:21:32 -04:00
return ""
endif
2014-09-27 11:32:18 -04:00
let s:done_bundles[name] = 1
2012-05-29 12:21:32 -04:00
let list = []
for dir in pathogen#split(&rtp)
if dir =~# '\<after$'
2022-05-19 08:37:15 -04:00
let list += reverse(filter(pathogen#expand(dir[0 : -6].name, sep.'after'), '!pathogen#is_disabled(v:val[0 : -7])')) + [dir]
2012-05-29 12:21:32 -04:00
else
2014-09-27 11:32:18 -04:00
let list += [dir] + filter(pathogen#expand(dir.sep.name), '!pathogen#is_disabled(v:val)')
2012-05-29 12:21:32 -04:00
endif
endfor
let &rtp = pathogen#join(pathogen#uniq(list))
return 1
endfunction
2014-09-27 11:32:18 -04:00
let s:done_bundles = {}
2012-05-29 12:21:32 -04:00
" Invoke :helptags on all non-$VIM doc directories in runtimepath.
2014-09-27 11:32:18 -04:00
function! pathogen#helptags() abort
let sep = pathogen#slash()
2014-02-08 05:14:01 -05:00
for glob in pathogen#split(&rtp)
2014-09-27 11:32:18 -04:00
for dir in map(split(glob(glob), "\n"), 'v:val.sep."/doc/".sep')
if (dir)[0 : strlen($VIMRUNTIME)] !=# $VIMRUNTIME.sep && filewritable(dir) == 2 && !empty(split(glob(dir.'*.txt'))) && (!filereadable(dir.'tags') || filewritable(dir.'tags'))
silent! execute 'helptags' pathogen#fnameescape(dir)
2014-02-08 05:14:01 -05:00
endif
endfor
2012-05-29 12:21:32 -04:00
endfor
2014-09-27 11:32:18 -04:00
endfunction
2012-05-29 12:21:32 -04:00
command! -bar Helptags :call pathogen#helptags()
2014-02-08 05:14:01 -05:00
" Execute the given command. This is basically a backdoor for --remote-expr.
2014-09-27 11:32:18 -04:00
function! pathogen#execute(...) abort
2014-02-08 05:14:01 -05:00
for command in a:000
execute command
endfor
return ''
2014-09-27 11:32:18 -04:00
endfunction
" Section: Unofficial
function! pathogen#is_absolute(path) abort
return a:path =~# (has('win32') ? '^\%([\\/]\|\w:\)[\\/]\|^[~$]' : '^[/~$]')
endfunction
" Given a string, returns all possible permutations of comma delimited braced
" alternatives of that string. pathogen#expand('/{a,b}/{c,d}') yields
" ['/a/c', '/a/d', '/b/c', '/b/d']. Empty braces are treated as a wildcard
" and globbed. Actual globs are preserved.
2022-05-19 08:37:15 -04:00
function! pathogen#expand(pattern, ...) abort
let after = a:0 ? a:1 : ''
let pattern = substitute(a:pattern, '^[~$][^\/]*', '\=expand(submatch(0))', '')
if pattern =~# '{[^{}]\+}'
let [pre, pat, post] = split(substitute(pattern, '\(.\{-\}\){\([^{}]\+\)}\(.*\)', "\\1\001\\2\001\\3", ''), "\001", 1)
2014-09-27 11:32:18 -04:00
let found = map(split(pat, ',', 1), 'pre.v:val.post')
let results = []
for pattern in found
call extend(results, pathogen#expand(pattern))
endfor
2022-05-19 08:37:15 -04:00
elseif pattern =~# '{}'
let pat = matchstr(pattern, '^.*{}[^*]*\%($\|[\\/]\)')
let post = pattern[strlen(pat) : -1]
let results = map(split(glob(substitute(pat, '{}', '*', 'g')), "\n"), 'v:val.post')
2014-09-27 11:32:18 -04:00
else
2022-05-19 08:37:15 -04:00
let results = [pattern]
2014-09-27 11:32:18 -04:00
endif
2022-05-19 08:37:15 -04:00
let vf = pathogen#slash() . 'vimfiles'
call map(results, 'v:val =~# "\\*" ? v:val.after : isdirectory(v:val.vf.after) ? v:val.vf.after : isdirectory(v:val.after) ? v:val.after : ""')
return filter(results, '!empty(v:val)')
2014-09-27 11:32:18 -04:00
endfunction
" \ on Windows unless shellslash is set, / everywhere else.
function! pathogen#slash() abort
return !exists("+shellslash") || &shellslash ? '/' : '\'
endfunction
function! pathogen#separator() abort
return pathogen#slash()
endfunction
" Convenience wrapper around glob() which returns a list.
function! pathogen#glob(pattern) abort
let files = split(glob(a:pattern),"\n")
return map(files,'substitute(v:val,"[".pathogen#slash()."/]$","","")')
2022-05-19 08:37:15 -04:00
endfunction
2014-09-27 11:32:18 -04:00
" Like pathogen#glob(), only limit the results to directories.
function! pathogen#glob_directories(pattern) abort
return filter(pathogen#glob(a:pattern),'isdirectory(v:val)')
2022-05-19 08:37:15 -04:00
endfunction
2014-09-27 11:32:18 -04:00
" Remove duplicates from a list.
function! pathogen#uniq(list) abort
let i = 0
let seen = {}
while i < len(a:list)
if (a:list[i] ==# '' && exists('empty')) || has_key(seen,a:list[i])
call remove(a:list,i)
elseif a:list[i] ==# ''
let i += 1
let empty = 1
else
let seen[a:list[i]] = 1
let i += 1
endif
endwhile
return a:list
endfunction
" Backport of fnameescape().
function! pathogen#fnameescape(string) abort
if exists('*fnameescape')
return fnameescape(a:string)
elseif a:string ==# '-'
return '\-'
else
return substitute(escape(a:string," \t\n*?[{`$\\%#'\"|!<"),'^[+>]','\\&','')
endif
endfunction
2014-02-08 05:14:01 -05:00
2012-05-29 12:21:32 -04:00
" Like findfile(), but hardcoded to use the runtimepath.
2022-05-19 08:37:15 -04:00
function! pathogen#runtime_findfile(file,count) abort
2012-05-29 12:21:32 -04:00
let rtp = pathogen#join(1,pathogen#split(&rtp))
2014-02-08 05:14:01 -05:00
let file = findfile(a:file,rtp,a:count)
if file ==# ''
return ''
else
return fnamemodify(file,':p')
endif
2014-09-27 11:32:18 -04:00
endfunction
2012-05-29 12:21:32 -04:00
2014-09-27 11:32:18 -04:00
" vim:set et sw=2 foldmethod=expr foldexpr=getline(v\:lnum)=~'^\"\ Section\:'?'>1'\:getline(v\:lnum)=~#'^fu'?'a1'\:getline(v\:lnum)=~#'^endf'?'s1'\:'=':