YAML / JSON / TOML-Konverter

Strukturierte Datenformate im Überblick: YAML, JSON und TOML

Strukturierte Datenformate bilden das Fundament für den Datenaustausch über Programmierschnittstellen (APIs) und die Definition von Anwendungskonfigurationen. Jedes Format besitzt spezifische Eigenschaften, die für unterschiedliche Einsatzzwecke in der Softwareentwicklung und Systemadministration optimiert sind:

• JSON (JavaScript Object Notation): Weit verbreitet im Web und in der API-Kommunikation. Es zeichnet sich durch eine strikte, klammerbasierte Syntax aus, die von Maschinen extrem schnell analysiert werden kann.
• YAML (YAML Ain't Markup Language): Häufig genutzt für Konfigurationsdateien, CI/CD-Pipelines und Deployment-Konfigurationen. Es setzt auf Einrückungen mittels Leerzeichen anstelle von Klammern, was die Lesbarkeit für Menschen erhöht.
• TOML (Tom's Obvious, Minimal Language): Optimiert für Konfigurationsdateien, die einfach zu schreiben und zu lesen sind. TOML organisiert Daten in Tabellen und Schlüssel-Wert-Paaren.

Der Wechsel zwischen diesen Formaten ist im Entwicklungsalltag häufig notwendig, beispielsweise bei der Migration von Konfigurationen, der Integration neuer APIs oder der Aufbereitung von Datenstrukturen für unterschiedliche Werkzeuge.

Funktionsweise der Konvertierung im Browser

Die Konvertierung strukturierter Daten erfolgt durch das Einlesen des Ausgangsformats in einen internen abstrakten Syntaxbaum (Abstract Syntax Tree) und das anschließende Schreiben dieses Baums in das gewünschte Zielformat.

Bei diesem Prozess werden die Datenwerte analysiert und strukturell neu aufgebaut. Dies hat direkte Auswirkungen auf die Formatierung: Kommentare und die ursprünglichen Abstände aus der Eingabe werden bei der Konvertierung nicht übernommen. Das Tool liest ausschließlich die reinen Datenwerte und schreibt ein sauberes, standardkonformes neues Dokument.

Für die Formatierung der Ausgabe in JSON oder YAML kann die Einrückung angepasst werden. Hierbei stehen Optionen für eine Einrückung von 2 oder 4 Leerzeichen zur Verfügung.

Einschränkungen und Besonderheiten bei TOML

Bei der Konvertierung in das TOML-Format gilt eine wichtige strukturelle Einschränkung: TOML erfordert zwingend eine Tabelle auf oberster Ebene (ein Root-Objekt).

Während JSON und YAML auch isolierte Werte wie einen einzelnen String, eine Zahl oder ein einfaches Array als gültiges Gesamtdokument darstellen können, ist dies in TOML nicht zulässig. Ein solches Dokument lässt sich nicht als gültiges TOML-Dokument schreiben. Wenn versucht wird, Daten ohne ein übergeordnetes Objekt in TOML umzuwandeln, bricht der Vorgang ab.

Bedienung des Konverters

Das Werkzeug ermöglicht die Transformation direkt über eine grafische Benutzeroberfläche:

1. Wählen Sie unter Eingabeformat das Format der Ausgangsdaten (YAML, JSON oder TOML).
2. Wählen Sie unter Ausgabeformat das gewünschte Zielformat.
3. Fügen Sie Ihre Daten in das Feld Eingabe ein (Platzhalter: "Fügen Sie YAML, JSON oder TOML ein...").
4. Passen Sie bei Bedarf die Einrückung (2 oder 4 Leerzeichen) an.
5. Klicken Sie auf Konvertieren, um die Transformation zu starten.

Über die Schaltfläche Tauschen können Sie die gewählten Formate schnell wechseln. Die Schaltfläche Beispiel lädt eine vordefinierte Datenstruktur, während Leeren alle Felder zurücksetzt. Das fertige Ergebnis kann über die Schaltfläche Herunterladen direkt als Datei gespeichert werden.

Nach einer erfolgreichen Konvertierung zeigt das Tool statistische Metadaten an:

• Eingabe: Anzahl der Zeichen im Ausgangstext.
• Ausgabe: Anzahl der Zeichen im konvertierten Text.
• Wurzel: Information über das Root-Element der Datenstruktur.
• Einträge: Anzahl der analysierten Dateneinträge.

Datenschutz und Client-Side-Verarbeitung

Ihre YAML-, JSON- und TOML-Daten werden direkt in Ihrem Browser konvertiert. Es wird nichts an BroBroGo übertragen. Da die gesamte Verarbeitung lokal im Client stattfindet, verlassen sensible Konfigurationsdaten oder API-Antworten zu keinem Zeitpunkt Ihr Endgerät.

Fehlerbehebung und Validierungsmeldungen

Das Tool validiert die Eingabe während des Prozesses und gibt bei Fehlern präzise Rückmeldungen aus:

• Leere Eingabe: Wenn keine Daten vorhanden sind, erscheint die Meldung "Fügen Sie zuerst eine Eingabe ein.".
• Identische Formate: Wenn Eingabe- und Ausgabeformat gleich sind, zeigt das Tool "Wählen Sie zwei verschiedene Formate.".
• Größenbeschränkung: Die Eingabe ist auf unter 2.000.000 Zeichen begrenzt. Bei Überschreitung erscheint "Diese Eingabe ist zu groß für dieses Tool. Bitte halten Sie sie unter {max} Zeichen.".
• Fehlerhafte Syntax: Kann die Struktur nicht gelesen werden, meldet das Tool "Dieses JSON konnte nicht analysiert werden.", "Dieses YAML konnte nicht analysiert werden." oder "Dieses TOML konnte nicht analysiert werden.".
• TOML-Kompatibilität: Wenn die Datenstruktur kein Root-Objekt besitzt, erscheint "Diese Daten können nicht als gültiges TOML geschrieben werden.".
• Zeitüberschreitung: Dauert die Verarbeitung zu lange, wird "Diese Konvertierung dauert zu lange. Versuchen Sie es mit einer kleineren Eingabe." ausgegeben.
• Allgemeiner Fehler: Bei sonstigen Problemen erscheint "Diese Eingabe konnte nicht konvertiert werden.".

FAQ

Welche Konvertierungen werden unterstützt? Sie können beliebig zwischen YAML, JSON und TOML konvertieren. Wählen Sie einfach vor der Konvertierung oben das Eingabe- und Ausgabeformat aus.

Warum können manche Werte nicht in TOML umgewandelt werden? TOML-Dateien erfordern eine Tabelle auf oberster Ebene. Ein einzelner String, eine Zahl oder ein Array können zwar in JSON oder YAML umgewandelt werden, aber nicht als gültiges TOML-Dokument geschrieben werden.

Bleiben Kommentare erhalten? Nein. Der Konverter liest die Datenwerte und schreibt ein sauberes neues Dokument. Kommentare und die ursprüngliche Formatierung werden daher nicht übernommen.