Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/christoomey/vim-sort-motion
Vim mapping for sorting a range of text
https://github.com/christoomey/vim-sort-motion
Last synced: 5 days ago
JSON representation
Vim mapping for sorting a range of text
- Host: GitHub
- URL: https://github.com/christoomey/vim-sort-motion
- Owner: christoomey
- License: mit
- Created: 2014-05-28T18:48:41.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2021-03-07T21:33:27.000Z (over 3 years ago)
- Last Synced: 2024-10-18T09:27:53.790Z (28 days ago)
- Language: Vim script
- Size: 10.7 KB
- Stars: 252
- Watchers: 4
- Forks: 9
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: License.md
Awesome Lists containing this project
README
Sort Motion.vim
===============
This plugin provides the ability to sort in Vim using text objects and
motions. Sorting lines and argument lists manually can be a hassle, and thus
most write it off as a waste of effort, but when its as easy as anything else
in Vim, it becomes a viable option.
`sort-motion` has three different sorting modes:
- Linewise: sort a sequence of lines (require statements, gem lists, etc)
- Character: sort a comma separated list (argument lists, attribute lists, etc)
- Visual (linewise or normal): provided for continuity, similar to linewise
- Block Visual: By default behaves the same as the other visual modes.
Optionally, you can provide a specific sort command which you might use to
sort by a column (example: `Vissort`)
Installation
------------
Using [Vundle][]:
``` vim
" add this line to your ~/.vimrc
Bundle 'christoomey/vim-sort-motion'
```
then run `:BundleInstall` from within Vim.
[Vundle]: https://github.com/gmarik/Vundle.vim
Usage
-----
### Linewise
The primary interface to this plugin is via the `gs` mapping, for sorting
based on a text object or motion. To use the mapping, type `gs` followed by a
motion, ie `2j` to sort down two lines.
Examples:
- `gs2j` => Sort down two lines (current + 2 below)
- `gsip` => Sort the current paragraph
- `gsii` => Sort the current indentation level (requires [text-obj-indent plugin][])
[text-obj-indent plugin]: https://github.com/kana/vim-textobj-indent
### Character
In addition, if the text object is within a line then `sort-motion` will
attempt to sort the text as a comma separated list.
Examples:
`gsi(` => Sort within parenthesis. `(b, c, a)` would become `(a, b, c)`
### Visual
For continuity, `sort-motion` also defines a visual mode mapping for `gs`.
This behaves as a linewise sort over the lines defined by the visual selection.
You can also (optionally) specify a blockwise command to use for block
selections (example: `Vissort`).
Configuration
-------------
### sort_motion_flags
If you'd like to pass any options to `sort`
you can set `g:sort_motion_flags`. For example you could use:
```vim
let g:sort_motion_flags = 'ui'
```
To make all sorts case insensitive and remove duplicates.
*Note*: this only applies to linewise sorting (including visual), but does
not apply to the character based sorting of comma separated lists.
### sort_motion_visual_block_command
If you'd like to specify a specific command to use for blockwise selections you
can set it here. This is useful if for example you want to use `Vissort` so that
you can sort by a column.
```vim
let g:sort_motion_visual_block_command = 'Vissort'
```
By default the command used is `sort`.
NOTE: To use `Vissort` you will need to install this plugin.