Configuração de aplicações Go: biblioteca viper

O que é viper e para que serve?

Viper é uma biblioteca poderosa para Go (Golang), projetada para gerenciamento de configuração de aplicações. Ela suporta a leitura de configurações de várias fontes: arquivos (JSON, TOML, YAML, HCL, INI, envfile), variáveis de ambiente, flags de linha de comando e sistemas remotos (etcd, Consul). Viper combina automaticamente todas as fontes, resolvendo conflitos em favor das prioritárias (por exemplo, flags de linha de comando têm a prioridade mais alta). A biblioteca permite gerenciar facilmente a configuração durante a execução da aplicação, monitorar alterações em arquivos e recarregar configurações dinamicamente.

Instalação

Para instalar o viper, execute o comando:

go get github.com/spf13/viper

Certifique-se de ter o Go versão 1.18 ou superior instalado.

Funções principais

Leitura de arquivos: suporta os formatos JSON, TOML, YAML, HCL, INI, envfile.
Variáveis de ambiente: vinculação automática com variáveis de ambiente.
Flags de linha de comando: integração com pflag para análise de argumentos.
Configs remotas: suporte a etcd, Consul, Firestore (através de extensões).
Monitoramento de alterações: WatchConfig permite recarregar a configuração quando o arquivo é alterado.
Chaves aninhadas: acesso a dados hierárquicos através de ponto (exemplo: app.port).
Valores padrão: definidos através de SetDefault.

Exemplo de código em Go

package main

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

func main() {\tviper.SetConfigName("config") // nome do arquivo sem extensão\tviper.SetConfigType("yaml")   // formato\tviper.AddConfigPath(".")      // caminho para o arquivo\tviper.AutomaticEnv()          // ler variáveis de ambiente

\t// Valores padrão\tviper.SetDefault("app.port", 8080)

\t// Leitura da configuração\tif err := viper.ReadInConfig(); err != nil {\t\tfmt.Printf("Erro ao ler a config: %v", err)\t}

\t// Obtendo valores\tport := viper.GetInt("app.port")\tname := viper.GetString("app.name")

\tfmt.Printf("Servidor rodando na porta %d, aplicação: %s", port, name)

\t// Exemplo de arquivo config.yaml:\t// app:\t//   port: 3000\t//   name: myapp}

Quando usar viper

A biblioteca é ideal para microsserviços, aplicações web, utilitários CLI e qualquer projeto em Go que exija gerenciamento flexível de configurações. É especialmente útil quando a configuração precisa vir de múltiplas fontes (arquivo + ambiente + flags) ou quando é necessário recarregar configurações dinamicamente sem reiniciar a aplicação. Viper simplifica o trabalho com configuração, eliminando a necessidade de análise manual e combinação de dados.