cli

type Binding interface {
	GetWD() string
	GetEnv() map[string]string
	GetConsole() Console
	GetCLI() CLI

	SetCLI(c CLI)
	SetWD(wd string)
	SetEnv(kv map[string]string)
	SetConsole(c Console)
}

type CLI interface {

	// 取客户端
	GetClient() Client

	// 取服务端
	GetServer() Server

	// 把这个 CLI 绑定到指定的 Context
	Bind(cc context.Context) context.Context
}

type Client interface {
	Handler

	// run a task with Context & Command & Arguments
	RunCCA(ctx context.Context, cmd string, args []string) error
}

type ClientFactory interface {
	NewClient(c *Context) (Client, error)
}

type Configuration struct {
	Handlers       []HandlerRegistry
	Filters        []FilterRegistry
	ContextFactory ContextFactory
	ClientFactory  ClientFactory
	ServerFactory  ServerFactory
}

type Console interface {
	Input() io.Reader

	Output() io.Writer

	Error() io.Writer

	In() *bufio.Reader

	Out() *bufio.Writer

	Err() *bufio.Writer
}

type ConsoleBuilder struct {
	Input  io.Reader
	Output io.Writer
	Error  io.Writer
}

type Context struct {
	Config   *Configuration
	Client   Client
	Server   Server
	CLI      CLI
	Chain    FilterChain
	Handlers []*HandlerRegistration
	Filters  []*FilterRegistration
}

type ContextFactory interface {
	NewContext(cfg *Configuration) (*Context, error)
}

type DefaultClientFactory struct {
}

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

type DefaultContextFactory struct {
}

type DefaultServerFactory struct {
}

type Filter interface {
	Pass(task *Task, chain FilterChain) error
}

type FilterChain interface {
	Pass(task *Task) error
}

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

type FilterRegistration struct {
	Name   string
	Filter Filter
	Order  int
	OnInit OnInitFunc
}

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

type FilterRegistry interface {
	GetFilters() []*FilterRegistration
}

type Handler interface {
	Run(task *Task) error
}

type HandlerFunc func(task *Task) error

type HandlerRegistration struct {
	Name    string
	Handler HandlerFunc
	Help    Help
	OnInit  OnInitFunc
}

type HandlerRegistry interface {
	GetHandlers() []*HandlerRegistration
}

type Help interface {
	GetHelp() *HelpInfo
}

type HelpInfo struct {
	Name    string // 命令名称
	Title   string // 命令标题
	Usage   string // 使用方法
	Content string // 具体内容
}

type OnInitFunc func(c *Context) error

type Server interface {
	FindHandler(name string) (*HandlerRegistration, error)

	RegisterHandler(hr *HandlerRegistration) error

	RegisterHandlers(hr HandlerRegistry) error

	ListNames() []string
}

type ServerFactory interface {
	NewServer(c *Context) (Server, error)
}

type Task struct {
	Context   context.Context
	Server    Server
	Client    Client
	Command   string
	Arguments []string
	Console   Console
	WD        string
	Env       map[string]string
	Quietly   bool // 把异常输出到 Console.Error, 而不是抛出
}