Übersetze YAML-Konfiguration in TOML mit optionaler Einrückung und Schlüsselsortierung.
Übersetze YAML-Konfiguration in TOML mit optionaler Einrückung und Schlüsselsortierung. Übersetze YAML-Konfiguration in TOML mit optionaler Einrückung und Schlüsselsortierung.
Sowohl YAML als auch TOML wollen gut lesbare Konfigurationsformate sein. Sie überschneiden sich stark bei den Daten, die sie darstellen können (Mappings, Sequenzen, Skalare), unterscheiden sich aber in der Syntax und in einigen Randfällen. YAML unterstützt Tags, Anker und Mehrzeilenskalare; TOML unterscheidet zwischen Inline-Tabellen und Array-of-Tables und behandelt Datum als eigenständigen Typ.
Ein YAML-zu-TOML-Konverter ist am nützlichsten, wenn man eine
Konfigurationsdatei vom bevorzugten Format eines Werkzeugs in das
eines anderen überführt: zum Beispiel ein Kubernetes-Manifest in ein
pyproject.toml-Snippet umwandeln oder ein Ansible-Inventar in
einer Cargo-[dependencies]-Tabelle ausdrücken.
Mappings (key: value in YAML) werden je nach Kontext zu TOML-Tabellen
oder Schlüssel-Wert-Paaren. Sequenzen werden zu Inline-Arrays oder
[[array.of.tables]]-Kopfzeilen. Skalare werden beibehalten, solange
sie sauber abbilden: Zeichenfolgen, Ganzzahlen, Gleitkommazahlen,
Booleans und ISO-Daten.
YAML-Anker und -Alias werden beim Parsen abgeflacht; das
konvertierte TOML enthält den konkreten Wert an jeder Alias-Stelle,
was die meisten Konsumenten wollen. YAML-!!binary-Tags werden nicht
beibehalten, weil TOML kein Äquivalent hat. Kommentare werden
absichtlich entfernt — keines der Formate garantiert Round-Trip-Erhaltung.
Bevor du das konvertierte TOML committest, führe den TOML-Linter deines Projekts aus (taplo, toml-check usw.). Der Konverter übersetzt nur Syntax, nicht Stil; der Linter erkennt Anführungszeichen-, Einrückungs- und Schlüsselreihenfolge-Probleme, die der Konverter nicht erkennen kann.