output

Documentation

Index

• Variables
• func Print(format string, columns []string, rows []map[string]string) error
• func PrintDetail(w io.Writer, fields []Field)
• func PrintRaw(data json.RawMessage) error
• func RelativeTime(iso string) string
• type CSVFormatter
  • func (f *CSVFormatter) Format(w io.Writer, columns []string, rows []map[string]string) error
• type Field
• type Formatter
  • func New(format string) Formatter
• type JSONFormatter
  • func (f *JSONFormatter) Format(w io.Writer, columns []string, rows []map[string]string) error
• type TableFormatter
  • func (f *TableFormatter) Format(w io.Writer, columns []string, rows []map[string]string) error

Variables

var (
	Blue  = color.New(color.FgHiBlue).SprintFunc()
	Green = color.New(color.FgHiGreen).SprintFunc()
	Dim   = color.New(color.FgHiBlack).SprintFunc()
)

Terminal colors used across table, detail, and custom output. fatih/color auto-disables when stdout is not a TTY or NO_COLOR is set.

var Out io.Writer = os.Stdout

Out is the writer used by Print/PrintRaw. Tests swap this to a bytes.Buffer.

Functions

func Print

func Print(format string, columns []string, rows []map[string]string) error

Print is a convenience: format rows to Out.

func PrintDetail

func PrintDetail(w io.Writer, fields []Field)

PrintDetail writes a vertical key-value layout to w. Labels are right-padded to align values. Empty values are skipped.

func PrintRaw

func PrintRaw(data json.RawMessage) error

PrintRaw prints raw JSON to Out (used when --format json and we have raw API data).

func RelativeTime

func RelativeTime(iso string) string

RelativeTime converts an ISO timestamp to a short human-readable string like "2m ago", "3h ago", "5d ago". Returns the original string on parse failure.

Types

type CSVFormatter

type CSVFormatter struct{}

func (*CSVFormatter) Format

func (f *CSVFormatter) Format(w io.Writer, columns []string, rows []map[string]string) error

type Field

type Field struct {
	Label string
	Value string
}

Field is a label-value pair for detail output.

type Formatter

type Formatter interface {
	Format(w io.Writer, columns []string, rows []map[string]string) error
}

Formatter writes structured data to output.

func New

func New(format string) Formatter

New returns a Formatter for the given format name.

type JSONFormatter

type JSONFormatter struct{}

func (*JSONFormatter) Format

func (f *JSONFormatter) Format(w io.Writer, columns []string, rows []map[string]string) error

type TableFormatter

type TableFormatter struct{}

func (*TableFormatter) Format

func (f *TableFormatter) Format(w io.Writer, columns []string, rows []map[string]string) error