consolez

Documentation

Index

• Constants
• Variables
• type CLI
  • func NewCLI(options ...CLIOption) *CLI
  • func (c *CLI) Banner(title, tagLine string)
  • func (c *CLI) Command(cmd string, params ...string)
  • func (c *CLI) Error(err error, debug bool)
  • func (c *CLI) Header(format string, a ...any) func()
  • func (c *CLI) NewTable(columnHeaders ...any) table.Table
  • func (c *CLI) Notice(scope string, highlight string, secondary ...string)
  • func (c *CLI) Recover(debug bool)
  • func (c *CLI) Tool(toolName string, k *kong.Context)
  • func (c *CLI) WithHeader(format string, a []any, f func())
• type CLIOption
• type CLIOptionFunc
  • func CLIExit(exit func(code int)) CLIOptionFunc
  • func (f CLIOptionFunc) Apply(c *CLI)
• type Coverage
• type CoveragePrinter
  • func NewCoveragePrinter() CoveragePrinter
• type GoTestPrinter
  • func NewGoTestPrinter() GoTestPrinter

Constants

const (
	IconRocket                     = "\U0001F680"
	IconHighVoltage                = "\U000026A1"
	IconBackhandIndexPointingRight = "\U0001F449"
	IconRunner                     = "\U0001F3C3"
	IconCollision                  = "\U0001F4A5"
)

Known icons.

Variables

var (
	// DefaultCLI is a default, shared instance of CLI.
	DefaultCLI = NewCLI()
)

Types

type CLI

type CLI struct {
	// contains filtered or unexported fields
}

CLI provides some utilities for printing messages in CLI tools.

func NewCLI

func NewCLI(options ...CLIOption) *CLI

NewCLI initializes a new CLI.

func (*CLI) Banner

func (c *CLI) Banner(title, tagLine string)

Banner prints a banner.

func (*CLI) Command

func (c *CLI) Command(cmd string, params ...string)

Command prints a command.

func (*CLI) Error

func (c *CLI) Error(err error, debug bool)

Error prints an error.

func (*CLI) Header

func (c *CLI) Header(format string, a ...any) func()

Header prints a header based on a nesting hierarchy. Always call the returned function to close the scope, for example by deferring it.

func (*CLI) NewTable

func (c *CLI) NewTable(columnHeaders ...any) table.Table

NewTable creates a new table.

func (*CLI) Notice

func (c *CLI) Notice(scope string, highlight string, secondary ...string)

Notice prints a notice.

func (*CLI) Recover

func (c *CLI) Recover(debug bool)

Recover calls Error on a recovered panic and exits.

func (*CLI) Tool

func (c *CLI) Tool(toolName string, k *kong.Context)

Tool introduces a command line tool.

func (*CLI) WithHeader

func (c *CLI) WithHeader(format string, a []any, f func())

WithHeader calls Header and runs f() within its scope.

type CLIOption

type CLIOption interface {
	Apply(*CLI)
}

CLIOption describes a CLI option.

type CLIOptionFunc

type CLIOptionFunc func(*CLI)

CLIOptionFunc describes a CLI option.

func CLIExit

func CLIExit(exit func(code int)) CLIOptionFunc

CLIExit returns a CLI option that allows to provide an alternative implementation for "os.Exit".

func (CLIOptionFunc) Apply

func (f CLIOptionFunc) Apply(c *CLI)

Apply implements the CLIOption interface.

type Coverage

type Coverage struct {
	Packages []*gocov.Package
}

Coverage describes collected coverage.

type CoveragePrinter

type CoveragePrinter interface {
	Print(coverage *Coverage)
}

CoveragePrinter implements a printer for test coverage information.

func NewCoveragePrinter

func NewCoveragePrinter() CoveragePrinter

NewCoveragePrinter initializes a new CoveragePrinter.

type GoTestPrinter

type GoTestPrinter interface {
	PrintLine(line string)
	PrintDone()
}

GoTestPrinter implements a printer for "go test" output.

func NewGoTestPrinter

func NewGoTestPrinter() GoTestPrinter

NewGoTestPrinter initializes a new GoTestPrinter.