CsvHack.vim

Overview:

The plugin is enabled on a file level with :CsvHackEnable. This

decides whether the file uses , or ; as seperator
aligns the file via dhruvasagar/vim-table-mode
setup autocommands to store the file unaligned
pins the header line above the buffer
registers some mappings and autocommands

Alignment isn't updated while the file is edited for performance reasons, save and reload to do so manually.

Mappings:

The default mappings are:

 let g:CsvHack#col_l_mapping = '<a-h>'
 let g:CsvHack#col_r_mapping = '<a-l>'
 let g:CsvHack#row_u_mapping = '<a-k>'
 let g:CsvHack#row_d_mapping = '<a-j>'
 let g:CsvHack#expand_mapping = '<space><space>'
 let g:CsvHack#quit_buffer_mapping = '<esc>'
 let g:CsvHack#goto_column = 'ö'
 let g:CsvHack#search_column_mapping = '/'

Expanding a cell opens a buffer with the unescaped contents of the cell. Saving that buffer stores the escaped contents back into the cell.

col_l and col_r jump between columns
row_u and row_d scan up/down until the next non-empty entry in the current collumn
search_column_mapping searches in the current column

Column locking:

By default a quickfix window containing header names is locked to the top of the screen. This can be disabled with g:CsvHack#pin_header = v:false.

With :CsvHackLockColumn you can instead pin a column to the left of the window. This is mutually exclusive with row locking, closing the window containing the locked column will show the column names again.

:CsvHack#LocalColumn uses fzf to pick a row, to use the column under the cursor use:

call CsvHack#SetupScrolllock('ver', virtcol("."))

You can also use the nth column with:

call CsvHack#SetupScrolllock('ver_by_nr', n)

Escaping:

The default escape mappings are

let g:CsvHack#ScriptEscapeChars = [ ['~' , '"'], ['|' , ','], ['#' , '||']]
let g:CsvHack#TextEscapeChars = [ ['[;]' , ','], ['|' , "\r"] ]

Note the ordering in ScriptEscapeChars, we don't want '#' to map into ',,'.

Installation:

With plug.vim:

Plug 'Tarmean/CsvHack.vim'
Plug 'dhruvasagar/vim-table-mode', { 'on':  ['TableModeEnable', 'TableModeRealign'] }

Disclaimer:

This is a plugin to work with the DiceyDungeon files. It might work for other csv files but things probably will break at the seams. That said, keep backups and a high undolevels even if you work with the game files.

Tarmean / CsvHack.vim