JSON zu TOML Konverter

Was ist TOML und warum aus JSON konvertieren?

// Convert JSON to TOML in Node.js using the smol-toml library
import { stringify } from 'smol-toml';

const data = JSON.parse(`{
  "package": { "name": "my-app", "version": "1.0.0" },
  "dependencies": { "serde": { "version": "1.0" } }
}`);

// The top-level value must be an object; null values on objects are dropped.
const toml = stringify(data);

console.log(toml);
// [package]
// name = "my-app"
// version = "1.0.0"
//
// [dependencies.serde]
// version = "1.0"

Hauptfunktionen

Beispiele

{
  "package": {
    "name": "my-app",
    "version": "1.0.0",
    "edition": "2021"
  },
  "dependencies": {
    "serde": { "version": "1.0", "features": ["derive"] },
    "tokio": { "version": "1", "features": ["full"] }
  }
}

{
  "build-system": {
    "requires": ["hatchling"],
    "build-backend": "hatchling.build"
  },
  "project": {
    "name": "my-package",
    "version": "0.3.1",
    "requires-python": ">=3.10",
    "dependencies": ["requests>=2.31", "pydantic>=2.0"]
  }
}

{
  "title": "My Service",
  "debug": false,
  "port": 8080,
  "database": {
    "host": "localhost",
    "port": 5432,
    "pool_size": 10
  },
  "features": ["auth", "metrics", "tracing"]
}

{
  "servers": [
    { "name": "alpha", "ip": "10.0.0.1", "ports": [8001, 8002] },
    { "name": "beta", "ip": "10.0.0.2", "ports": [9001] }
  ]
}

{
  "build": {
    "command": "npm run build",
    "publish": "dist",
    "environment": { "NODE_VERSION": "20" }
  },
  "redirects": [
    { "from": "/old", "to": "/new", "status": 301, "force": true }
  ]
}

{
  "tool": {
    "ruff": { "line-length": 100, "target-version": "py310" },
    "black": { "line-length": 100 }
  }
}

Anleitung

1. 1

   JSON einfügen

   Geben Sie Ihr JSON in das Eingabefeld oben ein oder fügen Sie es ein. Sie können auch auf 'Beispiel laden' klicken, um eine Cargo.toml-Quelle, pyproject.toml-Quelle oder ein Objekt mit App-Einstellungen auszuprobieren.

2. 2

   Live-TOML-Ausgabe sehen

   TOML erscheint sofort im Ausgabebereich. Wenn Ihr JSON ein Array auf oberster Ebene oder null-Werte enthält, erklärt das Tool genau, was zu tun ist, anstatt fehlerhafte Ausgabe zu erzeugen.

3. 3

   Kopieren oder herunterladen

   Klicken Sie auf Kopieren, um das TOML in die Zwischenablage zu übernehmen, oder auf Herunterladen, um es als .toml-Datei zu speichern, bereit für Cargo, Poetry, Hugo, Netlify oder jedes Tool, das TOML liest.

Häufige JSON-zu-TOML-Fallstricke

[1, 2, 3]

{ "items": [1, 2, 3] }

{ "name": "a", "nickname": null }

{ "name": "a", "nickname": "" }

{ "ports": [8001, null, 8003] }

{ "ports": [8001, 8003] }

{ 'name': 'a', 'active': true, }

{ "name": "a", "active": true }

{ "ratio": 1.0 }  →  ratio = 1

{ "ratio": 1.5 }  →  ratio = 1.5

{ "server": { "a": 1 }, "server": [1] }

{ "server": { "a": 1 }, "servers": [1] }

Häufige Anwendungsfälle

Cargo.toml erzeugen

Verwandeln Sie strukturiertes JSON — von einem Scaffolding-Tool, einer API oder einem Skript — in eine gültige Rust-Cargo.toml, wobei verschachtelte [dependencies]-Tabellen und Inline-Tabellen automatisch erzeugt werden.

pyproject.toml erzeugen

Konvertieren Sie JSON-Projekt-Metadaten in eine PEP-621-pyproject.toml, einschließlich punktierter [tool.*]-Tabellen, sodass Tooling, das JSON ausgibt, Python-Packaging-Konfiguration erzeugen kann.

Von Menschen bearbeitbare Konfiguration aus JSON

Verwandeln Sie die JSON-Einstellungen einer Anwendung in eine gut lesbare TOML-Konfigurationsdatei, die Menschen bequem bearbeiten können, wobei Kommentare nachträglich von Hand hinzugefügt werden.

Erzeugung von Deployment-Konfigurationen

Erzeugen Sie netlify.toml, foundry.toml oder ähnliche Plattform-Konfigurationen aus JSON, indem verschachtelte Objekte und Arrays von Objekten in die Tabellen und Tabellen-Arrays umgewandelt werden, die diese Tools erwarten.

Migration des Konfigurationsformats

Verschieben Sie Konfiguration von einem JSON-basierten System zu einem TOML-basierten, indem Sie diesen Konverter als Brücke nutzen und die null- und Top-Level-Warnungen verwenden, um alles abzufangen, was sich nicht abbilden lässt.

TOML-Struktur prototypisieren

Skizzieren Sie eine Konfiguration als JSON — ein Format, das die meisten Entwickler flüssig tippen — und konvertieren Sie dann nach TOML, um das idiomatische Layout aus Tabellen und Tabellen-Arrays zu sehen, bevor Sie es in ein Repository übernehmen.

Technische Details

RFC-8259-JSON-Parsing

Die JSON-Eingabe wird mit dem nativen JSON.parse() des Browsers geparst, das vollständig RFC-8259-konform ist. Vor der Serialisierung prüft das Tool, dass der Wert auf oberster Ebene ein Objekt ist, und durchsucht es nach null-Werten, um vor verworfenen Objektschlüsseln zu warnen oder ein null innerhalb eines Arrays mit einem präzisen Pfad abzulehnen.

TOML-1.0.0-Ausgabe über smol-toml

TOML wird mit der smol-toml-Bibliothek erzeugt, einem abhängigkeitsfreien, vollständig TOML-1.0.0-konformen Serialisierer. Verschachtelte Objekte werden zu Tabellen, tief verschachtelte Objekte zu punktierten Tabellen, und Arrays von Objekten zu Tabellen-Arrays. Gleitkommazahlen mit einem Nachkommateil von null werden gemäß den TOML-Regeln als Ganzzahlen geschrieben, mit einer Warnung.

100% browserbasiert — kein Upload, kein Server

Die gesamte Verarbeitung findet in der JavaScript-Engine Ihres Browsers statt. Zu keinem Zeitpunkt werden Daten übertragen. Eingaben über 200 KB wechseln vom Live- in den manuellen Modus (ein expliziter Klick auf Konvertieren), damit die Oberfläche reaktionsfähig bleibt.

Bewährte Praktiken

Arrays auf oberster Ebene unter einem Schlüssel einpacken

Wenn Ihre Daten von Natur aus ein JSON-Array sind, packen Sie sie vor der Konvertierung in ein Objekt mit einem aussagekräftigen Schlüssel ein ({ "items": [...] }). TOML-Dokumente müssen an der Wurzel eine Tabelle sein, und der Schlüssel gibt Ihrem Array in der Ausgabe einen klaren Namen.

Entscheiden, was null-Werte bedeuten sollen

Entscheiden Sie vor der Konvertierung, ob ein null-Feld verschwinden (den Schlüssel verwerfen) oder einen Wert tragen soll. TOML verwirft null-Werte in Objekten und lehnt null-Werte in Arrays ab, sodass ein vorheriges Auflösen in Ihrem JSON für vorhersehbare, vollständige Ausgabe sorgt.

Verschachtelte Objekte zur Gruppierung verwenden

Gruppieren Sie zusammengehörige Einstellungen in verschachtelten Objekten in Ihrem JSON — sie werden in TOML zu sauberen [Tabellen] und punktierten Tabellen, was weitaus lesbarer ist als eine flache Schlüsselliste und der Organisation von Cargo- und pyproject-Konfigurationen entspricht.

Ihr JSON zuerst validieren

Wenn Ihr JSON von Hand geschrieben ist oder aus einer unzuverlässigen Quelle stammt, validieren Sie es mit unserem JSON Formatierer, um nachgestellte Kommas und Fehler bei Anführungszeichen zu erkennen, bevor Sie nach TOML konvertieren.

Kommentare nach der Konvertierung hinzufügen

JSON hat keine Kommentare, daher werden keine übernommen. Da TOML #-Kommentare unterstützt, fügen Sie dem erzeugten TOML von Hand Dokumentation hinzu — einer der Hauptgründe, von Menschen bearbeitete Konfiguration überhaupt nach TOML zu verschieben.

Häufig gestellte Fragen