Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

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/break
  • g% - 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 block
  • v]%d - should do the same, going through Visual mode so that you can see what is being deleted
  • V]%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.