Wikia

Vim Tips Wiki

Changes: Access Python Help

Edit

Back to page

(Proper shellescape)
 
(One intermediate revision by one user not shown)
Line 16: Line 16:
 
To access Python documentation for the word under the cursor using, this mapping can be used
 
To access Python documentation for the word under the cursor using, this mapping can be used
 
<pre>
 
<pre>
map <buffer> K :execute "!pydoc " . expand("<cword>")<CR>
+
nnoremap <buffer> K :<C-u>execute "!pydoc " . expand("<cword>")<CR>
 
</pre>
 
</pre>
   
 
or for Windows
 
or for Windows
 
<pre>
 
<pre>
map <buffer> K :execute "!C:/<PythonDir>/Lib/pydoc.py " . expand("<cword>")<CR>
+
nnoremap <buffer> K :<C-u>execute "!C:/<PythonDir>/Lib/pydoc.py " . expand("<cword>")<CR>
 
</pre>
 
</pre>
   
 
To keep the documentation open while you continue editing, this mapping can be used instead
 
To keep the documentation open while you continue editing, this mapping can be used instead
 
<pre>
 
<pre>
map <buffer> K :execute "!xterm -e 'pydoc " . expand("<cword>") . "'"<CR>
+
nnoremap <buffer> K :<C-u>execute "!xterm -e 'pydoc " . expand("<cword>") . "'"<CR>
 
</pre>
 
</pre>
   
 
or for Windows
 
or for Windows
 
<pre>
 
<pre>
map <buffer> K :execute "!start cmd /c C:/<PythonDir>/Lib/pydoc.py " . \|
+
nnoremap <buffer> K :<C-u>execute "!start cmd /c C:/<PythonDir>/Lib/pydoc.py " . \|
 
\ expand("<cword>")<CR>
 
\ expand("<cword>")<CR>
 
</pre>
 
</pre>
Line 37: Line 37:
 
These mappings only work for single words. To display the documentation for a method or a class in a module, for example <code>os.popen()</code>, modify the mapping in this way
 
These mappings only work for single words. To display the documentation for a method or a class in a module, for example <code>os.popen()</code>, modify the mapping in this way
 
<pre>
 
<pre>
map <buffer> K :let save_isk = &iskeyword \|
+
nnoremap <buffer> K :<C-u>let save_isk = &iskeyword \|
 
\ set iskeyword+=. \|
 
\ set iskeyword+=. \|
 
\ execute "!pydoc " . expand("<cword>") \|
 
\ execute "!pydoc " . expand("<cword>") \|
Line 63: Line 63:
 
endif
 
endif
   
map <buffer> K :let save_isk = &iskeyword \|
+
nnoremap <buffer> K :<C-u>let save_isk = &iskeyword \|
 
\ set iskeyword+=. \|
 
\ set iskeyword+=. \|
 
\ execute "Pyhelp " . expand("<cword>") \|
 
\ execute "Pyhelp " . expand("<cword>") \|
 
\ let &iskeyword = save_isk<CR>
 
\ let &iskeyword = save_isk<CR>
command! -nargs=1 Pyhelp :call ShowPydoc(<f-args>)
+
command! -nargs=1 -bar Pyhelp :call ShowPydoc(<f-args>)
 
function! ShowPydoc(what)
 
function! ShowPydoc(what)
 
" compose a tempfile path using the argument to the function
 
" compose a tempfile path using the argument to the function
 
let path = $TEMP . '/' . a:what . '.pydoc'
 
let path = $TEMP . '/' . a:what . '.pydoc'
  +
let epath = shellescape(path)
  +
let epydoc_path = shellescape(s:pydoc_path)
  +
let ewhat = shellescape(a:what)
 
" run pydoc on the argument, and redirect the output to the tempfile
 
" run pydoc on the argument, and redirect the output to the tempfile
call system(shellescape(s:pydoc_path . " " . a:what . " > " . path))
+
call system(epydoc_path . " " . ewhat . (stridx(&shellredir, '%s') == -1 ? (&shellredir.epath) : (substitute(&shellredir, '\V\C%s', '\=epath', ''))))
 
" open the tempfile in the preview window
 
" open the tempfile in the preview window
execute "pedit " . path
+
execute "pedit" fnameescape(path)
 
endfunction
 
endfunction
 
</pre>
 
</pre>
Line 88: Line 91:
 
if winnr != -1
 
if winnr != -1
 
" if the buffer is already displayed, switch to that window
 
" if the buffer is already displayed, switch to that window
execute winnr . "wincmd w"
+
execute winnr "wincmd w"
 
else
 
else
 
" otherwise, open the buffer in a split
 
" otherwise, open the buffer in a split
execute "sbuffer " . bufname
+
execute "sbuffer" bufname
 
endif
 
endif
 
else
 
else
 
" create a new buffer, set the nofile buftype and don't display it in the
 
" create a new buffer, set the nofile buftype and don't display it in the
 
" buffer list
 
" buffer list
execute "split " . bufname
+
execute "split" fnameescape(bufname)
 
setlocal buftype=nofile
 
setlocal buftype=nofile
 
setlocal nobuflisted
 
setlocal nobuflisted
 
" read the output from pydoc
 
" read the output from pydoc
execute "r !" . shellescape(s:pydoc_path . " " . a:what)
+
execute "r !" . shellescape(s:pydoc_path, 1) . " " . shellescape(a:what, 1)
 
endif
 
endif
 
" go to the first line of the document
 
" go to the first line of the document

Latest revision as of 07:34, July 14, 2013

Tip 556 Printable Monobook Previous Next

created 2003 · complexity basic · author Fritz Cizmarov · version 6.0


This tip presents several ways to access Python documentation using pydoc. The recommended location for the commands in this snippet is ~/.vim/after/ftplugin/python.vim, or $HOME\vimfiles\after\ftplugin\python.vim on Windows.

Using a shell (simple)Edit

To access Python documentation for the word under the cursor using, this mapping can be used

nnoremap <buffer> K :<C-u>execute "!pydoc " . expand("<cword>")<CR>

or for Windows

nnoremap <buffer> K :<C-u>execute "!C:/<PythonDir>/Lib/pydoc.py " . expand("<cword>")<CR>

To keep the documentation open while you continue editing, this mapping can be used instead

nnoremap <buffer> K :<C-u>execute "!xterm -e 'pydoc " . expand("<cword>") . "'"<CR>

or for Windows

nnoremap <buffer> K :<C-u>execute "!start cmd /c C:/<PythonDir>/Lib/pydoc.py " . \|
    \ expand("<cword>")<CR>

These mappings only work for single words. To display the documentation for a method or a class in a module, for example os.popen(), modify the mapping in this way

nnoremap <buffer> K :<C-u>let save_isk = &iskeyword \|
    \ set iskeyword+=. \|
    \ execute "!pydoc " . expand("<cword>") \|
    \ let &iskeyword = save_isk<CR>

It is not recommended to permanently add . to 'iskeyword'.

Using the preview window or a scratch bufferEdit

This snippet allows you to use the command :Pyhelp <string> to preview Python documentation in the preview window. It also remaps K in the same manner as above.

If Vim is compiled with +python, it automatically finds the path to pydoc.py. Otherwise, set the s:pydoc_path variable to a suitable value. This seemingly indirect approach is used in an effort to make the snippet platform agnostic.

if has("python")
  " let python figure out the path to pydoc
  python << EOF
import sys
import vim
vim.command("let s:pydoc_path=\'" + sys.prefix + "/lib/pydoc.py\'")
EOF
else
  " manually set the path to pydoc
  let s:pydoc_path = "/path/to/python/lib/pydoc.py"
endif

nnoremap <buffer> K :<C-u>let save_isk = &iskeyword \|
    \ set iskeyword+=. \|
    \ execute "Pyhelp " . expand("<cword>") \|
    \ let &iskeyword = save_isk<CR>
command! -nargs=1 -bar Pyhelp :call ShowPydoc(<f-args>)
function! ShowPydoc(what)
  " compose a tempfile path using the argument to the function
  let path = $TEMP . '/' . a:what . '.pydoc'
  let epath = shellescape(path)
  let epydoc_path = shellescape(s:pydoc_path)
  let ewhat = shellescape(a:what)
  " run pydoc on the argument, and redirect the output to the tempfile
  call system(epydoc_path . " " . ewhat . (stridx(&shellredir, '%s') == -1 ? (&shellredir.epath) : (substitute(&shellredir, '\V\C%s', '\=epath', ''))))
  " open the tempfile in the preview window
  execute "pedit" fnameescape(path)
endfunction

If, instead, you prefer using a scratch buffer to the preview window, change the ShowPydoc function to

function! ShowPydoc(what)
  let bufname = a:what . ".pydoc"
  " check if the buffer exists already
  if bufexists(bufname)
    let winnr = bufwinnr(bufname)
    if winnr != -1
      " if the buffer is already displayed, switch to that window
      execute winnr "wincmd w"
    else
      " otherwise, open the buffer in a split
      execute "sbuffer" bufname
    endif
  else
    " create a new buffer, set the nofile buftype and don't display it in the
    " buffer list
    execute "split" fnameescape(bufname)
    setlocal buftype=nofile
    setlocal nobuflisted
    " read the output from pydoc
    execute "r !" . shellescape(s:pydoc_path, 1) . " " . shellescape(a:what, 1)
  endif
  " go to the first line of the document
  1
endfunction

See alsoEdit

ReferencesEdit

CommentsEdit

For an alternative approach to the same problem, try the pyref.vim plug-in ( script#3104) which provides context-sensitive documentation for Python source code by looking up help topics on docs.python.org (or a local mirror on your file system) and showing them in your favorite web browser.

Around Wikia's network

Random Wiki