salsifis / vim-transpose

Vim plugin - Transpose matrices of text (swap lines with columns).

This is a vim plugin that helps you transpose (in the sense of matrix transposition) blocks of text, words, delimited text, or lines that you can tokenize with a custom pattern.

vim-transpose is written in pure VimL (no need for Python nor Perl).

Commands

Five commands are provided:

• :Transpose (for character array transposition),
• :TransposeWords (for word array transposition),
• :TransposeTab (for tab-separated table transposition),
• :TransposeCSV (for general delimited text transposition), and
• :TransposeInteractive (for custom transposition).

An additional variable, g:transpose_keepindent controls whether the plugin should detect indentation of the range. The :TransposeIndentToggle command will toggle this variable.

Installation

If you have the Pathogen plugin installed or any other plugin manager, then just copy this filetree into a subfolder of your Bundle folder.

Otherwise, copy the contents of the doc/, plugin/ and autoload/ folders to resp. ~/.vim/doc, ~/.vim/plugin and ~/.vim/autoload respectively.

Getting started

After having built help tags (run :Helptags if you have pathogen installed) run :help transpose-tutorial, and follow the instructions. If you don't have pathogen installed and don't know how to build the help tags, just open doc/transpose.txt inside vim.

Example use cases

This plugin can be useful:

• When you have tabular data (for example, pasted from a spreadsheet application) and you need to remove or swap columns: using regular expressions should be more difficult than using :TransposeTab, perform the operations on lines instead of columns, and :TransposeTab again.
• When you need to ensure that tabular data has a consistent number of columns: since transposition will create missing fields such that it operates on a rectangular matrix, running twice a :Transpose… command will create the missing fields.

Development

The main git repository for this plugin is at http://github.com/salsifis/vim-transpose

License

zlib/libpng license.

Copyright (c) 2012 Benoit Mortgat

This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.

Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.

2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.

3. This notice may not be removed or altered from any source distribution.

vim-transpose's Issues

Transposing whole buffer inserts line at the end

When the whole buffer is transposed, after transposition there is one empty line at the end.

Feature Request: Latex type arrays with line end

This seems to be another plugin I've been looking for the whole time.
When writing latex code I often have constructions like

\begin{matrix}
  a & b \\
  d & e \\\hline
f & g
\end{matrix}

Running VimTranspose doesn't seem to help here, because it assumes that there is no special delimiter at the end of a line.
It would be great, if one could also specify a delimiter for the line end such as \\\\.*$.

Visual block transpose

Calling :Transpose with a visual block produces unexpected output.

Shouldn't the transformed text be as following?

agmdef
bhijkl
cnopqr

Problem when an input line is empty

Example:

abc

def

:Transpose issues:

ad
b e
c f