Configuração de aplicações Go (Golang): bibliotecas e ferramentas

Configuração de aplicações Go (Golang): visão geral de bibliotecas e ferramentas

O desenvolvimento de aplicações modernas em Go (Golang) requer um gerenciamento de configuração flexível e confiável. As configurações podem vir de variáveis de ambiente, arquivos (JSON, YAML, TOML), flags de linha de comando ou fontes remotas. Neste artigo, vamos analisar as principais bibliotecas e ferramentas para configuração de aplicações Go, suas características, exemplos de uso e recomendações de escolha.

Por que uma biblioteca separada para configuração?

Os recursos embutidos do Go (por exemplo, os pacotes os ou flag) permitem ler variáveis de ambiente e flags, mas para projetos complexos isso não é suficiente. Bibliotecas de terceiros oferecem:

• Suporte a múltiplas fontes (arquivos, env, etcd, Consul).
• Vinculação automática de campos de struct com a configuração.
• Validação de valores.
• Recarregamento a quente (watch) de alterações.

1. Viper — o rei universal da configuração

Viper é a biblioteca mais popular para configuração em Go (mais de 25k estrelas no GitHub). Ela suporta YAML, JSON, TOML, HCL, INI, envfile, variáveis de ambiente e sistemas remotos (etcd, Consul).

Instalação

go get github.com/spf13/viper

Exemplo de uso

package main

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

type Config struct {    Port    int    `mapstructure:"port"`    DBHost  string `mapstructure:"db_host"`    Debug   bool   `mapstructure:"debug"`}

func main() {    viper.SetConfigName("config") // nome do arquivo sem extensão    viper.SetConfigType("yaml")    viper.AddConfigPath(".")

    if err := viper.ReadInConfig(); err != nil {        panic(fmt.Errorf("erro ao ler config: %w", err))    }

    var cfg Config    if err := viper.Unmarshal(&cfg); err != nil {        panic(fmt.Errorf("erro no unmarshal: %w", err))    }

    fmt.Printf("Porta: %d, Host BD: %s, Depuração: %t", cfg.Port, cfg.DBHost, cfg.Debug)}

Vantagens: comunidade enorme, suporte a múltiplos formatos, possibilidade de sobrescrita via variáveis de ambiente.

Desvantagens: excesso de funcionalidades para projetos simples, complexidade na depuração de prioridades de fontes.

2. envconfig — simplicidade para variáveis de ambiente

A biblioteca envconfig (de kelseyhightower) é projetada para ler configurações exclusivamente de variáveis de ambiente. Minimalismo e velocidade são seus principais trunfos.

Instalação

go get github.com/kelseyhightower/envconfig

Exemplo

package main

import (    "fmt"    "github.com/kelseyhightower/envconfig")

type Config struct {    Port    int    `envconfig:"PORT" default:"8080"`    DBHost  string `envconfig:"DB_HOST" required:"true"`    Debug   bool   `envconfig:"DEBUG"`}

func main() {    var cfg Config    err := envconfig.Process("myapp", &cfg)    if err != nil {        panic(err)    }    fmt.Printf("Porta: %d, Host: %s, Debug: %t", cfg.Port, cfg.DBHost, cfg.Debug)}

As variáveis de ambiente terão o prefixo MYAPP_ (por exemplo, MYAPP_PORT).

Prós: zero dependências, simplicidade, validação automática de campos obrigatórios.

Contras: apenas variáveis de ambiente, sem suporte a arquivos ou flags.

3. cleanenv — leveza e legibilidade

Cleanenv (de Ilya Kaznacheev) é outra ferramenta minimalista que suporta leitura de env e arquivos YAML/JSON. Sua característica especial é o suporte embutido a descrições e ajuda.

Instalação

go get github.com/ilyakaznacheev/cleanenv

Exemplo

package main

import (    "fmt"    "github.com/ilyakaznach