.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 estrutura | Hierárquico |
|---|---|
| Legibilidade humana | Alta |
| Suporte a aninhamento | Sim |
| Eficiência de tokens LLM | Média |
| Extensão do arquivo | .toml |
| Tipo MIME | application/toml |
| Indicado para | Rust 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
- JSON vs YAML vs TOML vs .env: Guia de Formatos de ConfiguraçãoCompare formatos de configuração JSON, YAML, TOML e .env em comentários, aninhamento e segurança de segredos — e converta localmente.
- Decodificação JWT offline, Base64URL e Diff JSON semânticoInspecione cabeçalhos e claims JWT, codifique Base64URL sem padding, execute diff JSON semântico ignorando ordem de chaves e limpe logs.
Formatos relacionados
Todos os 24 formatosPerguntas 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.