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

Что такое TOML и зачем преобразовывать в JSON?

// Convert TOML to JSON in Node.js using the smol-toml library
import { parse } from 'smol-toml';

const toml = `
[package]
name = "my-app"
version = "1.0.0"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
`;

const data = parse(toml);
const json = JSON.stringify(data, null, 2);

console.log(json);
// {
//   "package": { "name": "my-app", "version": "1.0.0" },
//   "dependencies": {
//     "serde": { "version": "1.0", "features": ["derive"] }
//   }
// }

Ключевые возможности

Примеры

[package]
name = "my-app"
version = "1.0.0"
edition = "2021"
authors = ["Jane Doe <jane@example.com>"]

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

[dev-dependencies]
criterion = "0.5"

[[bin]]
name = "my-app"
path = "src/main.rs"

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project]
name = "my-package"
version = "0.3.1"
requires-python = ">=3.10"
dependencies = [
  "requests>=2.31",
  "pydantic>=2.0"
]

[project.optional-dependencies]
dev = ["pytest>=8.0", "ruff>=0.4"]

[tool.ruff]
line-length = 100

[build]
command = "npm run build"
publish = "dist"

[build.environment]
NODE_VERSION = "20"

[[redirects]]
from = "/old-path"
to = "/new-path"
status = 301
force = true

[[headers]]
for = "/*"

[headers.values]
X-Frame-Options = "DENY"

baseURL = "https://example.org"
languageCode = "en-us"
title = "My Hugo Site"
theme = "ananke"

[params]
description = "A static site built with Hugo"
mainSections = ["posts", "docs"]

[[menu.main]]
name = "Blog"
url = "/posts/"
weight = 1

[[menu.main]]
name = "About"
url = "/about/"
weight = 2

edition = "2021"
max_width = 100
hard_tabs = false
tab_spaces = 4
newline_style = "Unix"
use_small_heuristics = "Default"
reorder_imports = true
reorder_modules = true

title = "Deployment Log"
last_deployed = 1979-05-27T07:32:00Z
release_date = 1979-05-27
maintenance_window = 02:00:00

[[servers]]
name = "alpha"
ip = "10.0.0.1"
ports = [8001, 8002]

[[servers]]
name = "beta"
ip = "10.0.0.2"
ports = [9001]

Как использовать

1. 1

   Вставьте свой TOML

   Введите или вставьте свой TOML в поле ввода выше. Также можно нажать «Загрузить пример», чтобы попробовать реальный Cargo.toml, pyproject.toml или конфигурацию развёртывания.

2. 2

   Смотрите живой вывод JSON

   JSON появляется мгновенно в панели вывода. Настройте параметр «Отступ» (2 или 4 пробела) под ваш целевой формат. Даты, таблицы и массивы таблиц обрабатываются автоматически.

3. 3

   Копируйте или скачивайте

   Нажмите «Копировать», чтобы поместить JSON в буфер обмена, или «Скачать», чтобы сохранить как файл .json, готовый для вашей программы, API или инструментов.

Частые подводные камни TOML

name = my-app

name = "my-app"

name = "a"
name = "b"

name = "a"
alt_name = "b"

released = 2026-7-2

released = 2026-07-02

ports = [8001, 8002

ports = [8001, 8002]

snowflake = 1420070400000000000

snowflake = "1420070400000000000"

[servers]
name = "a"
[servers]
name = "b"

[[servers]]
name = "a"
[[servers]]
name = "b"

Частые сценарии использования

Метаданные Rust Cargo

Преобразуйте Cargo.toml в JSON, чтобы строить панели зависимостей, проверять версии и фичи крейтов или передавать данные манифеста в скрипты и CI, ожидающие JSON вместо TOML.

Конфигурация проекта Python

Преобразуйте pyproject.toml в JSON, чтобы изучить метаданные проекта PEP 621, извлечь списки зависимостей или управлять инструментами, программно читающими конфигурацию упаковки.

Проверка конфигурации развёртывания

Преобразуйте netlify.toml, foundry.toml или другие конфигурации платформ в JSON, чтобы проверить редиректы, заголовки и настройки сборки или сгенерировать эквивалентную конфигурацию для другой платформы.

Миграция формата конфигурации

Преобразуйте конфигурацию приложения TOML в JSON при переходе на систему, предпочитающую JSON, или как промежуточный шаг перед дальнейшей обработкой инструментами JSON вроде jq.

Настройки статического сайта

Преобразуйте config.toml Hugo в JSON, чтобы перенести настройки сайта, сравнить конфигурацию разных сред или построить интерфейс настроек на основе JSON.

Ввод для API и скриптов

Превратите написанный человеком TOML в JSON, который REST API, бессерверная функция или скрипт автоматизации могут использовать напрямую, соединяя читаемую конфигурацию и машинный ввод.

Технические детали

Разбор TOML 1.0.0 через smol-toml

TOML разбирается библиотекой smol-toml — парсером без зависимостей, полностью совместимым с TOML 1.0.0. Он корректно обрабатывает вложенные таблицы, ключи с точками, встроенные таблицы, массивы таблиц, многострочные строки и все четыре типа дата-время, а также сообщает об ошибках разбора с указанием позиций строки и столбца.

Обработка дата-время без потерь и безопасных целых чисел

Дата-время TOML сериализуются в строки JSON, сохраняющие их точный вид (дата-время со смещением, локальное дата-время, локальная дата, локальное время). Целые числа за пределами безопасного диапазона JavaScript (2^53 - 1) при разборе повышаются до BigInt, затем преобразуются в ближайшее число JSON с предупреждением о точности, поэтому валидный TOML всегда преобразуется.

100% на стороне браузера — без загрузки, без сервера

Вся обработка происходит в движке JavaScript вашего браузера. Данные не передаются ни в какой момент. Ввод больше 200 КБ переключается с живого в ручной режим (явное нажатие «Конвертировать»), чтобы интерфейс оставался отзывчивым.

Лучшие практики

Храните очень большие целые числа как строки

Если в вашем TOML есть целые числа за пределами 2^53 - 1 (Snowflake ID, наносекундные метки времени, большие счётчики), заключите их в кавычки как строки перед преобразованием. Числа JSON в браузере не могут хранить их точно, и инструмент предупредит вас, когда придётся округлять.

Предпочитайте отступ в 2 пробела для вывода JSON

Отступ в два пробела — наиболее широко используемое соглашение для JSON, дающее чистый, читаемый вывод, который хорошо работает с большинством форматировщиков и инструментов сравнения. Оставьте отступ в 4 пробела для случаев, когда этого требует руководство по стилю.

Проверяйте вывод JSON перед использованием

После преобразования, если вы планируете вручную редактировать JSON или передавать его туда, где требования строгие, пропустите его через наш Форматировщик JSON, чтобы убедиться, что он валиден и единообразно отформатирован.

Храните комментарии TOML отдельно

В JSON нет синтаксиса комментариев, поэтому комментарии TOML с # удаляются при преобразовании. Если комментарии — важная документация, храните исходный TOML в системе контроля версий рядом со сгенерированным JSON.

Используйте массивы таблиц для повторяющихся секций

Когда у вас несколько похожих секций (серверы, редиректы, бинарники), пишите их как массивы таблиц ([[section]]), а не повторяйте [section]. Они преобразуются в чистый массив объектов JSON вместо того, чтобы вызывать ошибку дублирующейся таблицы.

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