How ovh/configstore works
configstore is a Go configuration-discovery library: applications register or configure providers, retrieve a merged list of prioritized items, then look up or filter values. Built-ins cover files, file hierarchies, and environment variables; custom providers extend the same abstraction. Refreshing file providers notify watchers. The excerpts show the central store, provider implementations, item/list behavior, and filtering; the graph omits uncertain provider-factory and refresh wiring beyond explicit references.
Main entry points: store.go Configuration Store · providers.go File Providers · provider_filetree.go File Tree Provider · configstore.go Provider Factories
Components 16
Public API
- Package API
defaultstore.go - Provider Factories
configstore.go
Configuration Providers
- File Providers
providers.go - File Tree Provider
provider_filetree.go - Environment Provider
providers.go - Custom Providers
configstore.go - In-Memory Provider
providers.go
Store And Items
- Configuration Store
store.go - Configuration Items
item.go - Merged Item List
list.go - Configuration Errors
error.go
Filtering
- Item Filter
filter.go
Other components
- Application
- Configuration Files
- Process Environment
- Change Watchers
Connections 26
- Application → Package API: configures and reads
README.md - Package API → Configuration Store: delegates to
defaultstore.go - Configuration Store → Provider Factories: resolves configured factories
store.go - Provider Factories → File Providers: registers
configstore.go - Provider Factories → File Tree Provider: registers
configstore.go - Provider Factories → Environment Provider: registers
configstore.go - Application → Custom Providers: registers providers
README.md - Configuration Store → File Providers: creates
store.go - Configuration Store → File Tree Provider: creates
store.go - Configuration Store → Environment Provider: creates
- File Providers → Configuration Files: reads
providers.go - File Tree Provider → Configuration Files: traverses
provider_filetree.go - Environment Provider → Process Environment: reads
providers.go - File Providers → In-Memory Provider: populates
providers.go - File Tree Provider → In-Memory Provider: populates
provider_filetree.go - Environment Provider → In-Memory Provider: populates
providers.go - Configuration Store → Merged Item List: merges provider results
store.go - Configuration Store → Custom Providers: invokes registered providers
store.go - Merged Item List → Configuration Items: indexes and returns
list.go - Merged Item List → Configuration Errors: reports lookup failures
list.go - Package API → Change Watchers: exposes notifications
defaultstore.go - File Providers → Change Watchers: notifies on refresh
providers.go - File Tree Provider → Change Watchers: notifies on refresh
provider_filetree.go - Item Filter → Configuration Store: fetches item list
filter.go - Item Filter → Merged Item List: transforms list
filter.go - Item Filter → Configuration Items: unmarshals values
filter.go