knadh/koanf
Koanf
koanf is a configuration management library for Go designed to load, merge, and unmarshal application settings from multiple sources into structured objects. It functions as a multi-source config loader that aggregates data from environment variables, files, and remote providers into a single unified map.
The system utilizes a pluggable architecture for parsing and data abstraction, allowing it to transform bytes from formats such as JSON, YAML, and TOML into nested maps. It supports dynamic configuration watching to monitor external sources and trigger automatic reloads when settings change.
The library provides tools for recursive map merging with custom collision resolution strategies and delimited key path querying for accessing nested values. It also includes capabilities for mapping configuration keys to strongly typed structs using custom tags and serializing configuration states back into raw bytes.
Features
- Multi-Source Configuration - Aggregates configuration from files, environment variables, and CLI flags into a single unified object.
- Configuration Aggregators - Aggregates configuration data from environment variables, files, and remote providers into a single unified map.
- Configuration - Maps configuration keys to strongly typed Go structs using custom tags for easier access in application logic.
- Map Merging - Combines nested configuration maps from multiple sources using recursive merging and custom collision strategies.
- Direct Path Querying - Allows querying specific configuration values directly via delimited path expressions.
- External Configuration Integration - Integrates application parameters with external configuration sources such as remote endpoints and files.
- Configuration File Loading - Loads and parses settings from various structured files to determine application runtime behavior.
- Delimited Path Lookups - Enables retrieval of deeply nested configuration values using delimited string paths.
- Configuration Providers - Provides an extensible interface for fetching application settings from arbitrary external sources.
- Configuration Formats - Supports multiple standardized data formats for organizing and defining application settings.
- Byte-to-Map Parsers - Provides a pluggable interface to transform raw bytes from JSON, YAML, and TOML into structured maps.
- Configuration File Parsers - Transforms bytes from formats such as JSON, YAML, and TOML into nested maps for application use.
- Configuration Management Libraries - Provides a comprehensive Go library for loading, merging, and unmarshaling application settings from multiple sources.
- Provider Abstractions - Decouples configuration data sources from the internal representation using a standardized provider interface.
- Configuration Hot-Reloading - Updates application settings dynamically from monitored sources without requiring a service restart.
- Configuration Merge Strategies - Provides custom functions to control how data from multiple configuration sources is merged.
- Configuration Watchers - Monitors external configuration sources and triggers automatic reloads when settings are modified.
- Event-Driven Callbacks - Implements event-driven callbacks to trigger configuration reloads when external sources are modified.
- Struct Tags - Uses custom struct tags to map configuration keys directly to strongly typed Go struct fields.
- Reflection-Based Unmarshallers - Uses reflection to map unstructured configuration data to typed Go structures.
- Struct-Based Configurations - Maps configuration values into typed Go structs for safe input handling and access.
- Configuration Change Watchers - Monitors configuration sources and triggers callbacks to automatically reload settings upon modification.
- Configuration Management - Lightweight library for reading various config formats.
- Configuration Management - Listed in the “Configuration Management” section of the Awesome Go awesome list.
- Konfigurationsmanagement - Lightweight configuration management library.
