log

type Config struct {
	Level             string   `yaml:"level" env:"LOG_LEVEL" default:"info"`
	Format            string   `yaml:"format" env:"LOG_FORMAT" default:"console"`
	OutputPaths       []string `yaml:"output_paths" env:"LOG_OUTPUT_PATHS"`
	ErrorOutputPaths  []string `yaml:"error_output_paths" env:"LOG_ERROR_OUTPUT_PATHS"`
	DisableCaller     bool     `yaml:"disable_caller" env:"LOG_DISABLE_CALLER" default:"false"`
	DisableStacktrace bool     `yaml:"disable_stacktrace" env:"LOG_DISABLE_STACKTRACE" default:"false"`
	Filename          string   `yaml:"filename" env:"LOG_FILENAME"`
	MaxSize           int      `yaml:"max_size" env:"LOG_MAX_SIZE" default:"100"`
	MaxAge            int      `yaml:"max_age" env:"LOG_MAX_AGE" default:"7"`
	MaxBackups        int      `yaml:"max_backups" env:"LOG_MAX_BACKUPS" default:"3"`
	Compress          bool     `yaml:"compress" env:"LOG_COMPRESS" default:"false"`
	Development       bool     `yaml:"development" env:"LOG_DEVELOPMENT" default:"false"`
}

type LogConfigProvider interface {
	GetLevel() string
	GetFormat() string
	GetOutputPaths() []string
	GetErrorOutputPaths() []string
	GetDisableCaller() bool
	GetDisableStacktrace() bool
	GetFilename() string
	GetMaxSize() int
	GetMaxAge() int
	GetMaxBackups() int
	GetCompress() bool
	GetDevelopment() bool
}

type Option func(*Options)

type Options struct {
	// OutputPaths 是一个输出路径的列表，可以是 stdout, stderr, 或者文件路径
	// 默认为 ["stdout"].
	OutputPaths []string
	// ErrorOutputPaths 是一个错误日志输出路径的列表，用于记录 logger 内部的错误
	// 默认为 ["stderr"].
	ErrorOutputPaths []string
	// Level 是最低的日志记录级别.
	// 可选值: "debug", "info", "warn", "error", "dpanic", "panic", "fatal"
	// 默认为 "info".
	Level string
	// Format 指定日志的输出格式.
	// 可选值: "json", "console". 默认为 "console".
	Format string
	// DisableCaller 禁止在日志中记录调用者的文件名和行号.
	// 默认为 false.
	DisableCaller bool
	// DisableStacktrace 禁止自动捕获堆栈跟踪.
	// 默认情况下，在开发环境中，WarnLevel 及更高级别的日志会捕获堆栈，
	// 在生产环境中，ErrorLevel 及更高级别的日志会捕获堆栈.
	DisableStacktrace bool
	// Filename 是要写入日志的文件名，用于日志轮转.
	Filename string
	// MaxSize 是日志文件在轮转之前的最大大小（以MB为单位）.
	MaxSize int
	// MaxAge 是根据文件名中的时间戳保留旧日志文件的最大天数.
	MaxAge int
	// MaxBackups 是要保留的旧日志文件的最大数量.
	MaxBackups int
	// Compress 决定是否压缩轮转后的日志文件.
	// 默认为 false.
	Compress bool
	// Development 是否为开发模式.
	// 开发模式下会自动启用更详细的日志输出和堆栈跟踪.
	// 默认为 false.
	Development bool
}