benweidig / cli-table

Easy table-formatted output for your Go CLI

cli-table

cli-table is a Go 1.10 library for easy table-formatted output for CLIs.

Get it

go get -u gopkg.in/benweidig/cli-table.v2

Example

Please see example/main.go for a full example.

table := clitable.New()
table.AddRow("COL1", "COL2", "COL3", "COL4")
table.AddRow("This is", "the first", "row?", 42)
table.AddRow("A", "shorter", "row")
table.AddRow("And an even", "longer", "one", "with", "more", "columns than the first")

fmt.Println(table.String())

Output:

COL1        | COL2      | COL3 | COL4 |      |
This is     | the first | row? | 42   |      |
A           | shorter   | row  |      |      |
And an even | longer    | one  | with | more | columns than the first

Options

You can configure the output by modifying the table struct:

Option	Type	Default	Description
ColSeparator	string	" | "	Vertical separator between columns
Padding	int	0	Adds an additional padding to the next column
RightBorder	bool	false	Enable the outer right border
HeaderSeparator	byte	0	The byte used for header separator, default is "no value" so no separator is added

Inspired by

This library was created after using https://github.com/gosuri/uitable. First I wanted to fork it and change it to my needs but then I decided I wanted to go another way and startet my own library.

License

MIT. See LICENSE.