Конвертер TOML в JSON

Добро пожаловать в Конвертер TOML в JSON — бесплатный онлайн-инструмент, который превращает любую конфигурацию TOML в чистый, валидный JSON одним щелчком мыши. Если вы переносите Cargo.toml в конвейер на базе JSON, визуально отлаживаете глубоко вложенные настройки или передаете файл TOML в сервис, принимающий только JSON, этот конвертер корректно обработает все конструкции TOML: таблицы, подтаблицы, массивы таблиц, встроенные таблицы, ключи с точками, многострочные строки, шестнадцатеричные/восьмеричные/двоичные целые числа, даты и специальные числа с плавающей запятой. Выберите стиль вывода, подходящий для вашего рабочего процесса — красивый с 2 или 4 пробелами, компактный или отсортированный по ключам — и изучите результат с помощью дерева структуры, панели статистики и диаграммы преобразования.

Что такое TOML и зачем конвертировать его в JSON?

TOML (Tom's Obvious Minimal Language) — это формат конфигурации, разработанный как однозначный и легкий для чтения человеком. Он используется в метаданных пакетов для Cargo (Rust), Poetry (Python) и многих других инструментов разработки. JSON, с другой стороны, является универсальным форматом обмена данными в Интернете. Многие системы — REST API, документоориентированные базы данных, браузерное localStorage и приложения JavaScript — работают только с JSON. Конвертация TOML в JSON позволяет объединить эти два мира без необходимости переписывать вашу конфигурацию.

Основные причины конвертировать TOML в JSON

• Передача TOML в JSON-API — например, в сервис развертывания или платформу управления флагами функций.
• Визуальный осмотр глубоко вложенных конфигураций — структура скобок JSON делает иерархию очевидной с первого взгляда.
• Создание конфигурационных пакетов для фронтенда — храните исходный формат в TOML, а в браузер отправляйте JSON.
• Работа с линтерами и JSON Schema — проверяйте структуру TOML, пропуская ее через валидатор JSON Schema.
• Сравнение конфигураций — сравнивайте JSON с отсортированными ключами между средами, чтобы обнаружить расхождения.
• Миграция устаревших конфигураций — постепенно переносите файлы TOML в конфигурационные сервисы на базе JSON.

Ключевые особенности этого конвертера

• Полное покрытие TOML 1.0 — базовые и литеральные строки (однострочные и многострочные), целые числа в десятичной/шестнадцатеричной/восьмеричной/двоичной системе с разделителями подчеркивания, числа с плавающей запятой в научной нотации, inf, -inf, nan, логические значения, даты и время.
• Вложенные структуры — таблицы, подтаблицы ([a.b.c]), массивы таблиц ([[a]]), встроенные таблицы ({ a = 1, b = 2 }) и ключи с точками.
• Четыре стиля вывода — красивый с 2 пробелами, красивый с 4 пробелами, компактный (минифицированный) и с отсортированными ключами для удобства сравнения версий.
• Визуальное дерево структуры — посмотрите, как конструкции TOML становятся объектами и массивами JSON с индикаторами типов (table, AoT, array, string, number, bool).
• Панель статистики — количество таблиц, ключей, массивов, массивов таблиц, глубина, а также количество символов на входе и выходе.
• Сообщения об ошибках с указанием строк — каждая ошибка парсинга включает точный номер строки для мгновенного исправления.
• Библиотека примеров в один клик — загружайте примеры в стиле Cargo.toml, pyproject, конфигурации приложения, чисел или многострочных строк.
• Копирование и загрузка — скопируйте JSON в буфер обмена или скачайте как файл .json.
• Мобильная адаптивность — удобно работает на телефонах, планшетах и компьютерах.
• Данные не покидают ваш запрос — TOML анализируется на стороне сервера, и результат возвращается в том же ответе; ничего не сохраняется.

Как TOML соотносится с JSON

Большинство конструкций TOML имеют чистый эквивалент в JSON без потерь данных. Вот схема сопоставления, которую применяет конвертер:

Примеры

title = "App"
[server]
host = "localhost"
port = 8080

{
  "title": "App",
  "server": {
    "host": "localhost",
    "port": 8080
  }
}

[[user]]
name = "Alice"
admin = true

[[user]]
name = "Bob"
admin = false

{
  "user": [
    { "name": "Alice", "admin": true },
    { "name": "Bob",   "admin": false }
  ]
}

db.host = "10.0.0.1"
db.port = 5432
db.options = { ssl = true, pool = 20 }

{
  "db": {
    "host": "10.0.0.1",
    "port": 5432,
    "options": { "ssl": true, "pool": 20 }
  }
}

Как пользоваться конвертером TOML в JSON

1. Вставьте ваш TOML в поле ввода или нажмите на кнопку «Быстрый пример», чтобы загрузить типичную конфигурацию.
2. Выберите стиль вывода — красивый с 2 пробелами (по умолчанию), красивый с 4 пробелами, компактный или с отсортированными ключами.
3. Нажмите «Конвертировать в JSON». Инструмент проанализирует TOML и выведет JSON вместе со статистикой и деревом структуры.
4. Изучите результат — просмотрите панель статистики для быстрого обзора, разверните дерево структуры, чтобы увидеть иерархию, и ознакомьтесь с диаграммой преобразования.
5. Скопируйте или скачайте JSON. Кнопка «Копировать» поместит его в буфер обмена, а «Скачать» сохранит как converted.json.

Поддерживаемые функции TOML

Строки

• Базовые строки используют двойные кавычки и поддерживают escape-последовательности: \n, \t, \r, \", \\, \uXXXX, \UXXXXXXXX.
• Литеральные строки используют одинарные кавычки и содержат необработанные символы без экранирования.
• Многострочные базовые строки используют тройные двойные кавычки (""") и поддерживают обратный слеш в конце строки для обрезки пробелов.
• Многострочные литеральные строки используют тройные одинарные кавычки (''') и сохраняют всё дословно.

Числа

• Десятичные целые числа с необязательными разделителями подчеркивания: 1_000_000.
• Шестнадцатеричные/восьмеричные/двоичные целые числа: 0xDEADBEEF, 0o755, 0b1010.
• Числа с плавающей запятой с необязательным знаком, десятичной дробью и экспонентой: 3.14, -2e-3, 6.022e23.
• Специальные числа: inf, -inf, nan (конвертируются в JSON null).

Таблицы и массивы

• Таблицы: [name] открывает новую таблицу.
• Подтаблицы: [a.b.c] создает вложенные таблицы.
• Массивы таблиц: [[name]] добавляет новую таблицу в массив.
• Встроенные таблицы: { a = 1, b = 2 }.
• Массивы: [1, 2, 3] могут занимать несколько строк и содержать смешанные типы значений.

Выбор правильного стиля вывода

• Pretty 2-space — по умолчанию. Компактный, но читаемый; идеально подходит для большинства случаев, включая конфигурационные файлы в git.
• Pretty 4-space — соответствует отступам в стиле PEP-8; предпочтительно для некоторых команд разработчиков на Python и Java.
• Compact (минифицированный) — одна строка, без лишних пробелов; минимальный размер данных для передачи по сети.
• Sorted keys — красивый вывод с ключами, отсортированными по алфавиту. Отлично подходит для сравнения файлов (diff), так как идентичные конфигурации всегда дают одинаковый результат независимо от порядка ключей.

Часто задаваемые вопросы

Что такое TOML и зачем конвертировать его в JSON?

TOML — это формат конфигурации, разработанный как очевидный и минималистичный. Конвертация в JSON позволяет использовать конфигурации в системах, работающих только с JSON, визуально отлаживать вложенные структуры, обмениваться данными с веб-API и интегрироваться с кодом JavaScript.

Обрабатывает ли этот конвертер массивы таблиц и встроенные таблицы?

Да. Конвертер полностью поддерживает синтаксис [[array.of.tables]] (преобразуется в массивы объектов JSON), встроенные таблицы типа { a = 1, b = 2 } (преобразуются в объекты JSON), вложенные подтаблицы, ключи с точками и любую глубину вложенности.

Какие стили вывода поддерживаются?

Четыре стиля: Pretty 2-space (по умолчанию), Pretty 4-space, Compact (минифицированный JSON) и Sorted Keys (для удобного сравнения версий).

Как даты TOML конвертируются в JSON?

Поскольку в JSON нет нативного типа даты, даты TOML (RFC 3339) сохраняются как строки. Все форматы дат и времени сохраняются дословно для последующей обработки.

Что происходит со значениями inf и nan?

Стандартный JSON не поддерживает Infinity или NaN, поэтому они преобразуются в null. Это гарантирует соответствие результата стандарту RFC 8259.

Откуда берутся ошибки парсинга и как их исправить?

Конвертер указывает строку и причину ошибки. Обычно это незакрытые кавычки, дублирующиеся ключи или ошибки в структуре массивов и таблиц.

Есть ли ограничение по размеру?

Инструмент легко справляется с файлами TOML размером в несколько мегабайт. Для очень больших файлов производительность больше зависит от рендеринга в браузере, чем от парсинга.

Передаются ли мои данные куда-либо?

Ваш ввод обрабатывается на стороне сервера для генерации JSON и сразу удаляется. Мы не храним и не передаем ваши конфигурации.

Можно ли конвертировать JSON обратно в TOML?

Этот инструмент работает только в одну сторону (TOML → JSON). Для обратного преобразования используйте специализированные библиотеки, такие как tomli_w для Python или toml для Rust.

Советы по чистой конвертации

• Используйте отсортированные ключи для diff — это сделает ваш JSON стабильным для систем контроля версий.
• Используйте многострочные строки (""" или ''') для больших блоков текста вместо экранирования \n.
• Группируйте связанные ключи в таблицы — это читается лучше, чем длинные цепочки ключей с точками.
• Следите за переопределением таблиц — TOML запрещает определять одну и ту же таблицу дважды.
• Придерживайтесь RFC 3339 для дат — это обеспечит лучшую совместимость с потребителями JSON.

Дополнительные ресурсы

• Официальная спецификация TOML
• TOML в Википедии
• JSON.org — введение в JSON
• RFC 8259 — Формат обмена данными JSON