Skip to content

Latest commit

 

History

History
95 lines (69 loc) · 3.34 KB

README.md

File metadata and controls

95 lines (69 loc) · 3.34 KB

mktable

Go

mktable is a simplish cli tool which consumes content via STDIN and converts it into a pretty aligned table ready for use in markdown.

Installation

brew tap keyneston/tap
brew install mktable

With go installed:

go install github.com/keyneston/mktable@latest

Or download the latest release and add to your path.

Use

$ netstat -i | head -5 | mktable -s ' +'
| Name | Mtu   | Network     | Address   | Ipkts   | Ierrs   | Opkts   | Oerrs | Coll |
| ---- | ----- | ----------- | --------- | ------- | ------- | ------- | ----- | ---- |
| lo0  | 16384 | <Link#1>    | 9583572   | 0       | 9583572 | 0       | 0     |      |
| lo0  | 16384 | 127         | localhost | 9583572 | -       | 9583572 | -     | -    |
| lo0  | 16384 | localhost   | ::1       | 9583572 | -       | 9583572 | -     | -    |
| lo0  | 16384 | keyport.loc | fe80:1::1 | 9583572 | -       | 9583572 | -     | -    |

Flags

Flag Default Description
-s [ \t]*\t[ \t]* Regexp used to set the delimiter
-no-headers false Skip printing headers
-r / -reformat false Reformat existing markdown table. Alias for -format mk
-a none Sets the alignment. See Alignment
-f / -format regexp Sets the input format. See Formats for more details

Formats

Format Description
re / regexp Regular Expression Delimiter
csv Comma Separated List
mk / markdown Consume an existing markdown table for reformatting

Alignment

EXPERIMENTAL

The alignment flag can be passed multiple times and/or passed as a comma seperated list.

It takes a number indicating a zero indexed column, and a character indicating how to align the column.

char alignment
> right
< left
= center

Examples

Example Description
-a '0<' left align the 1st column
-a '1=' center align the 2nd column
-a '1=,2>' center align the 2nd column, and right align the second
-a '1=,2>' -a '3=' as above, but also center align the 4th column

Reformat existing tables

$ mktable -r <<EOF
| Foo      | Bar |
| a | b
| a  | b |
EOF
| Foo | Bar |
| --- | --- |
| a   | b   |
| a   | b   |

This can be used with vim to easily fix tables. First select the the lines you want (Shift-V) and then pipe it :!mktable -r.