| Tipo | Exemplo | Notas |
|---|---|---|
| String (basic) | name = "Alice" | Supports \n, \t, \uXXXX escapes |
| String (literal) | path = 'C:\Users\Alice' | No escape processing — use for regex, paths |
| Multi-line string | desc = \"\"\" Line 1 Line 2\"\"\"`` | Opening newline trimmed |
| Integer | count = 42 hex = 0xFF bin = 0b1010 | Underscores allowed: 1_000_000 |
| Float | pi = 3.14159 sci = 5e22 inf = inf | nan also valid |
| Boolean | debug = true verbose = false | Always lowercase |
| Offset Date-Time | created = 1979-05-27T07:32:00Z | RFC 3339 / ISO 8601 |
| Local Date | date = 2024-01-15 | No time, no timezone |
| Array | tags = ["rust", "config"] | Mixed types allowed; multi-line OK |
| Inline Table | point = {x = 1, y = 2} | Must be on a single line |
| Table | [server] host = 'localhost' | Maps to nested object |
| Array of Tables | [[users]] name = 'Alice' | Creates an array of objects |
| Funcionalidade | TOML | JSON | YAML |
|---|---|---|---|
| Comments | ✓ | ✗ | ✓ |
| Trailing commas | N/A | ✗ | N/A |
| Native dates | ✓ | ✗ | ✓ |
| Multi-line strings | ✓ | ✗ (escape \n) | ✓ |
| Implicit type coercion | ✗ | ✗ | ✓ (risky) |
| Human readability | High | Medium | High |
| Machine readability | High | High | Medium |
| Use case | Config files | APIs / data exchange | Config / automation |
TOML (Tom's Obvious, Minimal Language) é um formato de arquivo de configuração projetado para ser fácil de ler devido à semântica óbvia. Mapeia inequivocamente para uma tabela de hash e é projetado como alternativa ao YAML e JSON para arquivos de configuração. TOML é usado pelo Cargo do Rust, Poetry do Python e muitas outras ferramentas.
Ao contrário do JSON, TOML suporta comentários, strings multi-linha e tem tipos de data/hora nativos. Ao contrário do YAML, TOML tem sintaxe explícita e inequívoca — sem coerções de tipo implícitas surpreendentes ou armadilhas de indentação. TOML é geralmente preferido para arquivos de configuração enquanto JSON é preferido para APIs de troca de dados.
Uma tabela TOML é definida com a sintaxe [table.name] e mapeia para um objeto aninhado. Um array de tabelas usa [[array.name]] (colchetes duplos) e cria um array de objetos. As tabelas inline usam a sintaxe {key = value} para representações compactas. As tabelas suportam aninhamento arbitrário para configuração hierárquica.
TOML suporta: String (básico e literal/raw), Integer (decimal, hex 0x, octal 0o, binário 0b), Float (incluindo inf e nan), Boolean (true/false), Offset Date-Time (RFC 3339), Local Date-Time, Local Date, Local Time, Array (tipos mistos permitidos) e Table/Inline Table.