Konwerter JSON do TOML

Czym jest konwersja JSON do TOML?

Konwersja JSON do TOML przekształca dane z formatu JavaScript Object Notation na format Tom's Obvious Minimal Language. JSON używa nawiasów klamrowych, nawiasów kwadratowych i kluczy w cudzysłowach do reprezentowania danych strukturalnych. TOML używa płaskiej składni klucz-wartość z nagłówkami sekcji (zwanymi tabelami), która przypomina plik INI, ale z rygorystycznym typowaniem. TOML został zaprojektowany specjalnie do plików konfiguracyjnych, gdzie czytelność dla człowieka jest ważniejsza niż wymiana maszynowa.

TOML stał się domyślnym formatem konfiguracji dla Rust (Cargo.toml), pakietowania Python (pyproject.toml), statycznych stron Hugo, ustawień wdrożenia Netlify i wielu narzędzi CLI. Gdy dane źródłowe istnieją jako JSON — z odpowiedzi API, wyeksportowanej konfiguracji lub wygenerowanego pliku — a docelowy system oczekuje TOML, potrzebny jest konwerter, który mapuje obiekty JSON na tabele TOML, tablice JSON na tablice TOML i dokładnie zachowuje każdy typ danych.

Konwersja JSON do TOML online to najszybszy sposób na wygenerowanie poprawnego TOML z istniejących danych JSON. Konwersja obsługuje mapowanie typów automatycznie: ciągi JSON stają się ciągami TOML, liczby JSON stają się liczbami całkowitymi lub zmiennoprzecinkowymi TOML, wartości logiczne są mapowane bezpośrednio, a obiekty JSON stają się tabelami TOML. Jedynym wyjątkiem jest null — TOML nie ma typu null, więc wartości null są pomijane lub konwertowane na puste ciągi w zależności od konwertera.

Dlaczego warto używać tego konwertera JSON do TOML?

TOML to format, którego oczekują pliki konfiguracyjne; JSON to format produkowany przez API i narzędzia. Ten konwerter wypełnia lukę, pozwalając przenosić dane między tymi dwoma formatami bez ręcznego przepisywania.

Przypadki użycia konwertera JSON do TOML

Porównanie JSON i TOML

JSON i TOML pokrywają się pod względem możliwości, ale różnią się składnią, obsługą typów i przeznaczeniem. Tabela poniżej pokazuje różnice wpływające na konwersję.

Pułapki konwersji TOML

TOML ma reguły różniące się od JSON w sposób wpływający na wynik konwersji. Te cztery problemy powodują najczęstsze nieporozumienia.

Przykłady kodu

Programowa konwersja JSON do TOML wymaga biblioteki do serializacji TOML w większości języków. Biblioteki standardowe parsują JSON; do generowania TOML potrzebny jest dedykowany pakiet.

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

Często zadawane pytania