TOML-in-JSON-Konverter

Was sind diese Datenformate?

Programme speichern strukturierte Daten wie Einstellungen, Datensätze und Listen in Textformaten, die jeweils eine eigene Schreibweise haben. Ein Konverter ist nützlich, wenn ein Programm Daten in einem Format ausgibt, das ein anderes Programm nicht lesen kann, oder wenn sich ein Format für die jeweilige Aufgabe leichter lesen oder bearbeiten lässt.

Beschreibung des Tools

Dieses Tool konvertiert Daten zwischen diesen 12 Formaten: JSON, YAML, XML, TOML, TOON, CSV, TSV, MessagePack, JSON5, JSONL, INI und Java-Properties. Alle Datenformatkonverter hier funktionieren auf die gleiche Weise – vom allgemeinen Datenformatkonverter bis hin zu Konvertern für einzelne Formatpaare wie JSON zu YAML, CSV zu JSON oder XML zu JSON: Beim Öffnen sind die Formate ausgewählt, die im Namen des Tools stehen. Über die Menüs „Quelle“ und „Ziel“ kannst du beliebige andere Formate auswählen. Füge deine Daten ein oder gib sie ein. Das Ergebnis erscheint während der Eingabe in einem Code-Editor mit Syntaxhervorhebung und kann direkt kopiert werden. Mit der Schaltfläche zum Vertauschen wird die Konvertierungsrichtung umgekehrt und das Ergebnis zur neuen Eingabe.

Ist die Eingabe im Quellformat ungültig, erklärt die Fehlermeldung, was nicht stimmt, üblicherweise mit Zeilen- und Spaltenangabe des Problems.

Deine Daten werden im Browser konvertiert und niemals hochgeladen.

Beispiel

Dieses JSON:

{
  "users": [
    { "id": 1, "name": "Ann", "admin": true },
    { "id": 2, "name": "Bo", "admin": false }
  ]
}

wird zu diesem YAML:

users:
  - id: 1
    name: Ann
    admin: true
  - id: 2
    name: Bo
    admin: false

zu diesem CSV mit einer Zeile pro Nutzer:

id,name,admin
1,Ann,true
2,Bo,false

und zu diesem TOON:

users[2]{id,name,admin}:
  1,Ann,true
  2,Bo,false

Wie die Formate ineinander umgewandelt werden

Nicht alle Formate können dieselben Datentypen speichern. Daher gelten bei manchen Konvertierungen die folgenden Regeln:

• CSV und TSV speichern Tabellen. Die erste Zeile enthält die Spaltennamen, jede weitere Zeile wird zu einem Objekt. Verschachtelte Objekte werden zu Spalten, deren Namen den jeweiligen Pfad angeben, und Listen werden als JSON-Text in ihrer Zelle gespeichert. So wird {"name": "Ann", "address": {"city": "Oslo"}, "tags": ["a", "b"]} zu den Spalten name, address.city und tags. Bei der Rückkonvertierung werden daraus wieder verschachtelte Objekte und Listen. Wenn die Daten ein Objekt mit einer einzelnen Liste sind, etwa {"users": [...]}, entsprechen die Zeilen den Elementen dieser Liste. Eine Liste aus Listen wird zu Zeilen ohne Kopfzeile.
• Textwerte: CSV, TSV, XML, INI und Properties speichern nur Text. Daher wandeln die Konverter true und false in die booleschen Werte true und false um und schreiben einfache Zahlen wie 42 oder 3.5 als Zahlen. Werte wie 007, 1.50 oder 1e3 bleiben Text, damit Postleitzahlen und Versionsnummern unverändert erhalten bleiben.
• XML-Attribute werden zu Schlüsseln, die mit @ beginnen. Der Text eines Elements mit Attributen wird zu #text: <price currency="USD">44.95</price> wird zu {"@currency": "USD", "#text": 44.95}. Wiederholte Elemente werden zu einer Liste. Bei der Konvertierung nach XML werden Schlüssel, die mit @ beginnen, wieder zu Attributen. Ein Objekt mit einem einzelnen Schlüssel, dessen Wert keine Liste ist, wird zum Wurzelelement. Andere Daten kommen in ein <root>-Element; jedes Element einer Liste auf der obersten Ebene wird in ein <item>-Element eingefügt. Zeichen, die in XML-Namen nicht erlaubt sind, etwa Leerzeichen, werden zu _.
• TOML, INI und Properties können auf der obersten Ebene nur benannte Werte speichern. Daher werden Listendaten unter dem Namen items und ein einzelner Wert unter value geschrieben. TOML kennt keinen Nullwert, daher werden Nullwerte ausgelassen.
• INI schreibt verschachtelte Objekte als Abschnitte, etwa [server.ssl], Wertelisten als Zeilen im Format key[] = value und Objektlisten als Abschnitte, die nach ihrer Position benannt sind, etwa [users.0].
• Properties-Schlüssel verbinden verschachtelte Namen mit Punkten und nummerieren Listenelemente in eckigen Klammern, etwa app.hosts[0], wie es Spring Boot macht. Bei der Konvertierung nach YAML oder JSON werden diese Schlüssel zu verschachtelten Objekten und Listen. Eine application.properties-Datei wird daher in die Struktur einer application.yml-Datei umgewandelt. Zeichen außerhalb von Latin-1 werden als \u-Escape-Sequenzen geschrieben.
• YAML-Ergebnisse setzen Text in Anführungszeichen, den YAML-1.1-Parser andernfalls als etwas anderes interpretieren würden, etwa on, yes oder ein Datum. So erhalten YAML-1.1- und YAML-1.2-Parser dieselben Daten. Eine YAML-Datei mit mehreren durch --- getrennten Dokumenten wird zu einer Liste dieser Dokumente, und <<-Merge-Schlüssel werden aufgelöst.
• MessagePack ist ein Binärformat. Daher lesen und schreiben die Tools es als hexadezimale Bytes: {"a": 1} wird zu 81 A1 61 01. Die Eingabe darf Leerzeichen, Kommas und 0x vor jedem Byte enthalten. Mehrere aufeinanderfolgende Nachrichten werden zu einer Liste.
• JSONL-Ergebnisse enthalten jedes Listenelement in einer eigenen Zeile.
• Ganze Zahlen, die für JavaScript-Zahlen zu groß sind, etwa 64-Bit-IDs, behalten alle ihre Ziffern.
• TOML-Datums- und Zeitangaben sowie MessagePack-Zeitstempel werden in Text umgewandelt, etwa 1979-05-27T07:32:00Z.

Tipps

• Um Zellen aus einer Tabelle zu konvertieren, kopiere sie und füge sie als TSV ein: Tabellenprogramme kopieren Zellen als tabulatorgetrennten Text.
• CSV und TSV eignen sich für Daten, die aus einer Liste ähnlicher Datensätze bestehen. Tief verschachtelte Daten lassen sich in YAML, TOML oder TOON besser lesen.
• Kommentare in YAML-, XML-, TOML-, JSON5-, INI- und Properties-Dateien bleiben nicht erhalten, da die Konverter nur die Daten übernehmen.