425
|
1 " pathogen.vim - path option manipulation
|
|
2 " Maintainer: Tim Pope <http://tpo.pe/>
|
569
|
3 " Version: 2.3
|
425
|
4
|
|
5 " Install in ~/.vim/autoload (or ~\vimfiles\autoload).
|
|
6 "
|
|
7 " For management of individually installed plugins in ~/.vim/bundle (or
|
569
|
8 " ~\vimfiles\bundle), adding `execute pathogen#infect()` to the top of your
|
425
|
9 " .vimrc is the only other setup necessary.
|
|
10 "
|
569
|
11 " The API is documented inline below.
|
425
|
12
|
|
13 if exists("g:loaded_pathogen") || &cp
|
|
14 finish
|
|
15 endif
|
|
16 let g:loaded_pathogen = 1
|
|
17
|
569
|
18 " Point of entry for basic default usage. Give a relative path to invoke
|
|
19 " pathogen#interpose() (defaults to "bundle/{}"), or an absolute path to invoke
|
|
20 " pathogen#surround(). Curly braces are expanded with pathogen#expand():
|
|
21 " "bundle/{}" finds all subdirectories inside "bundle" inside all directories
|
|
22 " in the runtime path.
|
|
23 function! pathogen#infect(...) abort
|
|
24 for path in a:0 ? filter(reverse(copy(a:000)), 'type(v:val) == type("")') : ['bundle/{}']
|
|
25 if path =~# '^\%({\=[$~\\/]\|{\=\w:[\\/]\).*[{}*]'
|
|
26 call pathogen#surround(path)
|
|
27 elseif path =~# '^\%([$~\\/]\|\w:[\\/]\)'
|
|
28 call s:warn('Change pathogen#infect('.string(path).') to pathogen#infect('.string(path.'/{}').')')
|
|
29 call pathogen#surround(path . '/{}')
|
|
30 elseif path =~# '[{}*]'
|
|
31 call pathogen#interpose(path)
|
|
32 else
|
|
33 call s:warn('Change pathogen#infect('.string(path).') to pathogen#infect('.string(path.'/{}').')')
|
|
34 call pathogen#interpose(path . '/{}')
|
|
35 endif
|
|
36 endfor
|
|
37 call pathogen#cycle_filetype()
|
|
38 if pathogen#is_disabled($MYVIMRC)
|
|
39 return 'finish'
|
425
|
40 endif
|
569
|
41 return ''
|
|
42 endfunction
|
425
|
43
|
|
44 " Split a path into a list.
|
569
|
45 function! pathogen#split(path) abort
|
425
|
46 if type(a:path) == type([]) | return a:path | endif
|
569
|
47 if empty(a:path) | return [] | endif
|
425
|
48 let split = split(a:path,'\\\@<!\%(\\\\\)*\zs,')
|
|
49 return map(split,'substitute(v:val,''\\\([\\,]\)'',''\1'',"g")')
|
569
|
50 endfunction
|
425
|
51
|
|
52 " Convert a list to a path.
|
569
|
53 function! pathogen#join(...) abort
|
425
|
54 if type(a:1) == type(1) && a:1
|
|
55 let i = 1
|
|
56 let space = ' '
|
|
57 else
|
|
58 let i = 0
|
|
59 let space = ''
|
|
60 endif
|
|
61 let path = ""
|
|
62 while i < a:0
|
|
63 if type(a:000[i]) == type([])
|
|
64 let list = a:000[i]
|
|
65 let j = 0
|
|
66 while j < len(list)
|
|
67 let escaped = substitute(list[j],'[,'.space.']\|\\[\,'.space.']\@=','\\&','g')
|
|
68 let path .= ',' . escaped
|
|
69 let j += 1
|
|
70 endwhile
|
|
71 else
|
|
72 let path .= "," . a:000[i]
|
|
73 endif
|
|
74 let i += 1
|
|
75 endwhile
|
|
76 return substitute(path,'^,','','')
|
569
|
77 endfunction
|
425
|
78
|
|
79 " Convert a list to a path with escaped spaces for 'path', 'tag', etc.
|
569
|
80 function! pathogen#legacyjoin(...) abort
|
425
|
81 return call('pathogen#join',[1] + a:000)
|
569
|
82 endfunction
|
|
83
|
|
84 " Turn filetype detection off and back on again if it was already enabled.
|
|
85 function! pathogen#cycle_filetype() abort
|
|
86 if exists('g:did_load_filetypes')
|
|
87 filetype off
|
|
88 filetype on
|
|
89 endif
|
|
90 endfunction
|
|
91
|
|
92 " Check if a bundle is disabled. A bundle is considered disabled if its
|
|
93 " basename or full name is included in the list g:pathogen_disabled.
|
|
94 function! pathogen#is_disabled(path) abort
|
|
95 if a:path =~# '\~$'
|
|
96 return 1
|
|
97 endif
|
|
98 let sep = pathogen#slash()
|
|
99 let blacklist = map(
|
|
100 \ get(g:, 'pathogen_blacklist', get(g:, 'pathogen_disabled', [])) +
|
|
101 \ pathogen#split($VIMBLACKLIST),
|
|
102 \ 'substitute(v:val, "[\\/]$", "", "")')
|
|
103 return index(blacklist, fnamemodify(a:path, ':t')) != -1 || index(blacklist, a:path) != -1
|
|
104 endfunction "}}}1
|
|
105
|
|
106 " Prepend the given directory to the runtime path and append its corresponding
|
|
107 " after directory. Curly braces are expanded with pathogen#expand().
|
|
108 function! pathogen#surround(path) abort
|
|
109 let sep = pathogen#slash()
|
|
110 let rtp = pathogen#split(&rtp)
|
|
111 let path = fnamemodify(a:path, ':p:?[\\/]\=$??')
|
|
112 let before = filter(pathogen#expand(path), '!pathogen#is_disabled(v:val)')
|
|
113 let after = filter(reverse(pathogen#expand(path.sep.'after')), '!pathogen#is_disabled(v:val[0:-7])')
|
|
114 call filter(rtp, 'index(before + after, v:val) == -1')
|
|
115 let &rtp = pathogen#join(before, rtp, after)
|
|
116 return &rtp
|
|
117 endfunction
|
|
118
|
|
119 " For each directory in the runtime path, add a second entry with the given
|
|
120 " argument appended. Curly braces are expanded with pathogen#expand().
|
|
121 function! pathogen#interpose(name) abort
|
|
122 let sep = pathogen#slash()
|
|
123 let name = a:name
|
|
124 if has_key(s:done_bundles, name)
|
|
125 return ""
|
|
126 endif
|
|
127 let s:done_bundles[name] = 1
|
|
128 let list = []
|
|
129 for dir in pathogen#split(&rtp)
|
|
130 if dir =~# '\<after$'
|
|
131 let list += reverse(filter(pathogen#expand(dir[0:-6].name.sep.'after'), '!pathogen#is_disabled(v:val[0:-7])')) + [dir]
|
|
132 else
|
|
133 let list += [dir] + filter(pathogen#expand(dir.sep.name), '!pathogen#is_disabled(v:val)')
|
|
134 endif
|
|
135 endfor
|
|
136 let &rtp = pathogen#join(pathogen#uniq(list))
|
|
137 return 1
|
|
138 endfunction
|
|
139
|
|
140 let s:done_bundles = {}
|
|
141
|
|
142 " Invoke :helptags on all non-$VIM doc directories in runtimepath.
|
|
143 function! pathogen#helptags() abort
|
|
144 let sep = pathogen#slash()
|
|
145 for glob in pathogen#split(&rtp)
|
|
146 for dir in map(split(glob(glob), "\n"), 'v:val.sep."/doc/".sep')
|
|
147 if (dir)[0 : strlen($VIMRUNTIME)] !=# $VIMRUNTIME.sep && filewritable(dir) == 2 && !empty(split(glob(dir.'*.txt'))) && (!filereadable(dir.'tags') || filewritable(dir.'tags'))
|
|
148 silent! execute 'helptags' pathogen#fnameescape(dir)
|
|
149 endif
|
|
150 endfor
|
|
151 endfor
|
|
152 endfunction
|
|
153
|
|
154 command! -bar Helptags :call pathogen#helptags()
|
|
155
|
|
156 " Execute the given command. This is basically a backdoor for --remote-expr.
|
|
157 function! pathogen#execute(...) abort
|
|
158 for command in a:000
|
|
159 execute command
|
|
160 endfor
|
|
161 return ''
|
|
162 endfunction
|
|
163
|
|
164 " Section: Unofficial
|
|
165
|
|
166 function! pathogen#is_absolute(path) abort
|
|
167 return a:path =~# (has('win32') ? '^\%([\\/]\|\w:\)[\\/]\|^[~$]' : '^[/~$]')
|
|
168 endfunction
|
|
169
|
|
170 " Given a string, returns all possible permutations of comma delimited braced
|
|
171 " alternatives of that string. pathogen#expand('/{a,b}/{c,d}') yields
|
|
172 " ['/a/c', '/a/d', '/b/c', '/b/d']. Empty braces are treated as a wildcard
|
|
173 " and globbed. Actual globs are preserved.
|
|
174 function! pathogen#expand(pattern) abort
|
|
175 if a:pattern =~# '{[^{}]\+}'
|
|
176 let [pre, pat, post] = split(substitute(a:pattern, '\(.\{-\}\){\([^{}]\+\)}\(.*\)', "\\1\001\\2\001\\3", ''), "\001", 1)
|
|
177 let found = map(split(pat, ',', 1), 'pre.v:val.post')
|
|
178 let results = []
|
|
179 for pattern in found
|
|
180 call extend(results, pathogen#expand(pattern))
|
|
181 endfor
|
|
182 return results
|
|
183 elseif a:pattern =~# '{}'
|
|
184 let pat = matchstr(a:pattern, '^.*{}[^*]*\%($\|[\\/]\)')
|
|
185 let post = a:pattern[strlen(pat) : -1]
|
|
186 return map(split(glob(substitute(pat, '{}', '*', 'g')), "\n"), 'v:val.post')
|
|
187 else
|
|
188 return [a:pattern]
|
|
189 endif
|
|
190 endfunction
|
|
191
|
|
192 " \ on Windows unless shellslash is set, / everywhere else.
|
|
193 function! pathogen#slash() abort
|
|
194 return !exists("+shellslash") || &shellslash ? '/' : '\'
|
|
195 endfunction
|
|
196
|
|
197 function! pathogen#separator() abort
|
|
198 return pathogen#slash()
|
|
199 endfunction
|
|
200
|
|
201 " Convenience wrapper around glob() which returns a list.
|
|
202 function! pathogen#glob(pattern) abort
|
|
203 let files = split(glob(a:pattern),"\n")
|
|
204 return map(files,'substitute(v:val,"[".pathogen#slash()."/]$","","")')
|
|
205 endfunction "}}}1
|
|
206
|
|
207 " Like pathogen#glob(), only limit the results to directories.
|
|
208 function! pathogen#glob_directories(pattern) abort
|
|
209 return filter(pathogen#glob(a:pattern),'isdirectory(v:val)')
|
|
210 endfunction "}}}1
|
425
|
211
|
|
212 " Remove duplicates from a list.
|
569
|
213 function! pathogen#uniq(list) abort
|
425
|
214 let i = 0
|
|
215 let seen = {}
|
|
216 while i < len(a:list)
|
|
217 if (a:list[i] ==# '' && exists('empty')) || has_key(seen,a:list[i])
|
|
218 call remove(a:list,i)
|
|
219 elseif a:list[i] ==# ''
|
|
220 let i += 1
|
|
221 let empty = 1
|
|
222 else
|
|
223 let seen[a:list[i]] = 1
|
|
224 let i += 1
|
|
225 endif
|
|
226 endwhile
|
|
227 return a:list
|
|
228 endfunction
|
|
229
|
569
|
230 " Backport of fnameescape().
|
|
231 function! pathogen#fnameescape(string) abort
|
|
232 if exists('*fnameescape')
|
|
233 return fnameescape(a:string)
|
|
234 elseif a:string ==# '-'
|
|
235 return '\-'
|
|
236 else
|
|
237 return substitute(escape(a:string," \t\n*?[{`$\\%#'\"|!<"),'^[+>]','\\&','')
|
|
238 endif
|
|
239 endfunction
|
425
|
240
|
|
241 " Like findfile(), but hardcoded to use the runtimepath.
|
569
|
242 function! pathogen#runtime_findfile(file,count) abort "{{{1
|
425
|
243 let rtp = pathogen#join(1,pathogen#split(&rtp))
|
|
244 let file = findfile(a:file,rtp,a:count)
|
|
245 if file ==# ''
|
|
246 return ''
|
|
247 else
|
|
248 return fnamemodify(file,':p')
|
|
249 endif
|
569
|
250 endfunction
|
|
251
|
|
252 " Section: Deprecated
|
|
253
|
|
254 function! s:warn(msg) abort
|
|
255 echohl WarningMsg
|
|
256 echomsg a:msg
|
|
257 echohl NONE
|
|
258 endfunction
|
425
|
259
|
569
|
260 " Prepend all subdirectories of path to the rtp, and append all 'after'
|
|
261 " directories in those subdirectories. Deprecated.
|
|
262 function! pathogen#runtime_prepend_subdirectories(path) abort
|
|
263 call s:warn('Change pathogen#runtime_prepend_subdirectories('.string(a:path).') to pathogen#infect('.string(a:path.'/{}').')')
|
|
264 return pathogen#surround(a:path . pathogen#slash() . '{}')
|
|
265 endfunction
|
|
266
|
|
267 function! pathogen#incubate(...) abort
|
|
268 let name = a:0 ? a:1 : 'bundle/{}'
|
|
269 call s:warn('Change pathogen#incubate('.(a:0 ? string(a:1) : '').') to pathogen#infect('.string(name).')')
|
|
270 return pathogen#interpose(name)
|
|
271 endfunction
|
|
272
|
|
273 " Deprecated alias for pathogen#interpose().
|
|
274 function! pathogen#runtime_append_all_bundles(...) abort
|
|
275 if a:0
|
|
276 call s:warn('Change pathogen#runtime_append_all_bundles('.string(a:1).') to pathogen#infect('.string(a:1.'/{}').')')
|
425
|
277 else
|
569
|
278 call s:warn('Change pathogen#runtime_append_all_bundles() to pathogen#infect()')
|
425
|
279 endif
|
569
|
280 return pathogen#interpose(a:0 ? a:1 . '/{}' : 'bundle/{}')
|
|
281 endfunction
|
425
|
282
|
|
283 if exists(':Vedit')
|
|
284 finish
|
|
285 endif
|
|
286
|
569
|
287 let s:vopen_warning = 0
|
|
288
|
|
289 function! s:find(count,cmd,file,lcd)
|
425
|
290 let rtp = pathogen#join(1,pathogen#split(&runtimepath))
|
|
291 let file = pathogen#runtime_findfile(a:file,a:count)
|
|
292 if file ==# ''
|
|
293 return "echoerr 'E345: Can''t find file \"".a:file."\" in runtimepath'"
|
569
|
294 endif
|
|
295 if !s:vopen_warning
|
|
296 let s:vopen_warning = 1
|
|
297 let warning = '|echohl WarningMsg|echo "Install scriptease.vim to continue using :V'.a:cmd.'"|echohl NONE'
|
|
298 else
|
|
299 let warning = ''
|
|
300 endif
|
|
301 if a:lcd
|
425
|
302 let path = file[0:-strlen(a:file)-2]
|
|
303 execute 'lcd `=path`'
|
569
|
304 return a:cmd.' '.pathogen#fnameescape(a:file) . warning
|
425
|
305 else
|
569
|
306 return a:cmd.' '.pathogen#fnameescape(file) . warning
|
425
|
307 endif
|
569
|
308 endfunction
|
425
|
309
|
569
|
310 function! s:Findcomplete(A,L,P)
|
|
311 let sep = pathogen#slash()
|
425
|
312 let cheats = {
|
|
313 \'a': 'autoload',
|
|
314 \'d': 'doc',
|
|
315 \'f': 'ftplugin',
|
|
316 \'i': 'indent',
|
|
317 \'p': 'plugin',
|
|
318 \'s': 'syntax'}
|
|
319 if a:A =~# '^\w[\\/]' && has_key(cheats,a:A[0])
|
|
320 let request = cheats[a:A[0]].a:A[1:-1]
|
|
321 else
|
|
322 let request = a:A
|
|
323 endif
|
|
324 let pattern = substitute(request,'/\|\'.sep,'*'.sep,'g').'*'
|
|
325 let found = {}
|
|
326 for path in pathogen#split(&runtimepath)
|
|
327 let path = expand(path, ':p')
|
|
328 let matches = split(glob(path.sep.pattern),"\n")
|
|
329 call map(matches,'isdirectory(v:val) ? v:val.sep : v:val')
|
|
330 call map(matches,'expand(v:val, ":p")[strlen(path)+1:-1]')
|
|
331 for match in matches
|
|
332 let found[match] = 1
|
|
333 endfor
|
|
334 endfor
|
|
335 return sort(keys(found))
|
569
|
336 endfunction
|
425
|
337
|
|
338 command! -bar -bang -range=1 -nargs=1 -complete=customlist,s:Findcomplete Ve :execute s:find(<count>,'edit<bang>',<q-args>,0)
|
|
339 command! -bar -bang -range=1 -nargs=1 -complete=customlist,s:Findcomplete Vedit :execute s:find(<count>,'edit<bang>',<q-args>,0)
|
|
340 command! -bar -bang -range=1 -nargs=1 -complete=customlist,s:Findcomplete Vopen :execute s:find(<count>,'edit<bang>',<q-args>,1)
|
|
341 command! -bar -bang -range=1 -nargs=1 -complete=customlist,s:Findcomplete Vsplit :execute s:find(<count>,'split',<q-args>,<bang>1)
|
|
342 command! -bar -bang -range=1 -nargs=1 -complete=customlist,s:Findcomplete Vvsplit :execute s:find(<count>,'vsplit',<q-args>,<bang>1)
|
|
343 command! -bar -bang -range=1 -nargs=1 -complete=customlist,s:Findcomplete Vtabedit :execute s:find(<count>,'tabedit',<q-args>,<bang>1)
|
|
344 command! -bar -bang -range=1 -nargs=1 -complete=customlist,s:Findcomplete Vpedit :execute s:find(<count>,'pedit',<q-args>,<bang>1)
|
|
345 command! -bar -bang -range=1 -nargs=1 -complete=customlist,s:Findcomplete Vread :execute s:find(<count>,'read',<q-args>,<bang>1)
|
|
346
|
569
|
347 " vim:set et sw=2 foldmethod=expr foldexpr=getline(v\:lnum)=~'^\"\ Section\:'?'>1'\:getline(v\:lnum)=~#'^fu'?'a1'\:getline(v\:lnum)=~#'^endf'?'s1'\:'=':
|