app

type AppOf[T any] struct {
	Name    string // 程序名称
	Version string // 程序版本

	// 在运行服务之前对 [server.Server] 的额外操作
	//
	// user 为用户自定义的数据结构；
	// action 为 -a 命令行指定的参数；
	Init func(s *server.Server, user *T, action string) error

	// 以服务运行的指令
	ServeActions []string

	// 命令行输出信息的通道
	//
	// 默认为 [os.Stdout]。
	Out io.Writer

	// 配置文件的文件名
	//
	// 仅是文件名，相对的路径由命令行 -f 指定。如果为空，表示不采用配置文件，
	// 由一个空的 [server.Options] 初始化对象，具体可以查看 [NewServerOf] 的实现。
	//
	// 需要保证序列化方法已经由 [RegisterFileSerializer] 注册；
	ConfigFilename string

	// 生成 [server.Problem] 对象的方法
	//
	// 如果为空，则由 [server.Options] 决定其默认值。
	ProblemBuilder server.BuildProblemFunc

	// 本地化的相关设置
	//
	// LocaleFS 本地化文件所在的文件系统，如果为空则指向 [locales.Locales]，
	// LocaleGlob 从 LocaleFS 中查找本地化文件的匹配模式，如果为空则为 *.yaml。
	// LocaleGlob 指定的格式必须是已经通过 [RegisterFileSerializer] 注册的。
	// 由 [localeutil.DetectUserLanguageTag] 检测当前系统环境并决定采用哪种语言。
	//
	// NOTE: panic 信息不支持本地化。
	LocaleFS   fs.FS
	LocaleGlob string

	// 每次关闭服务操作的等待时间
	ShutdownTimeout time.Duration
	// contains filtered or unexported fields
}

type CacheBuilder func(dsn string) (cache.Driver, error)

type ConfigSanitizer interface {
	SanitizeConfig() *errs.FieldError
}

type LogsWriterBuilder func(args []string) (logs.Writer, func() error, error)

type MarshalFileFunc = files.MarshalFunc

type UniqueGeneratorBuilder func() server.UniqueGenerator

type UnmarshalFileFunc = files.UnmarshalFunc