O que é um ficheiro YAML?
YAML — configuração legível
Utilizar o formato YAML
Um exemplo concreto
Preparar um JSON a partir de um ficheiro YAML para uma ferramenta que espera JSON.
As verificações úteis
Os comentários, âncoras e tipos implícitos não têm todos um equivalente. Verifique o significado dos valores após a conversão.
Escolher uma conversão
Mantenha o original e abra o resultado no software ou no dispositivo que terá de o utilizar.
As suas perguntas sobre este formato
Porque é que o meu JSON muda de estrutura para CSV?
CSV representa uma tabela de linhas e colunas. JSON pode conter objetos e listas aninhadas que não se transponem diretamente. Converta uma cópia, verifique como os campos são representados e mantenha o JSON se o seu uso exigir conservar toda a sua estrutura.
Como evitar perder os zeros no início dos identificadores?
Ao abrir o CSV num programa de folhas de cálculo, importe as colunas de identificadores como texto. Uma abertura automática pode transformar 00123 em 123. Verifique também as datas e os separadores decimais antes de guardar novamente.
Posso converter um ficheiro que contenha segredos?
Retire as palavras-passe, chaves do API e outros segredos antes de enviar um exemplo ao serviço ou suporte. O processamento de ficheiros é feito online. Para dados que não devem sair do seu dispositivo, use uma ferramenta local adequada.
Porque é que todas as saídas não são oferecidas?
Os formatos não são intercambiáveis em todos os casos. ConvertLab mostra as conversões do seu catálogo; renomear uma extensão não transforma o conteúdo. As saídas especializadas, como algumas exportações XML ou folhas de cálculo, são identificadas como NoLimit.
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