CaSaVa

A CSV file formatter for Neovim, written in Lua.

Usage

Say your active buffer contains this:

Name,Tagline,Score
Gypsy,They're going to kill Joel!,1
Joel Robinson,"If you don't understand it, shoot it.",300
"Robot, Crow T.",I use cyber-based bubble memory,180
Tom Servo,You are how you look. Me? I'm a gumball machine!,"714,083"
"Nelson, Mike","Please be careful, this will be boring.","1,234"

:CsvAlign {arg} aligns the columns on the provided delimiter:

Name            ,Tagline                                         ,Score
Gypsy           ,They're going to kill Joel!                     ,1
Joel Robinson   ,"If you don't understand it, shoot it."         ,300
"Robot, Crow T.",I use cyber-based bubble memory                 ,180
Tom Servo       ,You are how you look. Me? I'm a gumball machine!,"714,083"
"Nelson, Mike"  ,"Please be careful, this will be boring."       ,"1,234"

The argument is optional and defaults to ','.

:CsvReplaceDelimiter {arg1} {arg2} replaces the first delimiter with the second. For example, :CsvReplaceDelimiter , | produces:

Name|Tagline|Score
Gypsy|They're going to kill Joel!|1
Joel Robinson|"If you don't understand it, shoot it."|300
"Robot, Crow T."|I use cyber-based bubble memory|180
Tom Servo|You are how you look. Me? I'm a gumball machine!|"714,083"
"Nelson, Mike"|"Please be careful, this will be boring."|"1,234"

Escape sequences are supported. For example, :CsvReplaceDelimiter , \t converts a comma-delimited file to a tab-delimited file.

The second argument is optional. If only one argument is provided, the first defaults to ','.

Install

With lazy.nvim prior to v11:

require('lazy').setup({
    {
        'dave-kennedy/casava.nvim',
        config = function ()
            require('casava').setup(opts)
        end
    }
})

After v11 with the single file setup:

require('lazy').setup({
    spec = {
        {
            'dave-kennedy/casava.nvim',
            opts = {}
        }
    }
})

If you followed the structured setup instructions instead, create a file at ~/.config/nvim/lua/plugins/casava.lua with these contents:

return {
    'dave-kennedy/casava.nvim',
    opts = {}
}

Options

delimiter

Default: ','

The default delimiter to use when :CsvAlign is called without an argument, or the delimiter to replace when :CsvReplaceDelimiter is called with only one argument.

Development

Clone this repo, then change 'dave-kennedy/casava.nvim' in your plugin spec to dir = 'path/to/casava.nvim'.

TODO

• Sort on column
• Unit tests