Anúncios incomodam? Ir Sem anúncios Hoje 

Formatador e Validador TOML

DadosDesenvolvedor

ANÚNCIO · REMOVER?

ENTRADA

Processo Automático

SAÍDA

Lado cliente

TOML Formatado

ANÚNCIO · REMOVER?

Guia

Formatador e Validador TOML

TOML (Tom’s Obvious Minimal Language) tornou-se o formato de configuração preferido para projetos Rust (Cargo.toml), empacotamento Python (pyproject.toml) e muitas outras ferramentas. Ele é projetado para ser legível por humanos, mas arquivos de configuração editados manualmente inevitavelmente se desviam — espaçamento inconsistente, ordenação de chaves confusa e erros de sintaxe sutis que só aparecem em tempo de compilação.

Esta ferramenta analisa seu TOML no lado do cliente, valida-o contra a especificação e o emite novamente com formatação limpa e consistente. Ele também converte TOML para JSON para verificações rápidas de interoperação. Nada sai do seu navegador.

Como usar

Cole o conteúdo TOML na área de entrada ou experimente um dos exemplos integrados (Cargo.toml, pyproject.toml). Selecione sua preferência de indentação, ative a ordenação alfabética de chaves, se desejar, e a saída formatada aparece instantaneamente. Use a aba JSON para ver a estrutura analisada como JSON. Copie ou baixe o resultado com um clique.

ANÚNCIO · REMOVER?

Características

Validação de Sintaxe – Captura erros com números de linha e mensagens descritivas antes que eles quebrem sua compilação
Formatação Consistente – Normaliza indentação, espaçamento em torno de sinais de igual e linhas em branco entre tabelas
Ordenação de Chaves – Opcionalmente, ordene alfabeticamente as chaves dentro de cada tabela para uma ordenação previsível
Indentação Configurável – Escolha 2 ou 4 espaços para corresponder às convenções do seu projeto
Conversão de TOML para JSON – Veja sua configuração como JSON para depuração rápida ou integração de API
Exemplos Integrados – Carregue configurações de exemplo Cargo.toml ou pyproject.toml para testar a formatação instantaneamente
Processamento do lado do cliente – Seus arquivos de configuração permanecem no seu navegador — nada é enviado a um servidor

Quando usar esta ferramenta

Execute seu TOML através do formatador antes de confirmar alterações de configuração, ao mesclar configurações de vários colaboradores ou ao migrar entre versões TOML. A conversão para JSON é particularmente útil quando você precisa alimentar configurações baseadas em TOML em ferramentas ou APIs somente JSON.

 Perguntas frequentes

O que é TOML e como ele difere de YAML e JSON?

TOML (Tom's Obvious Minimal Language) é um formato de arquivo de configuração projetado para ser fácil de ler e escrever. Ao contrário do YAML, o TOML evita espaços em branco significativos e aninhamento complexo que causam bugs sutis. Ao contrário do JSON, o TOML suporta comentários, tem tipos nativos de data/hora e é mais amigável para humanos em arquivos de configuração. O TOML troca parte da flexibilidade do YAML por previsibilidade — geralmente há apenas uma maneira de expressar algo em TOML.
O que é uma tabela TOML e como as tabelas inline diferem?

Uma tabela TOML é uma coleção de pares chave-valor sob um cabeçalho como [package] ou [dependencies]. As tabelas podem ser aninhadas usando cabeçalhos pontilhados como [server.database]. Tabelas inline são uma sintaxe compacta de uma linha usando chaves: key = { name = 'value', version = '1.0' }. Tabelas regulares são melhores para legibilidade com muitas chaves, enquanto tabelas inline funcionam bem para grupos pequenos e intimamente relacionados de valores.
Por que os projetos Rust usam Cargo.toml em vez de JSON ou YAML?

Rust escolheu TOML para Cargo porque ele atinge um equilíbrio entre legibilidade humana e analisabilidade por máquina. A tipagem explícita do TOML (strings, inteiros, booleanos, datas) reduz a ambiguidade que assola o YAML (onde 'no' pode ser interpretado como booleano). Seu suporte a comentários é essencial para documentar escolhas de dependência. A simplicidade do formato também significa menos casos extremos de análise e comportamento mais previsível em diferentes ferramentas e editores.
O que são arrays de tabelas em TOML?

Arrays de tabelas usam colchetes duplos [[table_name]] para definir múltiplas instâncias do mesmo tipo de tabela. Por exemplo, [[bin]] em Cargo.toml define múltiplos alvos binários. Cada bloco [[bin]] adiciona um novo elemento a um array. Esta é a maneira do TOML de representar arrays de objetos sem o ruído visual de arrays JSON ou listas baseadas em hifens do YAML.
Como pyproject.toml funciona para empacotamento Python?

pyproject.toml é o arquivo de configuração padronizado de projetos Python (definido na PEP 518 e PEP 621). Ele substitui a abordagem mais antiga setup.py e setup.cfg. A tabela [build-system] especifica os requisitos de compilação, [project] contém metadados como nome, versão e dependências, e as tabelas [tool.*] contêm a configuração para ferramentas específicas como pytest, black ou mypy. Isso consolida vários arquivos de configuração em um local padrão.