| Тип | Пример | Примечания |
|---|---|---|
| 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 |
| Функция | 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) — это формат файла конфигурации, разработанный для лёгкого чтения благодаря очевидной семантике. Он однозначно отображается на хеш-таблицу и разработан как альтернатива YAML и JSON для файлов конфигурации. TOML используется в Cargo Rust, Poetry Python и многих других инструментах.
В отличие от JSON, TOML поддерживает комментарии, многострочные строки и имеет нативные типы даты/времени. В отличие от YAML, TOML имеет явный, недвусмысленный синтаксис — нет удивительных неявных приведений типов или ловушек отступов. TOML обычно предпочитают для файлов конфигурации, а JSON — для API обмена данными.
Таблица TOML определяется синтаксисом [table.name] и отображается на вложенный объект. Массив таблиц использует [[array.name]] (двойные скобки) и создаёт массив объектов. Встроенные таблицы используют синтаксис {key = value} для компактных представлений. Таблицы поддерживают произвольную вложенность для иерархических конфигураций.
TOML поддерживает: String (базовый и литеральный/сырой), Integer (десятичный, hex 0x, octal 0o, binary 0b), Float (включая inf и nan), Boolean (true/false), Offset Date-Time (RFC 3339), Local Date-Time, Local Date, Local Time, Array (допустимы смешанные типы) и Table/Inline Table.