default, required e quote

Três funções aparecem em quase todos os gráficos: padrão para valores alternativos, obrigatório para valores indispensáveis e aspas para cadeias seguras.

A função padrão fornece um valor alternativo quando um valor está vazio ou ausente, para que seu modelo nunca renderize um campo vazio.

Escrita como uma função, a alternativa vem primeiro e o valor vem depois. Em um canal, o valor chega por último, tornando a leitura natural.

Para padrão, vazio significa 0, uma cadeia de caracteres vazia, uma lista vazia ou nulo. Qualquer um desses valores ativa o valor alternativo.

A função obrigatório interrompe a renderização com a sua mensagem quando um valor está ausente, transformando problemas silenciosos em erros claros. ⛔

Quando o valor está presente, obrigatório simplesmente o retorna, para que você possa inseri-lo diretamente onde um campo obrigatório for necessário.

Uma boa mensagem de obrigatório informa qual chave está ausente e como defini-la, para que os usuários resolvam o problema sem ler o gráfico.

A função aspas envolve um valor em aspas duplas, protegendo o YAML contra valores que parecem números, valores booleanos ou nulos.

Sem aspas, um valor como yes ou 1.20 pode ser interpretado como um valor booleano ou um número. As aspas mantêm esse valor como uma cadeia previsível.

Essas funções se combinam em um único fluxo: forneça um valor padrão e depois coloque o resultado entre aspas, tudo em uma única linha legível.

Use padrão quando um valor for opcional e obrigatório quando ele for indispensável. Escolha aspas sempre que uma cadeia precisar continuar sendo uma cadeia.

Qual função interrompe a renderização quando um valor está ausente?

Você conheceu padrão para valores alternativos, obrigatório para entradas indispensáveis e aspas para cadeias seguras. Juntos, eles tornam os valores mais robustos. 🎉