1. O que é e para que serve

A biblioteca config (crate config no ecossistema Rust) é uma ferramenta poderosa e flexível para gerenciar a configuração de aplicações. Ela fornece uma interface unificada para carregar configurações de várias fontes: arquivos (JSON, YAML, TOML, INI, HJSON), variáveis de ambiente, argumentos de linha de comando e até fontes remotas. O principal objetivo da biblioteca é abstrair o processo de leitura e combinação de configurações, permitindo que o desenvolvedor se concentre na lógica de negócios, em vez de fazer parsing de formatos.

Por que isso é importante em projetos reais? Aplicações modernas raramente têm uma única fonte de configuração. Um cenário típico: configurações básicas ficam em um arquivo config.toml, dados sensíveis (senhas, chaves de API) vêm de variáveis de ambiente, e parâmetros para uma execução específica são passados por argumentos de linha de comando. O config permite combinar todas essas fontes em uma única árvore de configurações com prioridade clara (por exemplo, variáveis de ambiente sobrescrevem valores de arquivos). Sem essa biblioteca, o desenvolvedor teria que escrever código manualmente para cada fonte, tratar erros de parsing e gerenciar a ordem de sobrescrita.

Principais vantagens do config: segurança total de tipos (as configurações são desserializadas em structs Rust), suporte a configurações aninhadas, rastreamento automático de alterações em arquivos (watch) e extensibilidade com fontes de dados personalizadas. A biblioteca é amplamente usada em projetos de produção, como servidores web, utilitários CLI e microsserviços.

2. Instalação

Para adicionar a biblioteca config a um projeto Rust, use o gerenciador de pacotes Cargo. Execute no terminal, no diretório raiz do seu projeto:

cargo add config

Se preferir editar manualmente o Cargo.toml, adicione na seção [dependencies]:

[dependencies]
config = "0.14"

Você também precisará de uma crate para serialização/desserialização. Recomenda-se o serde com a macro derive:

cargo add serde --features derive

Para trabalhar com formatos de arquivo específicos, adicione as flags de feature correspondentes. Por exemplo, para suporte a TOML, YAML e JSON:

cargo add config --features yaml,json,toml

Lista completa de formatos disponíveis: ini, json, toml, yaml, hjson. Se você planeja usar apenas um formato, especifique apenas ele — isso reduzirá o tempo de compilação.

3. Início rápido — exemplo mínimo funcional

Crie um arquivo Settings.toml na raiz do projeto:

# Settings.toml
[server]
host = "127.0.0.1"
port = 8080

[database]
url = "postgres://user:pass@localhost/db"
pool_size = 10

Agora vamos escrever o código para ler essa configuração:

use config::{Config, File, FileFormat};
use serde::Deserialize;
use std::env;

#[derive(Debug, Deserialize)]
struct ServerConfig {
    host: String,
    port: u16,
}

#[derive(Debug, Deserialize)]
struct DatabaseConfig {
    url: String,
    pool_size: u32,
}

#[derive(Debug, Deserialize)]
struct AppConfig {
    server: ServerConfig,
    database: DatabaseConfig,
}

fn main() -> Result<(), config::ConfigError> {
    // Criamos o builder de configuração
    let builder = Config::builder()
        // Adicionamos o arquivo como fonte
        .add_source