Resolver precedência de valores de configuração

Esta capacidade compara valores fornecidos pelo padrão do aplicativo, por um arquivo de configuração, por uma variável de ambiente e por uma opção de linha de comando, aplicando a ordem de precedência definida por você. Ela retorna o valor efetivo e a fonte que o forneceu, tornando a decisão fácil de inspecionar, testar e documentar. Fontes omitidas continuam diferentes de strings vazias fornecidas de propósito, representando corretamente o comportamento comum de substituição.

Descreva os valores sem perder a semântica de ausência

Informe os valores de origem no objeto values com os nomes canônicos default, config_file, environment_variable e cli_flag. Uma propriedade ausente significa que essa fonte não forneceu a configuração. Essa diferença é importante porque uma string vazia pode ser uma substituição intencional: por exemplo, uma opção de CLI pode apagar de propósito um prefixo existente em um arquivo. Portanto, o resolvedor trata uma string vazia presente como valor real e não a ignora silenciosamente. Todo valor fornecido deve ser uma string, refletindo a forma bruta comum de variáveis de ambiente e analisadores de linha de comando e evitando conversões inesperadas entre zero, falso e texto. Você também pode fornecer o nome da configuração. Ele não altera a seleção; é repetido no resultado para manter logs e casos de teste compreensíveis quando várias configurações são avaliadas. Nomes de fonte desconhecidos são rejeitados para revelar erros de digitação. Se nenhuma das quatro propriedades estiver presente, a resolução falhará, inclusive quando não houver a propriedade padrão, impedindo que uma configuração ausente vire silenciosamente um valor inventado.

Defina e aplique a precedência explicitamente

A matriz precedence lista as quatro fontes da prioridade mais alta para a mais baixa. Uma ordem convencional é opção de CLI, variável de ambiente, arquivo de configuração e padrão, mas o resolvedor não presume essa convenção, pois aplicativos e sistemas de implantação variam. Ele examina os nomes ordenados e escolhe a primeira fonte cuja propriedade existe no objeto values. A fonte retornada explica por que o valor venceu, enquanto a matriz de precedência retornada preserva a política usada. Exigir cada fonte compatível exatamente uma vez torna a política completa e auditável. Nome duplicado ou desconhecido, fonte ausente ou entrada extra gera erro de entrada em vez de resultado parcial ambíguo. Isso é útil quando as regras vêm de documentação, migração de framework ou matriz de testes: a ordem enviada é a regra inteira, e não uma sugestão combinada com padrões ocultos. A seleção é determinística e não converte tipos, interpola, acessa arquivos, consulta o ambiente nem analisa comandos. A capacidade avalia apenas os valores enviados por você; assim, a mesma entrada sempre produz a mesma saída no navegador, em CI ou via API.

Use o resultado em testes, diagnósticos e documentação

A resposta contém effective_value, source e a ordem de precedência avaliada. Se você informou um nome de configuração, a resposta também o inclui. Essa estrutura compacta funciona bem em casos de teste unitário: reúna os valores brutos observados pelo carregador, envie a política desejada e confirme se o valor vencedor e sua origem correspondem ao esperado. Ela também ajuda no diagnóstico operacional. Uma ferramenta de suporte pode mostrar que um tempo limite veio de uma variável de ambiente, e não de um arquivo versionado, sem reproduzir toda a inicialização do aplicativo. Equipes de documentação podem transformar exemplos de configurações em camadas em demonstrações executáveis. O resolvedor não lê o ambiente do processo anfitrião, não abre arquivos nem interpreta sintaxe de CLI. Quem chama continua responsável por coletar as entradas e decidir se segredos devem ser enviados; normalmente, use marcadores inofensivos ao testar apenas a precedência. Cada solicitação resolve uma configuração e custa US$ 0,002 pela API, enquanto o navegador de nível A usa a mesma lógica pura. Sem rede, aleatoriedade, relógio ou estado mutável, entradas idênticas são estáveis e fáceis de comparar ou armazenar em cache.