civ
A simple CSV interactive viewer.
Demo
Build
go get -u github.com/MasahikoSawada/civ
Usage
$ civ [options] [FILE]
| Option | Description |
|---|---|
-d string |
Use string as a delimiter instead of comma(,) |
-H |
Set dummy header (col_1, col_2 ...) |
- civ reads data from stdin if no file is specified.
- civ processes the first line as a header line by default. If the first line of the file is not header line please use
-Hoption to set dummy headers. -doption allows a speciial argument\tto parse TSV.
Query Buffer
civ has a buffer for user-input query at top of the window. The first character indicates the current mode as described below.
Modes
civ has 4 modes: view mode, command mode, search mode and filter mode.
You can swtich modes by special character when the query buffer is empty.
- '
:' : View Mode - '
@' : Command Mode - '
/' : Search Mode - '
^' : Filter Mode
Press Ctrl-g always clear all query buffer and switch to view mode.
Press Ctrl-c exits but executing @exit also exits while output the table data to stdout.
Press Enter saves the result of the current command (at most one result for each searching and filtering).
View Mode(:)
Viewing the table data with the following ''less-like'' key binds:
| Key | Description |
|---|---|
| e | Forward one line |
| y | Backward one line |
| f, SPACE | Forward one window |
| b | Forward one window |
| d | Forward one half-window |
| u | Backward one half-window |
| g | Go to first line in file |
| G | Go to last line in file |
Command Mode(@)
Executing the following commands modify the table:
| Command | Description |
|---|---|
@hide column-name [...] |
Hide the specified column(s) |
@show column-name [...] |
Show the specified hidden column(s) |
@show_only column-name [...] |
Show only the specified column(s) |
@reset |
Reset all configurations(row filtering, column visibility etc) |
@exit |
Output the table data to stdout and exit normally |
Pressing Enter key executes the input command.
Note that specifying column name is case-insensive.
Search Mode(/)
civ supports the incremental search hight-lighting the matched words.
Filter Mode(^)
civ supports the incremental filtering rows.
Limitation
Since civ is continually being improved it has some limitations. These limitation might be resolved in the future.
- Not supports multi-byte characters.