TOML-Formatierer & Validator

TOML (Tom's Obvious Minimal Language) ist ein Konfigurationsdateiformat, das einfach zu lesen und zu schreiben ist. Im Gegensatz zu YAML vermeidet TOML signifikante Leerzeichen und komplexe Verschachtelungen, die subtile Fehler verursachen. Im Gegensatz zu JSON unterstützt TOML Kommentare, verfügt über native Datums-/Zeitdatentypen und ist für Konfigurationsdateien besser menschenfreundlich. TOML tauscht etwas von YAMLs Flexibilität gegen Vorhersagbarkeit – es gibt im Allgemeinen nur eine Möglichkeit, etwas in TOML auszudrücken.

Eine TOML-Tabelle ist eine Sammlung von Schlüssel-Wert-Paaren unter einer Überschrift wie [package] oder [dependencies]. Tabellen können mit Punktnotationen wie [server.database] verschachtelt werden. Inline-Tabellen sind eine kompakte Einzeilensyntax mit geschweiften Klammern: key = { name = 'value', version = '1.0' }. Normale Tabellen sind besser für die Lesbarkeit mit vielen Schlüsseln, während Inline-Tabellen gut für kleine, eng verwandte Wertgruppen funktionieren.

Rust hat TOML für Cargo gewählt, da es ein Gleichgewicht zwischen menschlicher Lesbarkeit und maschineller Parsierbarkeit herstellt. TOMLs explizite Typisierung (Strings, Integer, Booleans, Daten) reduziert Mehrdeutigkeiten, die YAML plagen (wo 'no' als Boolean interpretiert werden kann). Die Kommentarunterstützung ist unerlässlich für die Dokumentation von Abhängigkeitsentscheidungen. Die Einfachheit des Formats bedeutet auch weniger Parsing-Randfälle und ein vorhersagbareres Verhalten über verschiedene Tools und Editoren hinweg.

Arrays von Tabellen verwenden doppelte Klammern [[table_name]], um mehrere Instanzen desselben Tabellentyps zu definieren. Zum Beispiel definiert [[bin]] in Cargo.toml mehrere Binärziele. Jeder [[bin]]-Block fügt ein neues Element zu einem Array hinzu. Dies ist TOMLs Art, Arrays von Objekten darzustellen, ohne den visuellen Lärm von JSON-Arrays oder die Strichlisten von YAML.

pyproject.toml ist die standardisierte Projektkonfigurationsdatei von Python (definiert in PEP 518 und PEP 621). Sie ersetzt den älteren Ansatz mit setup.py und setup.cfg. Die Tabelle [build-system] gibt Build-Anforderungen an, [project] enthält Metadaten wie Name, Version und Abhängigkeiten, und [tool.*]-Tabellen enthalten Konfigurationen für spezifische Tools wie pytest, black oder mypy. Dies konsolidiert mehrere Konfigurationsdateien an einem standardmäßigen Ort.