cli

type BodyTransformError interface {
	error
}

type CliHandler interface {
	Register(handler Handler)
	Execute(ctx context.Context, cmdline string) (Message, error)
	DescendHandlers(ctx context.Context, resp *Response, req *Request)
}

type EmptyCommandLineError interface {
	error
}

type Handler struct {
	// Use is the one-line usage message.
	// Example:  add [-F flag-val | -D flag-val] argument-val
	Use string

	// Short
	Short string

	// Command is the fully qualified command string.  If this is a sub-command
	// then the fully qualified string is "parent:sub:command"
	Command string

	// HandlerFn is the function to invoke to handle the command.  When
	// HandlerFn is invoked the command string will be striped from 'args'
	HandlerFn func(ctx context.Context, resp *Response, req *Request)
}

type Header struct {
	Key   string
	Value string
}

type Headers []Header

type Message interface {
	Headers() []Header
	Body() string
}

type MultiLineCommandLineError interface {
	error
}

type Request struct {
	Command    string
	Args       []string
	CmdHandler CliHandler
}

type Response struct {
	Headers Headers
	Body    any
	Err     error
}

type UnknownCommandError interface {
	error
}