cli

type AsyncClient interface {
	GetContext() context.Context
	GetFactory() ClientFactory

	ExecuteTask(task *Task) task.Promise
	ExecuteScript(script string) task.Promise
	Execute(cmd string, args []string) task.Promise
}

type Client interface {
	GetContext() context.Context
	GetFactory() ClientFactory

	ExecuteTask(task *Task) error
	Execute(cmd string, args []string) error

	// execute multi-line commands
	ExecuteScript(script string) error
}

type ClientFactory interface {
	CreateClient(ctx context.Context) Client
	CreateAsyncClient(ctx context.Context) AsyncClient
}

type CommandHelpInfo struct {
	Name        string
	Title       string
	Description string
	Content     string
}

type CommandHelper interface {
	GetHelpInfo() *CommandHelpInfo
}

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

type CommandLineParser struct {
}

type Console interface {
	Error() io.Writer
	Output() io.Writer
	Input() io.Reader

	GetWD() string
	GetWorkingPath() fs.Path
	GetLastError() error

	SetWD(wd string)
	SetWorkingPath(wd fs.Path)
	SetError(w io.Writer)
	SetOutput(w io.Writer)
	SetInput(r io.Reader)

	WriteString(str string)
	WriteError(msg string, err error)
}

type ConsoleFactory interface {
	Create() Console
}

type Filter interface {
	Init(service Service) error
	Handle(ctx *TaskContext, next FilterChain) error
}

type FilterChain interface {
	Handle(ctx *TaskContext) error
}

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

type Handler interface {
	Init(service Service) error
	Handle(ctx *TaskContext) error
}

type Service interface {
	RegisterHandler(name string, h Handler) error

	FindHandler(name string) (Handler, error)

	GetHandlerNames() []string

	// AddFilter 添加一个过滤器到服务中。
	// priority 是过滤器的优先顺序，数值越大，优先级越高，处理顺序越靠前。
	AddFilter(priority int, filter Filter) error

	GetFilterChain() FilterChain

	GetClient(ctx context.Context) Client

	GetClientFactory() ClientFactory
}

type Task struct {
	Context  context.Context
	TaskList []*TaskUnit
	Script   string
	Reporter task.ProgressReporter
}

type TaskContext struct {
	Context     context.Context
	CurrentTask *TaskUnit
	Handler     Handler
	Service     Service
	Reporter    task.ProgressReporter
	TaskList    []*TaskUnit
	Console     Console
}

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

type TaskUnit struct {
	LineNumber  int      // 行号
	CommandName string   // = args[0]
	CommandLine string   // stringify(args)
	Arguments   []string // 包含命令行的所有参数（包括cmd-name本身）
}