Converter TOML para YAML

Os fatos sobre um projeto cada vez mais vivem num arquivo TOML — o nome do pacote, as versões suportadas, os sinalizadores de recurso. O que consome esses fatos é, com igual consistência, YAML: um workflow do GitHub Actions, um arquivo de valores do Helm.

Então o trabalho normalmente não é uma migração, é uma transcrição: colocar os valores em sintaxe YAML com precisão, depois mover as partes que você precisa para um arquivo com forma própria.

TOML é incomum entre formatos de configuração por ter tipos reais de data e datahora, escritos sem aspas. Elas chegam no YAML da mesma forma, sem aspas nenhuma — o que YAML reserva para um timestamp.

O que isso compra depende inteiramente do leitor. Lida de volta com a mesma biblioteca que escreveu, que segue o schema núcleo do YAML 1.2, todos esses valores voltam como string: 1.2 não tem resolvedor de timestamp. Lida com PyYAML, ainda em YAML 1.1, os dois primeiros viram objetos de data.

Os dois alvos escrevem os mesmos caracteres para uma data, então o argumento é sobre onde o tipo mora. No YAML o valor está sem aspas e é autodescritivo o bastante para um leitor 1.1 tipar sem ser instruído.

Isso corta dos dois lados. Um schema é um mecanismo de aplicação, e se o sistema receptor tem um, uma data mal tipada é pega na porta em vez de três passos dentro de um pipeline.

Um cabeçalho [package] vira uma chave de nível superior com seus valores indentados dois espaços abaixo. Um cabeçalho [tool.black] vira tool: contendo black: contendo as configurações.

A ordem é a ordem que o parser viu, o que para TOML significa que os valores soltos no topo do arquivo vêm primeiro e cada tabela segue na ordem em que foi escrita.

Esse é o real câmbio de regime, e é fácil de perder porque a saída parece tão parecida. Em TOML, enabled = true é booleano porque a sintaxe diz. Em YAML, um escalar sem aspas é o que o parser decidir que é.

O escritor faz isso onde importa: uma string de dígitos sai entre aspas, então version = "1.0" continua version: "1.0" e não o número 1. O que não fica entre aspas é NO, yes, on e off, porque sob YAML 1.2 essas são strings comuns.

Um bloco [[bin]] repetido é a forma TOML de lista-de-registros, e converte para o formato que todo mundo escreve à mão em YAML: um traço por entrada, chaves indentadas abaixo.

Essa forma em bloco é o que a maioria das ferramentas YAML documenta, então entradas normalmente colam num workflow ou arquivo de valores sem reformatação.

Uma string TOML entre aspas triplas guardando um script ou descrição mantém sua estrutura de linha. O escritor emite isso como um bloco escalar — a chave, um pipe, depois as linhas reais indentadas.

Valores de linha única longos são tratados de forma diferente: uma string sem quebras mas com bastante comprimento é dobrada em linhas de continuação por volta da coluna oitenta, e YAML lê essas dobras como espaços.

TOML e YAML suportam comentários com #, e um manifesto costuma estar cheio deles: por que uma dependência está fixada numa versão de patch, o que um número mágico significa. Nada disso sobrevive.

Para um fragmento que você vai colar isso não chama atenção. Para qualquer coisa que você pretende manter, é o motivo de o TOML continuar sendo a fonte da verdade e o YAML ser gerado.

A conversão é JavaScript nesta aba: o navegador interpreta o TOML, um pequeno escritor produz o YAML, e nenhuma requisição carrega o documento a lugar nenhum. Não há cadastro, fila nem limite diário.

Manifestos são pequenos o bastante para o teto gratuito de 100 MB ser teórico, mas nem sempre são públicos. A lista de dependências de um repositório privado nomeia pacotes e registros internos.