How knadh/koanf works
koanf is a Go configuration-loading library: applications combine providers for sources with parsers for formats, load and merge the resulting values, then query or marshal configuration. Its documented capabilities include files, flags, environment variables, cloud and remote stores, maps/structs, file watching, custom extensions, and multiple serialization formats. Core loading and map behavior are visible in the source index; several provider and parser relationships are documented in the README, while many provider implementations were not sampled.
Main entry points: koanf.go Koanf loader · maps.go Nested map utilities · env.go Environment variables · posflag.go Command-line flags
Components 20
Core configuration
- Koanf loader
koanf.go - Config getters
getters.go - Provider and parser APIs
interfaces.go - Nested map utilities
maps/maps.go - Load options
options.go
Configuration providers
- File and filesystem
providers/file - Environment variables
providers/env/env.go - Command-line flags
providers/posflag/posflag.go - Maps, structs, bytes
providers - Kubernetes mounts
providers/k8smount/provider.go
Format parsers
- Format parsers
parsers - JSON parser
parsers/json/json.go - YAML parser
parsers/yaml/yaml.go - TOML parser
parsers/toml/toml.go - DOTENV parser
parsers/dotenv/dotenv.go - Other parsers
parsers
Remote stores
- Cloud configuration
providers - Consul and etcd
providers - NATS key-value
providers/nats/nats.go
Other components
- Go application
Connections 23
- Go application → Koanf loader: loads config
- Koanf loader → File and filesystem: reads provider
- Koanf loader → Environment variables: reads provider
- Koanf loader → Command-line flags: reads provider
- Koanf loader → Maps, structs, bytes: reads provider
- Koanf loader → Kubernetes mounts: reads provider
- Koanf loader → Cloud configuration: reads provider
- Koanf loader → Consul and etcd: reads provider
- Koanf loader → NATS key-value: reads provider
- Koanf loader → JSON parser: parses with
- Koanf loader → YAML parser: parses with
- Koanf loader → TOML parser: parses with
- Koanf loader → DOTENV parser: parses with
- Koanf loader → Other parsers: parses with
- Koanf loader → Nested map utilities: uses maps
koanf.go - Go application → Config getters: queries values
- Koanf loader → Config getters: exposes values
- Provider and parser APIs → Koanf loader: defines contracts
- Load options → Koanf loader: configures loading
- Environment variables → Nested map utilities: unflattens keys
providers/env/env.go - Command-line flags → Nested map utilities: unflattens keys
providers/posflag/posflag.go - DOTENV parser → Nested map utilities: unflattens keys
parsers/dotenv/dotenv.go - NATS key-value → Nested map utilities: unflattens keys
providers/nats/nats.go