Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/InVisionApp/tabular
Tabular simplifies printing ASCII tables from command line utilities
https://github.com/InVisionApp/tabular
cli go golang opensource tables
Last synced: about 2 months ago
JSON representation
Tabular simplifies printing ASCII tables from command line utilities
- Host: GitHub
- URL: https://github.com/InVisionApp/tabular
- Owner: InVisionApp
- License: mit
- Created: 2018-04-23T21:17:03.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-05-12T01:35:13.000Z (over 1 year ago)
- Last Synced: 2024-08-06T15:19:43.568Z (4 months ago)
- Topics: cli, go, golang, opensource, tables
- Language: Go
- Homepage:
- Size: 16.6 KB
- Stars: 76
- Watchers: 100
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
- awesome-go - tabular - Print ASCII tables from command line utilities without the need to pass large sets of data to the API. (Command Line / Advanced Console UIs)
- fucking-awesome-go - tabular - Print ASCII tables from command line utilities without the need to pass large sets of data to the API. (Command Line / Advanced Console UIs)
- awesome-go - tabular - Print ASCII tables from command line utilities without the need to pass large sets of data to the API. (Command Line / Advanced Console UIs)
- awesome-go - tabular - Print ASCII tables from command line utilities without the need to pass large sets of data to the API. (Command Line / Advanced Console UIs)
- awesome-go - tabular - Tabular simplifies printing ASCII tables from command line utilities - ★ 14 (Command Line)
- awesome-go-extra - tabular - 04-23T21:17:03Z|2018-05-14T19:04:57Z| (Build Automation / Advanced Console UIs)
- awesome-go-with-stars - tabular - Print ASCII tables from command line utilities without the need to pass large sets of data to the API. (Command Line / Advanced Console UIs)
- awesome-go-cn - tabular
- awesome-go-plus - tabular - Print ASCII tables from command line utilities without the need to pass large sets of data to the API.  (Command Line / Advanced Console UIs)
- awesome-go-plus - tabular - Print ASCII tables from command line utilities without the need to pass large sets of data to the API. (Command Line / Advanced Console UIs)
README
[](LICENSE)
[](https://travis-ci.org/InVisionApp/tabular)
[](https://codecov.io/gh/InVisionApp/tabular)
[](https://goreportcard.com/report/github.com/InVisionApp/tabular)
[](https://godoc.org/github.com/InVisionApp/tabular)
# tabular
Tabular simplifies printing ASCII tables from command line utilities without the need to pass large sets of data to it's API.
Simply define the table columns and `tabular` will parse the right [format specifier](https://golang.org/pkg/fmt/#Printf) that you can use in your calls to `fmt.Printf()` or any other function that supports it.
Table columns can be defined once and then reused over and over again making it easy to modify column length and heading in one place. And a subset of columns can be specified during `tabular.Print()` or `tabular.Parse()` calls to modify the table's title without redefining it.
Example (also available in [`example/example.go`](example/example.go)):
```go
package main
import (
"fmt"
"log"
"github.com/InVisionApp/tabular"
)
var tab tabular.Table
func init() {
tab = tabular.New()
tab.Col("env", "Environment", 14)
tab.Col("cls", "Cluster", 10)
tab.Col("svc", "Service", 15)
tab.Col("hst", "Database Host", 20)
tab.ColRJ("pct", "%CPU", 7)
}
var data = []struct {
e, c, s, d string
v float64
}{
{
e: "production",
c: "cluster-1",
s: "service-a",
d: "database-host-1",
v: 70.01,
},
{
e: "production",
c: "cluster-1",
s: "service-b",
d: "database-host-2",
v: 99.51,
},
{
e: "production",
c: "cluster-2",
s: "service-a",
d: "database-host-1",
v: 70.01,
},
{
e: "production",
c: "cluster-2",
s: "service-b",
d: "database-host-2",
v: 99.51,
},
}
func main() {
// Print a subset of columns (Environments and Clusters)
format := tab.Print("env", "cls")
for _, x := range data {
fmt.Printf(format, x.e, x.c)
}
// Print All Columns
format = tab.Print("*")
for _, x := range data {
fmt.Printf(format, x.e, x.c, x.s, x.d, x.v)
}
// Print All Columns to a custom destination such as a log
table := tab.Parse("*")
log.Println(table.Header)
log.Println(table.SubHeader)
for _, x := range data {
log.Printf(table.Format, x.e, x.c, x.s, x.d, x.v)
}
}
```
Produces:
```
Environment Cluster
-------------- ----------
production cluster-1
production cluster-1
production cluster-2
production cluster-2
Environment Cluster Service Database Host %CPU
-------------- ---------- --------------- -------------------- -------
production cluster-1 service-a database-host-1 70.01
production cluster-1 service-b database-host-2 99.51
production cluster-2 service-a database-host-1 70.01
production cluster-2 service-b database-host-2 99.51
2018/05/14 11:19:41 Environment Cluster Service Database Host %CPU
2018/05/14 11:19:41 -------------- ---------- --------------- -------------------- -------
2018/05/14 11:19:41 production cluster-1 service-a database-host-1 70.01
2018/05/14 11:19:41 production cluster-1 service-b database-host-2 99.51
2018/05/14 11:19:41 production cluster-2 service-a database-host-1 70.01
2018/05/14 11:19:41 production cluster-2 service-b database-host-2 99.51
```