Jedním z nejužitečnějších momentů v převodníku formátů je chvíle, kdy odmítne předstírat, že každou strukturu lze čistě převést do každé jiné. To se děje, když Converty nechá TOML výstup prázdný u vstupu, který se jinak správně parsuje jako JSON nebo YAML. Dokument je platný. Data existují. Jen je TOML neumí v požadovaném tvaru poctivě vyjádřit.
JSON / YAML / TOML převodník proto nejdřív parsuje zdroj a teprve potom renderuje kompatibilní výstupy. JSON a YAML zvládnou široké spektrum struktur. TOML je užší.
TOML je navržený pro konfiguraci
JSON a YAML umí top-level pole, skaláry i nepravidelné kolekce. TOML je určený hlavně pro pojmenovaná nastavení, sekce a konfigurační dokumenty. Díky tomu je čitelný ve svém doménovém použití, ale není univerzálním cílem pro každý platný JSON nebo YAML.
V Converty se TOML vykreslí jen tehdy, když lze vstup reprezentovat jako objekt na nejvyšší úrovni s hodnotami kompatibilními s TOML. Pokud je kořenem pole nebo jiný nevhodný tvar, chybějící výstup je správné omezení.
Platný vstup není totéž co konvertibilní vstup
Validita řeší, jestli dokument jde přečíst. Kompatibilita řeší, jestli se stejný model dá vyjádřit v cílovém formátu. Pokud JSON a YAML fungují, ale TOML ne, problém obvykle není syntaxe. Problém je tvar dat.
Nejjednodušší příklad je JSON dokument, jehož root hodnota je pole objektů. To je běžné u API odpovědí i exportů. JSON a YAML ho vyjádří snadno. TOML jako root tabulku v tomto workflowu ne.
Chybějící TOML je užitečná zpětná vazba
Konverter by neměl potichu přeuspořádat data jen proto, aby vytvořil výstup. Pokud cílový formát neodpovídá modelu, lepší je říct to nahlas. To vám pomůže rozhodnout, jestli data zjednodušit, přetvarovat nebo zůstat u JSON či YAML.
Širší postup popisuje Jak převádět JSON, YAML a TOML bez poškození dat. Pokud problém patří spíš do opakovatelného CLI workflowu, pokračujte na Converty vs yq pro předávání JSON a YAML.
Někdy je správné přestat převádět
Prázdný TOML panel neznamená, že práce selhala. Může znamenat, že zdrojová data patří do jiného formátu. Volba formátu má následovat strukturu, ne ji násilně ohýbat.
Otevřete JSON / YAML / TOML převodník, když potřebujete přímou kontrolu, použijte časté dotazy pro limity formátů a berte chybějící TOML jako signál, že stojí za to podívat se na datový model.
