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 та багатьох CLI-інструментів. Коли вихідні дані існують у форматі 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 у 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

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