JSON to TOML

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

Конвертация JSON в TOML преобразует данные из формата JavaScript Object Notation в Tom's Obvious Minimal Language. JSON использует фигурные скобки, квадратные скобки и ключи в кавычках для представления структурированных данных. TOML использует плоский синтаксис «ключ-значение» с заголовками секций (называемых таблицами), который читается как INI-файл, но со строгой типизацией. TOML был разработан специально для конфигурационных файлов, где удобочитаемость для человека важнее машинного обмена данными.

TOML стал стандартным форматом конфигурации для Rust (Cargo.toml), пакетирования Python (pyproject.toml), статических сайтов Hugo, настроек развёртывания Netlify и многих инструментов командной строки. Когда исходные данные существуют в формате JSON — из ответа API, экспортированного конфига или сгенерированного файла — а целевая система ожидает TOML, нужен конвертер, который преобразует объекты JSON в таблицы TOML, массивы JSON в массивы TOML и точно сохраняет каждый тип данных.

Конвертация JSON в TOML онлайн — это самый быстрый способ создать корректный TOML из существующих данных JSON. Конвертер автоматически обрабатывает сопоставление типов: строки JSON становятся строками TOML, числа JSON — целыми числами или числами с плавающей точкой TOML, булевы значения JSON отображаются напрямую, а объекты JSON становятся таблицами TOML. Исключение составляет null — в TOML нет типа null, поэтому значения null либо опускаются, либо преобразуются в пустые строки в зависимости от конвертера.

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

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

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

Сравнение JSON и TOML

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

Подводные камни конвертации в TOML

В TOML есть правила, отличающиеся от JSON, которые влияют на результат конвертации. Эти четыре проблемы вызывают наибольшую путаницу.

Примеры кода

Программная конвертация JSON в TOML требует библиотеки сериализации TOML в большинстве языков. Стандартные библиотеки разбирают JSON; для вывода TOML нужен отдельный пакет.

import { stringify } from '@iarna/toml'

const json = '{"title":"My App","database":{"host":"localhost","port":5432}}'
const obj = JSON.parse(json)
const toml = stringify(obj)
console.log(toml)
// → title = "My App"
// →
// → [database]
// → host = "localhost"
// → port = 5432

import json
import tomli_w  # pip install tomli_w

json_str = '{"title": "My App", "database": {"host": "localhost", "port": 5432}}'
data = json.loads(json_str)
toml_str = tomli_w.dumps(data)
print(toml_str)
# → title = "My App"
# →
# → [database]
# → host = "localhost"
# → port = 5432

package main

import (
    "encoding/json"
    "fmt"
    "github.com/pelletier/go-toml/v2"
)

func main() {
    jsonStr := `{"title":"My App","database":{"host":"localhost","port":5432}}`
    var data map[string]interface{}
    json.Unmarshal([]byte(jsonStr), &data)

    tomlBytes, _ := toml.Marshal(data)
    fmt.Println(string(tomlBytes))
    // → title = 'My App'
    // →
    // → [database]
    // → host = 'localhost'
    // → port = 5432
}

# Using yj (https://github.com/sclevine/yj)
echo '{"title":"My App","port":3000}' | yj -jt
# → title = "My App"
# → port = 3000

# Using remarshal (pip install remarshal)
echo '{"title":"My App","port":3000}' | remarshal -if json -of toml
# → title = "My App"
# → port = 3000

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