Configuración de aplicaciones Go: librería viper

¿Qué es viper y para qué se necesita?

Viper es una potente biblioteca para la gestión de configuración en aplicaciones Go (Golang). Resuelve una de las tareas clave del desarrollo: la gestión centralizada y flexible de la configuración de la aplicación, independientemente de la fuente de datos. Viper admite trabajar con JSON, TOML, YAML, HCL, INI, envfile y variables de entorno, lo que lo convierte en una opción ideal para microservicios, utilidades CLI y aplicaciones web.

Características principales

Múltiples fuentes: lectura desde archivos (JSON, YAML, TOML), variables de entorno, almacenes remotos (etcd, Consul) e incluso flags de línea de comandos.
Prioridades: resolución automática de conflictos: la última fuente establecida tiene la prioridad más alta.
Recarga en vivo: capacidad de monitorear cambios en los archivos de configuración sin reiniciar la aplicación (requiere configuración adicional).
Soporte para claves anidadas: acceso a la configuración mediante notación de puntos (por ejemplo, app.db.host).

Instalación

Instale viper a través del gestor de paquetes estándar de Go:

go get github.com/spf13/viper

Ejemplo de código en Go

Cree un archivo config.yaml:

app:  name: "MyApp"  port: 8080database:  host: "localhost"  user: "admin"  password: "secret"

Ejemplo de uso de viper para leer la configuración:

package main

import (\t"fmt"\t"github.com/spf13/viper")

func main() {\tviper.SetConfigName("config")\tviper.SetConfigType("yaml")\tviper.AddConfigPath(".")

\terr := viper.ReadInConfig()\tif err != nil {\t\tpanic(fmt.Errorf("error al leer la configuración: %w", err))\t}

\tappName := viper.GetString("app.name")\tport := viper.GetInt("app.port")\tdbHost := viper.GetString("database.host")

\tfmt.Printf("App: %s, Port: %d, DB: %s", appName, port, dbHost)}

También se pueden usar variables de entorno con un prefijo:

viper.SetEnvPrefix("MYAPP")viper.AutomaticEnv()// Ahora la variable MYAPP_APP_PORT estará disponible como app.port

¿Cuándo usar viper?

Cuando se requiere soporte para múltiples formatos de configuración (YAML, JSON, TOML).
Para aplicaciones donde la configuración puede ser sobrescrita por variables de entorno (por ejemplo, en Docker/Kubernetes).
En arquitecturas de microservicios, donde la configuración puede cargarse desde servicios externos (etcd, Consul).
Si es necesario dividir la configuración en entornos dev/staging/production.

Viper es el estándar de facto para la gestión de configuración en la comunidad Go, utilizado en proyectos como Hugo, Docker CLI y muchos otros.