# spf13/viper **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/spf13-viper).** 30,306 stars · 2,105 forks · Go · MIT ## Links - GitHub: https://github.com/spf13/viper - awesome-repositories: https://awesome-repositories.com/repository/spf13-viper.md ## Description Viper is a configuration management library designed to centralize application settings from diverse sources into a unified, type-safe registry. It aggregates data from local files, environment variables, command-line flags, and remote key-value stores, providing a single source of truth for application state. By utilizing a hierarchical key-value registry, the system resolves configuration values based on a prioritized stack of providers, ranging from default values to runtime overrides. The library distinguishes itself through its pluggable provider abstraction and dynamic update capabilities. It supports real-time configuration watching, which monitors local files or remote stores for changes and triggers automatic reloads without requiring an application restart. Furthermore, it employs a hierarchical data mapper that uses reflection to bind unstructured configuration inputs into strongly-typed objects, ensuring compatibility with complex application structures. Beyond core management, the system includes tools for serialization, subset extraction, and custom codec registration to handle specialized data formats. It also provides features for remote store connectivity, including support for encrypted configuration values and distributed synchronization across multiple environments. The library is designed to handle various parsing requirements, including specific logic for managing character values in configuration files to prevent unintended type conversions. ## Tags ### Development Tools & Productivity - [Configuration Management](https://awesome-repositories.com/f/development-tools-productivity/configuration-management.md) — Centralizes settings from files, environment variables, and command-line flags into a unified, type-safe structure. - [Configuration Management Libraries](https://awesome-repositories.com/f/development-tools-productivity/configuration-management-libraries.md) — A centralized registry that aggregates settings from files, environment variables, command-line flags, and remote stores into a unified application state. - [Configuration Mappers](https://awesome-repositories.com/f/development-tools-productivity/configuration-mappers.md) — Binds raw configuration inputs into strongly-typed objects using field tags and custom decoding logic. - [Distributed Configuration](https://awesome-repositories.com/f/development-tools-productivity/distributed-configuration.md) — Manages application settings across multiple instances by fetching and watching values from centralized remote stores. - [Dynamic Configuration](https://awesome-repositories.com/f/development-tools-productivity/dynamic-configuration.md) — Updates application settings in real-time by monitoring external sources without requiring a full service restart. - [Configuration Aggregators](https://awesome-repositories.com/f/development-tools-productivity/configuration-aggregators.md) — Combines settings from diverse formats and locations into a single source of truth with hierarchical overrides. - [Configuration Watchers](https://awesome-repositories.com/f/development-tools-productivity/configuration-watchers.md) — Monitors remote key-value stores for real-time updates and automatically triggers application logic to reload settings. ([source](https://github.com/spf13/viper#readme)) - [Remote Configuration Providers](https://awesome-repositories.com/f/development-tools-productivity/remote-configuration-providers.md) — Connects to remote key-value stores to retrieve configuration data from distributed providers. ([source](https://github.com/spf13/viper#readme)) ### Software Engineering & Architecture - [File-Based Configuration Loaders](https://awesome-repositories.com/f/software-engineering-architecture/file-based-configuration-loaders.md) — Loads settings from various file formats by specifying file paths. ([source](https://github.com/spf13/viper#readme)) - [Hierarchical Registries](https://awesome-repositories.com/f/software-engineering-architecture/hierarchical-registries.md) — Stores configuration settings across multiple layers of precedence to resolve values from various sources. - [Command-Line Flag Bindings](https://awesome-repositories.com/f/software-engineering-architecture/command-line-flag-bindings.md) — Binds command-line flags to internal configuration keys for seamless interaction. ([source](https://github.com/spf13/viper#readme)) - [Environment Variable Integrations](https://awesome-repositories.com/f/software-engineering-architecture/environment-variable-integrations.md) — Integrates environment variables by mapping specific prefixes to internal keys. ([source](https://github.com/spf13/viper#readme)) - [Provider Abstractions](https://awesome-repositories.com/f/software-engineering-architecture/provider-abstractions.md) — Implements pluggable drivers to fetch raw data from local files, environment variables, or remote stores. - [Configuration Deserializers](https://awesome-repositories.com/f/software-engineering-architecture/configuration-deserializers.md) — Maps configuration values into structured data objects using field tags. ([source](https://github.com/spf13/viper#readme)) - [Live Configuration Watchers](https://awesome-repositories.com/f/software-engineering-architecture/live-configuration-watchers.md) — Monitors configuration files for changes in real-time and automatically reloads settings. ([source](https://github.com/spf13/viper#readme)) - [Precedence Resolution Engines](https://awesome-repositories.com/f/software-engineering-architecture/precedence-resolution-engines.md) — Retrieves configuration values by traversing a prioritized stack of providers. - [Configuration Watchers](https://awesome-repositories.com/f/software-engineering-architecture/configuration-watchers.md) — Monitors file system events to trigger automatic reloads of the internal configuration state. - [Runtime Configuration Overrides](https://awesome-repositories.com/f/software-engineering-architecture/runtime-configuration-overrides.md) — Allows overriding existing configuration values at runtime. ([source](https://github.com/spf13/viper#readme)) - [Default Configuration Values](https://awesome-repositories.com/f/software-engineering-architecture/default-configuration-values.md) — Defines default values for configuration keys to ensure reliable fallback settings. ([source](https://github.com/spf13/viper#readme)) - [Reflection-Based Unmarshallers](https://awesome-repositories.com/f/software-engineering-architecture/reflection-based-unmarshallers.md) — Maps unstructured configuration data into strongly typed structures using language reflection. ### DevOps & Infrastructure - [Distributed Configuration Providers](https://awesome-repositories.com/f/devops-infrastructure/distributed-configuration-providers.md) — A connectivity layer that retrieves and synchronizes application configuration data across multiple remote environments and secure storage backends. ### Part of an Awesome List - [Configuration Management](https://awesome-repositories.com/f/awesome-lists/devops/configuration-management.md) — Listed in the “Configuration Management” section of the Awesome Go awesome list. - [Configuration Management](https://awesome-repositories.com/f/awesome-lists/devtools/configuration-management.md) — Comprehensive configuration management library. - [Developer Tools and CLIs](https://awesome-repositories.com/f/awesome-lists/devtools/developer-tools-and-clis.md) — Configuration management library. - [Go CLI Frameworks](https://awesome-repositories.com/f/awesome-lists/devtools/go-cli-frameworks.md) — Configuration solution for command-line applications. - [Utility Libraries](https://awesome-repositories.com/f/awesome-lists/devtools/utility-libraries.md) — Configuration management solution for Go. ### System Administration & Monitoring - [Dynamic Configuration Watchers](https://awesome-repositories.com/f/system-administration-monitoring/dynamic-configuration-watchers.md) — A background monitoring service that detects changes in local files or remote key-value stores to trigger real-time application updates. ### Security & Cryptography - [Configuration Encryption](https://awesome-repositories.com/f/security-cryptography/configuration-encryption.md) — Encrypts and decrypts configuration values stored in remote providers to ensure sensitive data remains secure. ([source](https://github.com/spf13/viper#readme))