O que é um ficheiro YAML?

YAML — configuração legível

O que é?

O YAML é um formato de configuração concebido para ser lido e escrito por humanos. Sem chavetas, sem etiquetas: a estrutura assenta na indentação, tal como numa lista com marcadores.

Aceita comentários, o que faz dele o formato preferido para ficheiros de configuração — ao contrário do JSON, que os proíbe e se torna verdadeiramente incómodo nesse aspeto.

História e origem

O YAML surge em 2001, com a ambição declarada de ser mais legível do que o XML e mais flexível do que os formatos de configuração existentes até então.

Impôs-se em todas as ferramentas modernas de desenvolvimento: integração contínua, orquestração de contentores, implementação automatizada. Um engenheiro atual escreve-o diariamente.

Porque é prático

Muito legível e conciso, aceita comentários e trata estruturas aninhadas com elegância.

É tecnicamente um super-conjunto do JSON: qualquer ficheiro JSON é também um YAML válido.

Limites e defeitos

A indentação é significativa, e o uso de tabulações é proibido: um espaço a mais ou mal colocado, e o ficheiro muda de significado ou torna-se inválido.

As suas conversões automáticas de tipos são uma armadilha conhecida: em versões antigas, o valor NO — o código do país Noruega — era interpretado como o booleano «falso». Este tipo de surpresa valeu ao formato uma reputação de ambiguidade.

Conselhos de utilização

O YAML é ideal para configurações escritas manualmente. Para troca de dados entre máquinas, converta-o para JSON: mais rigoroso, mais previsível, sem ambiguidades de tipo.

Coloque sempre entre aspas os valores que possam ser mal interpretados: sim, não, on, off, e tudo o que se pareça com um número sem o ser.

Converta o seu YAML em segundos, nos nossos servidores seguros em França.

Converter um YAML