cli

Documentation

Index

• Variables
• func HandleHelp(appName string, req *cmds.Request, out io.Writer) error
• func LongHelp(rootName string, root *cmds.Command, path []string, out io.Writer) error
• func NewResponseEmitter(stdout, stderr io.Writer, req *cmds.Request) (cmds.ResponseEmitter, <-chan int, error)
• func Parse(ctx context.Context, input []string, stdin *os.File, root *cmds.Command) (*cmds.Request, error)
• func Run(ctx context.Context, root *cmds.Command, cmdline []string, ...) error
• func ShortHelp(rootName string, root *cmds.Command, path []string, out io.Writer) error
• type Closer
• type ExitError
  • func (e ExitError) Error() string
• type ResponseEmitter

Variables

var ErrNoHelpRequested = errors.New("no help requested")

Functions

func HandleHelp

func HandleHelp(appName string, req *cmds.Request, out io.Writer) error

func LongHelp

func LongHelp(rootName string, root *cmds.Command, path []string, out io.Writer) error

LongHelp writes a formatted CLI helptext string to a Writer for the given command

func NewResponseEmitter

func NewResponseEmitter(stdout, stderr io.Writer, req *cmds.Request) (cmds.ResponseEmitter, <-chan int, error)

func Parse

func Parse(ctx context.Context, input []string, stdin *os.File, root *cmds.Command) (*cmds.Request, error)

Parse parses the input commandline string (cmd, flags, and args). returns the corresponding command Request object.

This function never returns nil, even on error.

func Run

func Run(ctx context.Context, root *cmds.Command,
	cmdline []string, stdin, stdout, stderr *os.File,
	buildEnv cmds.MakeEnvironment, makeExecutor cmds.MakeExecutor) error

func ShortHelp

func ShortHelp(rootName string, root *cmds.Command, path []string, out io.Writer) error

ShortHelp writes a formatted CLI helptext string to a Writer for the given command

Types

type Closer

type Closer interface {
	Close()
}

Closer is a helper interface to check if the env supports closing

type ExitError

type ExitError int

ExitError is the error used when a specific exit code needs to be returned.

func (ExitError) Error

func (e ExitError) Error() string

type ResponseEmitter

type ResponseEmitter interface {
	cmds.ResponseEmitter

	Stdout() io.Writer
	Stderr() io.Writer
	Exit(int)
}

ResponseEmitter extends cmds.ResponseEmitter to give better control over the command line