ConfigManager

A Go library for managing application configuration from various sources, with support for validation, change notifications, and synchronization.

Features

• Multiple Configuration Sources: Load configuration from files, environment variables, etcd, and more.
• Validation: Validate configuration against Zog schemas.
• Change Notifications: Subscribe to configuration changes using wildcard patterns.
• Synchronization: Synchronize configuration across a distributed system using etcd.
• Struct Mapping: Automatically map configuration values to Go structs.
• Namespaces: Organize configuration into namespaces for better management.

Getting Started

package main
import (
"context""fmt""log""time""go.lumeweb.com/configmanager""go.lumeweb.com/configmanager/source""go.uber.org/zap"
)
funcmain() {
// Create a loggerlogger, err:=zap.NewDevelopment()
iferr!=nil {
log.Fatalf("failed to create logger: %v", err)
}
// Create a config manager with multiple sourcescm, err:=configmanager.NewConfigManager(
configmanager.UsingSources(
source.NewFileSource("config.yaml"),
source.NewEnvConfigSource("APP_", "_"),
),
configmanager.WithLogger(logger),
)
iferr!=nil {
log.Fatalf("failed to create config manager: %v", err)
}
// Load the configurationiferr:=cm.Load(); err!=nil {
log.Fatalf("failed to load config: %v", err)
}
// Get a string valuevalue, err:=cm.GetString("app.name")
iferr!=nil {
log.Fatalf("failed to get config value: %v", err)
}
fmt.Println("App name:", value)
// Subscribe to changesunsub:=cm.Subscribe("app.*", func(keystring) {
fmt.Println("Config changed:", key)
})
deferunsub()
// Set a new valueiferr:=cm.Set(context.Background(), "app.name", "NewAppName"); err!=nil {
log.Fatalf("failed to set config value: %v", err)
}
time.Sleep(time.Second)
}

Configuration Sources

The ConfigManager supports loading configuration from various sources:

• File: Load configuration from YAML, JSON, or other file formats.
• Environment Variables: Load configuration from environment variables.
• Etcd: Load configuration from an etcd cluster.
• Memory: Load configuration from an in-memory map.
• Default Values: Load default configuration values from Go structs.

Validation

The ConfigManager supports validating configuration values against Zog schemas.

Change Notifications

The ConfigManager supports subscribing to configuration changes using wildcard patterns.

Synchronization

The ConfigManager supports synchronizing configuration across a distributed system using etcd.

Struct Mapping

The ConfigManager supports automatically mapping configuration values to Go structs.

Namespaces

The ConfigManager supports organizing configuration into namespaces for better management.

License

MIT License

Copyright (c) 2025 Hammer Technologies LLC