sponsor Vim development Vim logo Vim Book Ad

sideways.vim : Move function arguments (and other delimited-by-something items) left and right

 script karma  Rating 2/2, Downloaded by 351    Comments, bugs, improvements  Vim wiki

created by
Andrew Radev
 
script type
utility
 
description
Github project: https://github.com/AndrewRadev/sideways.vim

The plugin defines two commands, ":SidewaysLeft" and ":SidewaysRight", which move the item under the cursor left or right, where an "item" is defined by a delimiter. As an example:

    def function(one, two, three):
        pass

Placing the cursor on "two" and executing `:SidewaysLeft`, the "one" and "two" arguments will switch their places, resulting in this:

    def function(two, one, three):
        pass

In this case, the delimiter is a comma. The plugin currently works with various other cases and it's intended to make the process configurable. While this particular example is in python, this should work for arguments in many different languages that use round braces to denote function calls.

Apart from functions, it works for square-bracket lists in dynamic languages:

    list = [one, [two, four, five], three]

Notice that, if you experiment with this example, you'll find that you can move the entire second list around. The plugin takes into consideration nested structures.

Apart from functions, it works for lists in CSS declarations:

    border-radius: 20px 0 0 20px;

And, it also works for cucumber tables (see docs for better table formatting):

    Examples:
      | input_1 | input_2 | button | output |
      | 20      | 30      | add    | 50     |
      | 2       | 5       | add    | 7      |
      | 0       | 40      | add    | 40     |

It's highly suggested to map the two commands to convenient keys. For example, mapping them to <c-h> and <c-l> would look like this:

    nnoremap <c-h> :SidewaysLeft<cr>
    nnoremap <c-l> :SidewaysRight<cr>

The plugin is intended to be customizable, though at this point you'd need to look at the source to do this.
 
install details
There are several ways to install the plugin. The recommended one is by using Tim Pope's pathogen (http://www.vim.org/scripts/script.php?script_id=2332). In that case, you can clone the plugin's git repository like so:

    git clone git://github.com/AndrewRadev/sideways.vim.git ~/.vim/bundle/sideways

If your vim configuration is under git version control, you could also set up the repository as a submodule, which would allow you to update more easily. The command is (provided you're in ~/.vim):

    git submodule add git://github.com/AndrewRadev/sideways.vim.git bundle/sideways

Another way is to simply copy all the essential directories inside the ~/.vim directory: plugin, autoload, doc.
 

rate this script Life Changing Helpful Unfulfilling 
script versions (upload new version)

Click on the package to download.

package script version date Vim version user release notes
sideways.zip 0.1.0 2014-01-18 7.0 Andrew Radev - Ruby methods without brackets
- Go lists
- Argument text object
- Various bugfixes
sideways.zip 0.0.2 2012-10-06 7.0 Andrew Radev - Single-line CSS declarations
- Various bugfixes and refactoring
sideways.zip 0.0.1 2012-08-15 7.0 Andrew Radev Initial upload
ip used for rating: 54.161.143.22

If you have questions or remarks about this site, visit the vimonline development pages. Please use this site responsibly.
Questions about Vim should go to the maillist. Help Bram help Uganda.
   
SourceForge.net Logo