config

type Config interface {
	Load() error                        // 加载配置
	Scan(v interface{}) error           // 将配置解析到目标结构体
	Value(key string) Value             // 获取指定键的配置值
	Watch(key string, o Observer) error // 监听指定键的变化
	Close() error                       // 关闭配置监听器
}

type Decoder func(*KeyValue, map[string]interface{}) error

type KeyValue struct {
	// Key 是配置的键。
	Key string
	// Value 是配置的值，以字节切片的形式存储。
	Value []byte
	// Format 是配置值的格式，例如 JSON、YAML 等。
	Format string
}

type Merge func(dst, src interface{}) error

type Observer func(string, Value)

type Option func(*options)

type Reader interface {
	Merge(...*KeyValue) error   // 合并配置数据
	Value(string) (Value, bool) // 获取指定路径的配置值
	Source() ([]byte, error)    // 获取所有配置的 JSON 表示
	Resolve() error             // 执行配置解析器
}

type Resolver func(map[string]interface{}) error

type Source interface {
	// Load 方法从配置源加载配置键值对。
	Load() ([]*KeyValue, error)
	// Watch 方法创建一个监控器，用于监控配置源的变化。
	Watch() (Watcher, error)
}

type Value interface {
	Bool() (bool, error)
	Int() (int64, error)
	Float() (float64, error)
	String() (string, error)
	Duration() (time.Duration, error)
	Slice() ([]Value, error)
	Map() (map[string]Value, error)
	Scan(interface{}) error
	Load() interface{}
	Store(interface{})
}

type Watcher interface {
	// Next 方法等待并返回配置源的下一次变化。
	Next() ([]*KeyValue, error)
	// Stop 方法停止监控器。
	Stop() error
}