TOML to JSON

Was ist TOML-zu-JSON-Konvertierung?

TOML (Tom's Obvious Minimal Language) ist ein Konfigurationsdateiformat, das für Menschen lesbar gestaltet wurde. Es bildet eindeutig auf eine Hash-Tabelle ab, unterstützt verschachtelte Tabellen, typisierte Werte und Inline-Kommentare. Viele Tools und Frameworks verwenden TOML als primäres Konfigurationsformat: Rust-Projekte setzen auf Cargo.toml, Python-Pakete verwenden pyproject.toml und Hugo-Static-Sites werden über config.toml konfiguriert. Die Online-Konvertierung von TOML zu JSON ermöglicht es, diese Konfigurationsdateien in ein Format umzuwandeln, das nahezu jede Programmiersprache, API und Datenpipeline nativ verarbeiten kann.

JSON (JavaScript Object Notation), definiert durch RFC 8259, ist das am weitesten verbreitete Datenaustauschformat. Während TOML mit seiner minimalen Syntax und Kommentarunterstützung die menschliche Lesbarkeit priorisiert, steht bei JSON die maschinelle Interoperabilität im Vordergrund. Ein TOML-zu-JSON-Konverter überbrückt diese Lücke, indem er TOML-Eingaben gemäß der TOML v1.0.0-Spezifikation parst und ein strukturell äquivalentes JSON-Dokument ausgibt. Die Konvertierung erhält alle Daten: Strings, Integer, Floats, Booleans, Arrays und Tabellen werden direkt auf ihre JSON-Entsprechungen abgebildet.

TOML verfügt über vier native Datums-/Zeittypen, die JSON nicht direkt darstellen kann: Offset-Datums-/Zeitangaben, lokale Datums-/Zeitangaben, lokale Datumsangaben und lokale Zeitangaben. Da JSON keinen Datumstyp kennt, werden diese Werte bei der Konvertierung als ISO 8601-Strings serialisiert.

Warum einen TOML-zu-JSON-Konverter verwenden?

In TOML geschriebene Konfigurationsdateien müssen häufig in Systeme eingespeist werden, die nur JSON akzeptieren. Anstatt die Datei manuell umzuschreiben oder eine Parser-Bibliothek lokal zu installieren, erledigt ein browserbasierter Konverter die Umwandlung in Sekundenschnelle.

Anwendungsfälle für TOML zu JSON

TOML-zu-JSON-Typzuordnung als Referenz

Jeder TOML-Typ hat eine direkte JSON-Entsprechung – mit einer Ausnahme: Datums- und Zeitwerte. Die nachstehende Tabelle zeigt, wie jeder TOML-Typ in JSON konvertiert wird. Diese Zuordnung folgt der TOML v1.0.0-Spezifikation und entspricht dem Verhalten gängiger Parser wie tomllib (Python), toml-rs (Rust) und @iarna/toml (Node.js).

TOML-Integer unterstützen Unterstriche für bessere Lesbarkeit (z. B. 1_000_000) sowie hexadezimale (0xDEADBEEF), oktale (0o755) und binäre (0b11010110) Literale. Alle werden in JSON als dezimale Zahlen dargestellt. TOML unterstützt außerdem Infinity- und NaN-Float-Werte, die jedoch keine JSON-Entsprechung haben und im strikten Modus einen Konvertierungsfehler verursachen.

Code-Beispiele

Funktionierende Beispiele für die TOML-zu-JSON-Konvertierung in vier Sprachen. Jedes liest eine TOML-Datei, parst sie und gibt formatierten JSON-Output aus.

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

Häufig gestellte Fragen