output

package

v0.1.20 Latest Latest Go to latest Published: Sep 14, 2026 License: MIT Imports: 5 Imported by: 0

Details

Package output renders command results either as aligned text tables (default) or as JSON (-o json) for scripting.

This section is empty.

This section is empty.

This section is empty.

type Format string

Format is the selected output format.

const (
	FormatTable Format = "table"
	FormatJSON  Format = "json"
)

func Parse(s string) (Format, error)

Parse validates a --output value.

type Printer struct {
	Format Format
	Out    io.Writer
}

Printer writes results in the chosen format.

func (p Printer) JSON(v any) error

JSON writes v as indented JSON. Used directly by read commands under -o json.

func (p Printer) Render(v any, headers []string, rows [][]string) error

Render prints v as JSON when Format is JSON, otherwise calls table with the supplied header/row builder. This keeps every read command a one-liner.

func (p Printer) Table(headers []string, rows [][]string) error

Table writes a header + rows as an aligned table.