TOML to JSON

Что такое конвертация TOML в JSON?

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

JSON (JavaScript Object Notation), определённый стандартом RFC 8259, является наиболее распространённым форматом обмена данными. Тогда как TOML ставит во главу угла читаемость благодаря минималистичному синтаксису и поддержке комментариев, JSON ориентирован на машинную совместимость. Конвертер TOML в JSON устраняет это различие: он разбирает входные данные TOML согласно спецификации TOML v1.0.0 и формирует структурно эквивалентный JSON-документ. Конвертация сохраняет все данные: строки, целые числа, числа с плавающей точкой, булевы значения, массивы и таблицы напрямую отображаются в соответствующие типы JSON.

TOML имеет четыре собственных типа даты и времени, которые JSON не может представить напрямую: date-time со смещением, локальный date-time, локальная дата и локальное время. В JSON нет типа даты, поэтому при конвертации эти значения сериализуются как строки ISO 8601.

Зачем использовать конвертер TOML в JSON?

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

Сценарии использования TOML в JSON

Справочник по соответствию типов TOML и JSON

Каждый тип TOML имеет прямой эквивалент в JSON, за единственным исключением: значения даты и времени. Таблица ниже показывает, как каждый тип TOML конвертируется в JSON. Это соответствие следует спецификации TOML v1.0.0 и соответствует поведению стандартных парсеров: tomllib (Python), toml-rs (Rust) и @iarna/toml (Node.js).

Целые числа TOML поддерживают символы подчёркивания для удобочитаемости (например, 1_000_000), а также шестнадцатеричные (0xDEADBEEF), восьмеричные (0o755) и двоичные (0b11010110) литералы. Все они конвертируются в обычные десятичные числа в JSON. TOML также поддерживает значения бесконечности и NaN для чисел с плавающей точкой, однако они не имеют представления в JSON и вызовут ошибку конвертации в строгом режиме.

Примеры кода

Рабочие примеры конвертации TOML в JSON на четырёх языках. Каждый пример читает TOML-файл, разбирает его и выводит отформатированный JSON.

import { parse } from '@iarna/toml'
import fs from 'fs'

const toml = fs.readFileSync('config.toml', 'utf8')
const json = parse(toml)
console.log(JSON.stringify(json, null, 2))
// Input:  [server]
//         host = "localhost"
//         port = 8080
// Output: { "server": { "host": "localhost", "port": 8080 } }

import tomllib   # Python 3.11+ (standard library)
import json

with open('config.toml', 'rb') as f:
    data = tomllib.load(f)

print(json.dumps(data, indent=2, default=str))
# Dates become strings: "1979-05-27"
# Arrays of tables become JSON arrays of objects

package main

import (
    "encoding/json"
    "fmt"
    "os"

    "github.com/BurntSushi/toml"
)

func main() {
    var data map[string]any
    _, err := toml.DecodeFile("config.toml", &data)
    if err != nil {
        panic(err)
    }
    out, _ := json.MarshalIndent(data, "", "  ")
    fmt.Println(string(out))
}

# Using yj (YAML/JSON/TOML converter)
cat config.toml | yj -tj

# Using dasel
dasel -f config.toml -r toml -w json

# Using Python one-liner (3.11+)
python3 -c "import tomllib, json, sys; print(json.dumps(tomllib.load(sys.stdin.buffer), indent=2, default=str))" < config.toml

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