Umbreyting á milli YAML, JSON og TOML
Skipulögð gögn eru undirstaða nútíma hugbúnaðarþróunar, hvort sem um ræðir stilliskrár fyrir kerfi eða gagnaflutning á milli vefþjónusta. YAML, JSON og TOML eru þrjú af algengustu sniðunum sem notuð eru til að lýsa gögnum á læsilegan hátt. Þetta tól gerir notendum kleift að umbreyta gögnum á milli þessara þriggja sniða á fljótlegan og einfaldan hátt.
Þegar unnið er með stillingar fyrir CI/CD vinnuflæði, uppsetningarskrár eða samskipti við vefþjónustuskil (API), þarf oft að flytja gögn á milli ólíkra kerfa sem krefjast mismunandi sniða. Með því að líma gögnin inn í tólið má breyta þeim í það snið sem krafist er hverju sinni.
Virkni og notkun tólsins
Tólið vinnur beint í vafranum og breytir skipulögðum gögnum á milli YAML, JSON og TOML. Notandinn límir gögnin sín inn í inntaksreitinn, velur viðeigandi inntaks- og úttakssnið og tólið birtir niðurstöðuna í úttaksreitnum. Einnig er hægt að stilla inndrátt fyrir úttakið.
Skref við umbreytingu:
- Inntakssnið valið: Veldu á milli YAML, JSON eða TOML.
- Úttakssnið valið: Veldu það snið sem gögnin eiga að breytast í.
- Gögn límd inn: Límdu gögnin í reitinn sem sýnir leiðbeiningatextann „Límdu YAML, JSON eða TOML...“.
- Inndráttur stilltur: Fyrir JSON og YAML er hægt að velja á milli 2 eða 4 bila inndráttar.
- Niðurstaða sótt: Breytt gögn birtast í úttaksreitnum þar sem stendur „Breytt úttak mun birtast hér.“.
Tólið sýnir einnig tölfræði um gögnin, þar á meðal fjölda stafa í inntaki og úttaki, upplýsingar um rótareininguna og heildarfjölda færslna.
Takmarkanir og sértækar reglur sniðanna
Við umbreytingu á skipulögðum gögnum gilda ákveðnar reglur sem stjórnast af tæknilegum eiginleikum hvers sniðs fyrir sig:
- Athugasemdir og línubil: Athugasemdir (comments) og upprunalegt línubil úr inntakinu varðveitast ekki við umbreytinguna. Tólið þáttar gildin og skrifar nýtt, hreint skjal.
- Kröfur TOML um efsta stig: TOML-sniðið krefst þess að gögnin byrji á yfirtöflu (top-level table). Einfaldur textastrengur, stök tala eða fylki (array) geta verið gild gögn í JSON og YAML, en þau er ekki hægt að skrifa sem gilt TOML-skjal. Ef reynt er að breyta slíkum gögnum yfir í TOML birtir tólið villuna „Ekki er hægt að skrifa þessi gögn sem gilt TOML.“.
- Stærðartakmörk: Inntakið takmarkast við að vera undir 2.000.000 stöfum. Ef farið er yfir þau mörk birtast skilaboðin „Inntakið er of stórt fyrir þetta tól. Hafðu það undir
{max}stöfum.“.
Öryggi og vinnsla gagna
Öll vinnsla á gögnunum fer fram staðbundið í vafranum þínum. YAML, JSON og TOML-gögnin þín eru umbreytt í vafranum þínum. Ekkert er sent til BroBroGo. Þetta tryggir að gögnin fara aldrei yfir netið til ytri netþjóna við vinnsluna.
Villuskilaboð og lausnir
Ef upp kemur villa við þáttun eða umbreytingu mun tólið gefa til kynna hvað fór úrskeiðis með viðeigandi skilaboðum:
| Atvik | Skilaboð í viðmóti |
|---|---|
| Tómt inntak sendir inn | „Límdu fyrst eitthvað inntak.“ |
| Sama snið valið fyrir inntak og úttak | „Veldu tvö mismunandi snið.“ |
| Ógilt JSON-inntak | „Ekki var hægt að þátta þetta JSON.“ |
| Ógilt YAML-inntak | „Ekki var hægt að þátta þetta YAML.“ |
| Ógilt TOML-inntak | „Ekki var hægt að þátta þetta TOML.“ |
| Umbreyting tekur of langan tíma | „Þessi breyting tekur of langan tíma. Prófaðu minna inntak.“ |
| Almenn villa við umbreytingu | „Ekki var hægt að breyta þessu inntaki.“ |
Þegar aðgerðir heppnast eða breytingar eru gerðar á viðmótinu birtir tólið staðfestingar:
- Við hreinsun á reitum: „Inntak og úttak hreinsað.“
- Þegar sýnishorn er opnað: „Sýnishorn hlaðið.“
- Þegar sniðum er víxlað: „Sniðum víxlað.“
- Þegar skrá er hlaðið niður: „Niðurhal hafið.“
- Eftir árangursríka umbreytingu: „Breytti
{from}í{to}. Stærð úttaks:{size}.“
Algengar spurningar
Hvaða snið eru studd?
Þú getur breytt á milli YAML, JSON og TOML í báðar áttir. Veldu inntaks- og úttakssnið hér að ofan áður en þú breytir.
Af hverju geta sum gildi ekki orðið að TOML?
TOML-skrár þurfa yfirtöflu (top-level table). Einfaldur textastrengur, tala eða fylki getur samt orðið að JSON eða YAML, en ekki er hægt að skrifa það sem gilt TOML-skjal.
Eru athugasemdir varðveittar?
Nei. Breytirinn les gagnagildin og skrifar nýtt, hreint skjal, þannig að athugasemdir og upprunalegt línubil flytjast ekki yfir.