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 не може представити безпосередньо: datetime зі зміщенням, локальний datetime, локальна дата та локальний час. У 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 також підтримує значення infinity та 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

Часті запитання