TOML в JSON

Как сопоставляются типы

Вывод всегда форматируется с отступом в 4 пробела, поэтому массивы и объекты занимают несколько строк; в таблице выше значения показаны в одну строку для наглядности. Порядок ключей сохраняется ровно таким, каким он записан в вашем TOML.

Разобранный пример

title = "My App"

[server]
host = "localhost"
port = 8080

[[users]]
name = "alice"
admin = true

превращается в:

{
    "title": "My App",
    "server": {
        "host": "localhost",
        "port": 8080
    },
    "users": [
        {
            "name": "alice",
            "admin": true
        }
    ]
}

Поддерживаемый TOML и реальные ограничения

Поддерживается: заголовки [таблиц], включая имена секций с точками, [[массивы таблиц]], пары ключ = значение в одну строку, базовые строки "..." с экранированием \n, \t и \", литеральные строки '...', простые десятичные целые и дробные числа, true/false, однострочные массивы (вложенность допустима), комментарии # на всю строку и даты, передаваемые как строки.

Не поддерживается, и что делать вместо этого:

• Многострочные строки (""" или ''') и многострочные массивы останавливают парсер с ошибкой. Сначала запишите значение в одну строку.
• Встроенные таблицы не разворачиваются: point = { x = 1, y = 2 } выходит строкой "{ x = 1, y = 2 }", а не объектом. Перепишите её отдельной секцией [point]. Классический случай: строки зависимостей в Cargo.toml вроде serde = { version = "1.0" }.
• Ключи с точками слева от знака равенства остаются одним плоским ключом: server.host = "a" даёт ключ "server.host" без вложенности. Используйте вместо этого заголовок [server]. При этом точечные [имена.секций] в заголовках вкладываются корректно.
• Комментарии после значения не отрезаются: port = 8080 # main превращается в строку "8080 # main". Держите комментарии на отдельных строках.
• Числовые форматы сложнее простых десятичных не распознаются: 1_000, 0xFF, 5e2, +99, inf и nan выходят строками в кавычках. Пишите 1000, 255, 500, 99.
• Экранирование \uXXXX в базовых строках не декодируется. Вставьте вместо него сам символ.

Для полного документа TOML 1.0 возьмите консольный конвертер вроде toml2json или загрузите файл через tomllib в Python и выгрузите JSON оттуда.

Где это пригодится

• Быстрая проверка фрагмента TOML в виде JSON во время отладки.
• Передача простых значений конфигурации линтерам, скриптам и инструментам инвентаризации, которые принимают только JSON.
• Генерация тестовых JSON-фикстур из TOML-заметок, которые проще писать от руки.
• Перенос небольших плоских конфигураций, каких много среди config.toml для Hugo.

Заметки о пути туда и обратно

• Комментарии не выживают никогда: в JSON просто нет синтаксиса комментариев.
• Даты остаются строками; последующему коду придётся снова разбирать их в объекты дат.
• Большие числа: в тексте JSON целые сохраняются как 64-битные значения, но потребители на JavaScript теряют точность выше 2^53. Осторожнее с наносекундными метками времени и числовыми идентификаторами.
• Порядок ключей этот конвертер сохраняет как в исходнике; другие инструменты JSON могут пересортировать ключи при повторной выдаче документа.

Обратное направление

JSON → TOML: вот сложный маршрут, ведь в JSON есть конструкции (глубокая анонимная вложенность, null), которых в TOML нет или которые он обрабатывает иначе. Большинство сценариев туда-обратно требуют ручной доводки на стороне TOML.