Góður breytir á ekki að þykjast geta flutt hvaða uppbyggingu sem er í hvaða snið sem er. Þegar Converty skilur TOML-pane eftir autt fyrir innslátt sem samt parse-ast sem JSON eða YAML er það yfirleitt merki um ósamhæft gagnalíkan, ekki bilaðan hnapp.
JSON og YAML geta lýst mjög fjölbreyttum skjölum. TOML er þrengra og hannað fyrir stillingar, nafngreinda hluti og töflur. Það er kostur í réttum samhengi, en takmörkun þegar upprunagögnin eru top-level array, scalar eða óregluleg uppbygging.
Gildur innsláttur er ekki alltaf umbreytanlegur innsláttur
Fyrst þarf skjalið að vera gilt. Síðan þarf það að passa markformið. Þessar spurningar eru ekki eins.
Ef JSON og YAML birtast en TOML ekki, þá er uppruninn líklega ekki með TOML-væna top-level lögun. Converty stoppar þar frekar en að búa til kimenni sem lítur trúverðugt út en breytir merkingu.
Top-level array er einfaldasta dæmið
JSON-skjal getur byrjað á lista af hlutum. Það er eðlilegt í API-svörum og exportum. YAML getur sýnt slíkt skýrt. TOML, í þessari notkun, vill frekar hlut á efsta stigi sem má birta sem root table. Ef þú reynir að þvinga array inn í það færðu ekki "næstum TOML"; þú færð ekki TOML-úttak.
Þetta er gott. Það verndar þig frá því að líma skjal í config-samhengi sem það á ekki heima í.
Hagnýtt dæmi
Þú ert með YAML-bút úr skjölum eða JSON payload úr API og deployment-tól vill TOML. Það er freistandi að hugsa um markformið sem snyrtivandamál. Raunverulega spurningin er hvort gögnin hegði sér eins og stillingarhlutur.
Límdu innsláttinn í JSON / YAML / TOML-breytinn. Ef TOML birtist ekki, skoðaðu lögunina áður en þú reynir að neyða hana í markkerfið. JSON, YAML og TOML breytt án þess að skaða gögn útskýrir breiðara ferlið.
Stundum er rétt að hætta að breyta
Ef gögn passa betur í JSON eða YAML, þá er ekki agi að þvinga þau í TOML. Það er bjögun. Format-val á að fylgja uppbyggingu, ekki berjast gegn henni.
Ef verkefnið þarf að verða endurtekið script eða CI-regla, skoðaðu Converty vs yq fyrir JSON og YAML afhendingar. Ef vandinn er frekar line-based innflutningur, tengist Lagfæra CSV-afmarkara vandamál fyrir innflutning sömu hugsun: gildur texti tryggir ekki gott handoff.
Tómt TOML-úttak er því gagnleg endurgjöf. Það segir þér að skoða gagnalíkanið áður en næsta kerfi þarf að hafna því.
