Go Reference Build Status Coverage Status Go Report Card Quality Gate Status

Utilities to prettify console output of tables, lists, progress-bars, text, etc. with a heavy emphasis on customization.

The current major version of this package is v6, and it follows the standard outlined here.

Run go get github.com/jedib0t/go-pretty/v6 to add this as a dependency to your project, and import the packages in your code using one or more of these:

• github.com/jedib0t/go-pretty/v6/list
• github.com/jedib0t/go-pretty/v6/progress
• github.com/jedib0t/go-pretty/v6/table
• github.com/jedib0t/go-pretty/v6/text

Pretty-print tables in a terminal with colors, nested tables and more.

+-----+------------+-----------+--------+-----------------------------+
| # | FIRST NAME | LAST NAME | SALARY | |
+-----+------------+-----------+--------+-----------------------------+
| 1 | Arya | Stark | 3000 | |
| 20 | Jon | Snow | 2000 | You know nothing, Jon Snow! |
| 300 | Tyrion | Lannister | 5000 | |
+-----+------------+-----------+--------+-----------------------------+
| | | TOTAL | 10000 | |
+-----+------------+-----------+--------+-----------------------------+

Execute go run github.com/jedib0t/go-pretty/v6/cmd/demo-table@latest colors to get:

Tables with Colors within a Table in a Terminal

More details can be found here: table/

Track the Progress of one or more Tasks like downloading multiple files in parallel.

Progress Demo in a Terminal

More details can be found here: progress/

Pretty-print lists with multiple levels/indents into ASCII/Unicode strings.

╭─ Game Of Thrones
│ ├─ Winter
│ ├─ Is
│ ╰─ Coming
│ ├─ This
│ ├─ Is
│ ╰─ Known
╰─ The Dark Tower
 ╰─ The Gunslinger

More details can be found here: list/

Utility functions to manipulate text with or without ANSI escape sequences. Most of the functions available are used in one or more of the other packages here.

• Align text Horizontally or Vertically
• Colorize text
• Move cursor
• Format text (convert case)
• Manipulate strings (Pad, RepeatAndTrim, RuneCount, etc.)
• Transform text (UnixTime to human-readable-time, pretty-JSON, etc.)
• Wrap text

GoDoc has examples for all the available functions.