.toml · application/toml

TOML: Linguagem Mínima de Configuração TOML

TOML v1.0 mapeia de forma inequívoca para tabelas hash usando cabeçalhos [secao] estilo INI, aspas explícitas em strings, datas nativas e comentários #.

Resposta rápida: TOML v1.0 mapeia de forma inequívoca para tabelas hash usando cabeçalhos [secao] estilo INI, aspas explícitas em strings, datas nativas e comentários #. Rust Cargo.toml, Python pyproject.toml, configs do Hugo/Netlify e definições tipadas de aplicativos.

Tipo de estruturaHierárquico
Legibilidade humanaAlta
Suporte a aninhamentoSim
Eficiência de tokens LLMMédia
Extensão do arquivo.toml
Tipo MIMEapplication/toml
Indicado paraRust Cargo.toml, Python pyproject.toml, configs do Hugo/Netlify e definições tipadas de aplicativos.

Pontos fortes

  • Elimina a fragilidade de indentação e armadilhas de booleanos implícitos do YAML
  • Suporta comentários, timestamps RFC 3339 nativos e chaves pontilhadas limpas
  • Formato padrão de configuração em Rust, empacotamento Python e ferramentas CLI

Limitações

  • Arrays de objetos muito aninhados ficam verbosos comparados a JSON ou YAML
  • Exige tabelas raiz explícitas ao converter arrays no nível superior
  • Menor suporte nativo de parsers em bibliotecas padrão do que o JSON

Referências

Converter e limpar TOML localmente

Guias técnicos relacionados

Formatos relacionados

Todos os 24 formatos

Perguntas frequentes sobre TOML

Por que Cargo e pyproject.toml usam TOML em vez de YAML?

O TOML proíbe strings sem aspas e mágica de indentação, garantindo que manifestos de pacotes sejam interpretados de forma idêntica mantendo os comentários.

O TOML consegue representar um array JSON raiz diretamente?

Não. Um documento raiz TOML precisa ser uma tabela chave-valor, então arrays JSON de topo são normalmente colocados sob uma chave items ou root.

O TOML é compatível com arquivos INI?

O TOML adota a sintaxe [secao] do INI, mas adiciona uma especificação formal v1.0 com inteiros, floats, booleanos, arrays e tabelas inline tipadas.