More efficient movements editing python files in vim
Square Bracket Mappings [[
, ]]
, [m
, ]m
and similar
$VIMRUNTIME/ftplugin/python.vim
now (2018) remaps all builtin mappings documented under :h ]]
and :h ]m
for the python language. The mappings are:
]] Jump forward to begin of next toplevel[[ Jump backwards to begin of current toplevel (if already there, previous toplevel)]m Jump forward to begin of next method/scope[m Jump backwords to begin of previous method/scope][ Jump forward to end of current toplevel[] Jump backward to end of previous of toplevel]M Jump forward to end of current method/scope[M Jump backward to end of previous method/scope
Following example source code with comments illustrates the different mappings
class Mapping: # [[[[ def __init__(self, iterable): pass def update(self, iterable): pass __update = update # []class Reverse: # [[ or [m[m def __init__(self, data): # [m self.data = data self.index = len(data) # [M def __iter__(self): # <--- CURSOR return self # ]M def __next__(self): # ]m if self.index == 0: raise StopIteration self.index = self.index - 1 return self.data[self.index] # ][class MappingSubclass(Mapping): # ]] or ]m]m def update(self, keys, values): pass
The mappings have been added and improved in the commits abd468ed0 (2016-09-08), 01164a6546b4 (2017-11-02), and 7f2e9d7c9cd (2017-11-11).
If you do not have the new version of this file yet, you can download it and put it into ~/.vim/ftplugin/python.vim
. This folder takes precedence before $VIMRUNTIME/ftplugin
.
Before these mappings have been added to $VIMRUNTIME
, there has been the plugin python-mode
which provides [[
, ]]
, [M
, and ]M
. In addition python-mode
also defines the text objects aC
, iC
, aM
, and iM
:
Plugin python-mode
This vim plugin provides motions similar to built-in ones:
2.4 Vim motion ~ *pymode-motion*Support Vim motion (See |operator|) for python objects (such as functions,class and methods).`C` — means class`M` — means method or function *pymode-motion-keys*========== ============================Key Command (modes)========== ============================[[ Jump to previous class or function (normal, visual, operator)]] Jump to next class or function (normal, visual, operator)[M Jump to previous class or method (normal, visual, operator)]M Jump to next class or method (normal, visual, operator)aC Select a class. Ex: vaC, daC, yaC, caC (normal, operator)iC Select inner class. Ex: viC, diC, yiC, ciC (normal, operator)aM Select a function or method. Ex: vaM, daM, yaM, caM (normal, operator)iM Select inner func. or method. Ex: viM, diM, yiM, ciM (normal, operator)========== ============================
Plugin Pythonsense
This plugin provides similar motions but slightly modified:
The stock Vim 8.0 "class" motions ("]]", "[[", etc.), find blocks that begin at the first column, regardless of whether or not these are class or function blocks, while its method/function motions ("[m", "]m", etc.) find all blocks at any indent regardless of whether or not these are class or function blocks. In contrast, "Pythonsense" class motions work on finding all and only class definitions, regardless of their indent level, while its method/function motions work on finding all and only method/function definitions, regardless of their indent level.
All details and examples are given at https://github.com/jeetsukumaran/vim-pythonsense#stock-vim-vs-pythonsense-motions.In addition, this plugin defines the text objects ic/ac
(class), if/af
(function), id/ad
(docstring).
For a discussion about textobjects for python see what's the fastest way to select a function of Python via VIM?.
python.vim
Makes it much easier to navigate around python code blocks.
Shortcuts:
]t
-- Jump to beginning of block]e
-- Jump to end of block]v
-- Select (Visual Line Mode) block]<
-- Shift block to left]>
-- Shift block to right]#
-- Comment selection]u
-- Uncomment selection]c
-- Select current/previous class]d
-- Select current/previous function]<up>
-- Jump to previous line with the same/lower indentation]<down>
-- Jump to next line with the same/lower indentation
python_match.vim
extends %
:
%
- cycle through if/elif/else, try/except/catch, for/continue/breakg%
- move opposite of%
[%
- move to the beginning of the current code block]%
- move to the end of the current code block
All the above motions work with Normal, Visual, and Operator-pending modes, so:
d]%
- delete until the end of the current blockv]%d
- should do the same, going through Visual mode so thatyou can see what is being deletedV]%d
- above, but with line selection
It's very easy to move indented blocks when you have set foldmethod=indent
. For example, if you're on the def main():
line in the following snippet:
def main():+-- 35 lines: gps.init()-----------------------------------------------------if __name__ == "__main__": main()
then dj
takes the whole main function and it can be pasted elsewhere.