application

type Argument interface {
	Parameter

	// Default 参数默认值
	Default() any

	// Target 绑定值
	Target() any

	// Text 默认显示文本
	Text() string

	// Required 是否是必填项
	Required() bool

	// Flag 解析出真正使用的参数
	Flag() Flag
}

type Arguments []Argument

type Command interface {
	Parameter
	Stopper
	Lifecycle

	// Run 执行命令
	Run(ctx context.Context) error

	// Arguments 参数列表
	Arguments() Arguments

	// Subcommands 子命令列表
	Subcommands() Commands

	// Description 描述文字
	Description() string

	// Category 分类
	Category() string
}

type Commands []Command

type Flag interface {
	fmt.Stringer

	// Apply 解析参数
	Apply(set *flag.FlagSet) error

	// Names 别名列表
	Names() []string

	// IsSet 是否可设置
	IsSet() bool
}

type Lifecycle interface {
	// Before 程序启动前
	Before(ctx context.Context) error

	// After 程序启动后
	After(ctx context.Context) error
}

type Parameter interface {
	// Aliases 别名，可以是短名称也可以是长名称，比如一个叫version的命令，别名可以是[v,version]
	Aliases() []string

	// Name 名称
	Name() string

	// Usage 描述使用方法
	Usage() string

	// Hidden 是否在帮助信息或者显示命令时隐藏
	Hidden() bool
}

type Serve interface {
	Stopper
	Lifecycle

	// Start 运行服务
	Start(ctx context.Context) (err error)

	// Name 服务名称
	Name() string
}

type Stopper interface {
	// Stop 停止
	Stop(ctx context.Context) (err error)
}