Übersetzen Sie TOML-Dokumente in YAML mit optionaler Schlüsselsortierung und Einrückungssteuerung.
Übersetzen Sie TOML-Dokumente in YAML mit optionaler Schlüsselsortierung und Einrückungssteuerung. Übersetzen Sie TOML-Dokumente in YAML mit optionaler Schlüsselsortierung und Einrückungssteuerung.
Beide Formate zielen auf von Menschen bearbeitete
Konfigurationsdateien ab, aber das Ökosystem darum herum ist
verschieden. TOML ist der Standard für Python-Packaging
(pyproject.toml), Rust (Cargo.toml), GitHub-Workflows und
viele CLI-Werkzeuge. YAML ist der Standard für Kubernetes, Ansible,
Docker Compose, GitHub Actions (die ältere Syntax) und viele
CI-Systeme.
Manchmal müssen Sie dieselbe Konfiguration in beiden Formaten
ausdrücken: ein pyproject.toml-Schnipsel in einem Ansible-Playbook
wiederverwenden oder eine Kubernetes-ConfigMap in einen
Cargo.toml-Abhängigkeitsblock übertragen. Ein TOML-zu-YAML-Konverter
hält die Übersetzung mechanisch.
Mappings, Sequenzen, Skalare (Zeichenketten, ganze Zahlen, Gleitkommazahlen, Booleans, ISO-Daten), Inline-Tabellen und Punkt-Schlüssel übersetzen alle sauber. Mehrzeilige Zeichenketten werden als YAML-Block-Skalare ausgegeben und bewahren das visuelle Layout, das der ursprüngliche TOML-Autor gewählt hat.
YAML-Tags (!!str, !!int usw.) werden nur ausgegeben, wenn der
zugrundeliegende Typ von YAMLs Standard-Inferenz abweicht. In der
Praxis passt die Wahl des Parsers zu dem, was die meisten Leser
erwarten. YAML-Anker werden standardmäßig nicht erzeugt, weil jeder
TOML-Wert vollständig in sich geschlossen ist; wenn Sie gemeinsame
Unterbäume wollen, führen Sie sie von Hand ein.
Nach der Konvertierung lassen Sie das YAML durch einen Linter (yamllint, kubeconform), bevor Sie es committen. Der Konverter übersetzt Syntax, nicht Stil: er kann nicht wissen, ob Sie snake_case oder kebab-case wollten, oder ob Sie 2-Leerzeichen- oder 4-Leerzeichen-Einrückung bevorzugten. Das entscheiden Ihre Projektkonventionen.