Conversor online gratuito de TOML para INI

Formato de origem: TOML

TOML significa Tom’s Obvious, Minimal Language. É um formato de configuração legível por humanos, projetado para ser fácil de escrever e fácil de analisar. O TOML é amplamente usado por desenvolvedores para configurações de aplicações, metadados de projetos e arquivos de configuração de build, especialmente em ecossistemas de software modernos como Rust, Python tooling e outros projetos voltados para desenvolvedores.

O TOML suporta tabelas aninhadas, arrays, datas, booleanos, números e strings. Ele é valorizado pela sua clareza e por reduzir ambiguidades em comparação com formatos de configuração mais antigos.

Formato de destino: INI

INI é um formato simples de arquivo de configuração que usa seções, pares chave-valor e comentários. Ele tem sido usado há décadas em aplicações do Windows, software de desktop e muitas ferramentas multiplataforma. Arquivos INI são fáceis de ler e editar manualmente, o que os torna úteis para configurações básicas de aplicações e compatibilidade com sistemas legados.

Vantagem principal do INI é sua simplicidade e suporte amplo. No entanto, ele é menos expressivo do que TOML: tem suporte limitado para tipos de dados, não possui uma estrutura aninhada padrão e o tratamento é inconsistente entre analisadores.

Como realizar a conversão

Não existe uma conversão perfeita de TOML para INI de um para um, porque o TOML pode representar estruturas de dados mais ricas do que o INI. A melhor abordagem é achatar a estrutura do TOML em seções do INI e pares chave-valor simples.

1. Inspecione o arquivo TOML e identifique as tabelas de nível superior, tabelas aninhadas, arrays e valores que não são strings.
2. Defina uma estratégia de achatamento. Comumente, cada tabela do TOML vira uma seção do INI, e as tabelas aninhadas são representadas com nomes de seções pontilhados ou combinados.
3. Converta valores simples como strings, inteiros, booleanos e floats em pares chave-valor do INI.
4. Trate arrays com cuidado. O INI não tem uma sintaxe universal para arrays, então os arrays podem precisar ser unidos em strings separadas por vírgulas ou representados com chaves repetidas, dependendo da aplicação de destino.
5. Revise recursos do TOML não suportados como tabelas inline, strings multilinha, datas e estruturas profundamente aninhadas e, em seguida, simplifique-os para compatibilidade com INI.
6. Valide o resultado abrindo o arquivo INI na aplicação de destino ou testando-o com um analisador de INI.

Se você quiser uma conversão rápida baseada no navegador, você pode converter o arquivo em 101convert.com gratuitamente, sem instalar nenhum software.

Para conversão manual, um editor de texto como Visual Studio Code, Notepad++ ou Sublime Text geralmente é suficiente para arquivos pequenos. Para conversões maiores ou repetíveis, uma abordagem com scripts é melhor. Por exemplo, você pode usar Python com um analisador TOML e escrever lógica personalizada para gerar a sintaxe do INI.

Exemplo de mapeamento:

[database]
host = "localhost"
port = 5432

poderia virar:

[database]
host=localhost
port=5432

Qualidade, compatibilidade e limitações

A maior limitação nesta conversão é que o INI não consegue preservar totalmente a estrutura do TOML nem os tipos de dados. Arrays do TOML, tabelas aninhadas e valores tipados frequentemente precisam ser simplificados, o que pode causar perda de informações. Se o arquivo INI precisar ser usado por uma aplicação específica, siga as convenções esperadas dessa aplicação, porque a nomeação de seções, chaves repetidas e a formatação dos valores podem variar.

Para melhores resultados, mantenha o arquivo TOML como fonte de referência sempre que possível e gere INI apenas para compatibilidade com softwares que o exigem. Se a configuração for complexa, considere se a aplicação de destino consegue aceitar TOML diretamente em vez de converter.