JSON to TOML

Was ist die JSON-zu-TOML-Konvertierung?

Die JSON-zu-TOML-Konvertierung überführt Daten aus JavaScript Object Notation in Tom's Obvious Minimal Language. JSON verwendet geschweifte Klammern, eckige Klammern und Schlüssel in Anführungszeichen, um strukturierte Daten darzustellen. TOML verwendet eine flache Schlüssel-Wert-Syntax mit Abschnittsheadern (sogenannte Tables), die wie eine INI-Datei aussieht, aber strikte Typisierung bietet. TOML wurde speziell für Konfigurationsdateien entwickelt, bei denen menschliche Lesbarkeit wichtiger ist als der maschinelle Datenaustausch.

TOML ist das Standard-Konfigurationsformat für Rust (Cargo.toml), Python-Pakete (pyproject.toml), Hugo-Static-Sites, Netlify-Deployment-Einstellungen und viele CLI-Tools. Wenn deine Quelldaten als JSON vorliegen — aus einer API-Antwort, einer exportierten Konfiguration oder einer generierten Datei — und dein Zielsystem TOML erwartet, benötigst du einen Konverter, der JSON-Objekte auf TOML-Tables, JSON-Arrays auf TOML-Arrays abbildet und jeden Datentyp korrekt erhält.

Die Online-Konvertierung von JSON nach TOML ist der schnellste Weg, aus bestehenden JSON-Daten gültiges TOML zu erzeugen. Die Konvertierung übernimmt die Typzuordnung automatisch: JSON-Strings werden zu TOML-Strings, JSON-Zahlen zu TOML-Integer oder Floats, JSON-Booleans werden direkt übernommen, und JSON-Objekte werden zu TOML-Tables. Die einzige Ausnahme ist null — TOML kennt keinen null-Typ, daher werden null-Werte je nach Konverter entweder weggelassen oder in leere Strings umgewandelt.

Warum diesen JSON-zu-TOML-Konverter verwenden?

TOML ist das, was Konfigurationsdateien erwarten; JSON ist das, was APIs und Tools produzieren. Dieser Konverter überbrückt die Lücke, damit du Daten zwischen den beiden Formaten verschieben kannst, ohne manuell neu zu schreiben.

JSON-zu-TOML-Anwendungsfälle

JSON vs. TOML — Vergleich

JSON und TOML überschneiden sich in ihren Möglichkeiten, unterscheiden sich aber in Syntax, Typunterstützung und dem vorgesehenen Einsatzbereich. Diese Tabelle zeigt die Unterschiede, die die Konvertierung beeinflussen.

TOML-Konvertierungsfallstricke

TOML hat Regeln, die sich von JSON unterscheiden und die Konvertierungsausgabe beeinflussen. Diese vier Punkte verursachen die meiste Verwirrung.

Code-Beispiele

Die programmatische Konvertierung von JSON nach TOML erfordert in den meisten Sprachen eine TOML-Serialisierungsbibliothek. Standard-Bibliotheken übernehmen das JSON-Parsing; für die TOML-Ausgabe wird ein dediziertes Paket benötigt.

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

Häufig gestellte Fragen