Šis įrankis leidžia konvertuoti struktūrizuotus duomenis tarp YAML, JSON ir TOML formatų tiesiogiai jūsų naršyklėje. Naudotojas įklijuoja duomenis į įvesties lauką, pasirenka norimus įvesties bei išvesties formatus, o įrankis apdoroja informaciją ir pateikia rezultatą išvesties lauke. Taip pat galima koreguoti išvesties atitraukimo dydį.
Kaip veikia duomenų konvertavimas
Konvertavimo procesas prasideda nuo pateiktų duomenų analizės, kurios metu įvesties tekstas paverčiamas vidine duomenų struktūra. Vėliau ši struktūra iš naujo sugeneruojama pasirinktu išvesties formatu.
Šis procesas turi įtakos pradiniam duomenų apipavidalinimui:
- Komentarai ir originalūs tarpai iš įvesties nėra išsaugomi išvestyje. Konverteris nuskaito tik pačias duomenų reikšmes ir sukuria visiškai naują, švarų dokumentą.
- Atitraukimui (angl. indentation) JSON ir YAML formatuose galima pasirinkti 2 arba 4 tarpų reikšmę.
Įrankis turi nustatytą maksimalų apdorojamo teksto dydį. Įvestis yra ribojama iki 2 000 000 simbolių. Jei šis limitas viršijamas, sistema parodo pranešimą: „Ši įvestis yra per didelė šiam įrankiui. Neviršykite {max} simbolių.“. Jei konvertavimo procesas užtrunka per ilgai, rodoma klaida: „Šis konvertavimas trunka per ilgai. Bandykite mažesnę įvestį.“.
Struktūrizuotų duomenų formatų ypatybės
Kiekvienas iš trijų palaikomų formatų turi savo paskirtį, sintaksės taisykles ir taikymo sritis programinės įrangos kūrime bei konfigūravime.
JSON (JavaScript Object Notation)
JSON yra lengvas, tekstinis duomenų mainų formatas, plačiai naudojamas API komunikacijoje ir programų konfigūracijose. Jis yra lengvai nuskaitomas mašinų ir suprantamas žmonėms, tačiau neturi palaikymo komentarams.
YAML (YAML Ain't Markup Language)
YAML dažniausiai naudojamas konfigūraciniuose failuose, CI/CD (nuolatinio integravimo ir pristatymo) procesuose bei diegimo konfigūracijose. Šis formatas orientuotas į žmogaus skaitomumą, jame duomenų hierarchija nustatoma naudojant tarpus (atitraukimus), taip pat palaikomi komentarai.
TOML (Tom's Obvious, Minimal Language)
TOML sukurtas specialiai konfigūraciniams failams, siekiant minimalizmo ir aiškumo. Jis naudoja aiškią lentelių (angl. tables) struktūrą. TOML formatas turi griežtą ribojimą: jam reikalinga aukščiausio lygio lentelė (objektas). Atskira eilutė, skaičius ar masyvas negali būti įrašyti kaip tinkamas TOML dokumentas.
Įrankio valdymas ir būsenos pranešimai
Sąsajoje naudojami konkretūs mygtukai ir pranešimai, padedantys valdyti konvertavimo eigą:
- Įvesties laukas: Turi vietos užpildymo tekstą „Įklijuokite YAML, JSON arba TOML...“.
- Išvesties laukas: Turi vietos užpildymo tekstą „Konvertuotas rezultatas pasirodys čia.“.
- Valdymo mygtukai: Naudotojas gali spausti „Konvertuoti“, „Sukeisti“ (sukeičia įvesties ir išvesties formatus), „Pavyzdys“ (įkelia demonstracinius duomenis), „Atsisiųsti“ (atsisiunčia rezultatą failo pavidalu) arba „Išvalyti“.
- Būsenos informacija: Po sėkmingo konvertavimo rodomas pranešimas „Konvertuota iš
{from}į{to}. Išvesties dydis:{size}.“. Taip pat pateikiama statistika: įvesties simbolių skaičius, išvesties simbolių skaičius, informacija apie šakninį elementą („Šaknis“) ir įrašų skaičius („Įrašai“).
Jei veiksmas atliekamas sėkmingai arba įvyksta klaida, sistema pateikia šiuos pranešimus:
- Sėkmingai išvalius laukus: „Įvestis ir išvestis išvalytos.“.
- Įkėlus pavyzdį: „Pavyzdys įkeltas.“.
- Sukeitus formatus: „Formatai sukeisti.“.
- Pradėjus siuntimą: „Atsisiuntimas pradėtas.“.
- Jei bandoma konvertuoti tuščią lauką: „Pirmiausia įklijuokite įvestį.“.
- Jei pasirinkti vienodi formatai: „Pasirinkite du skirtingus formatus.“.
Klaidų identifikavimas ir trikčių šalinimas
Konvertuojant duomenis, gali kilti sintaksės arba struktūros suderinamumo problemų. Įrankis identifikuoja šias klaidas ir pateikia tikslius pranešimus:
| Problema | Rodomas pranešimas | Sprendimo būdas |
|---|---|---|
| Neteisinga JSON sintaksė | „Nepavyko išanalizuoti šio JSON.“ | Patikrinkite, ar nepalikote kabančių kablelių ir ar visos raktų reikšmės yra kabutėse. |
| Neteisinga YAML sintaksė | „Nepavyko išanalizuoti šio YAML.“ | Patikrinkite atitraukimus tarpais. YAML nepalaiko tabuliacijos simbolių (Tab). |
| Neteisinga TOML sintaksė | „Nepavyko išanalizuoti šio TOML.“ | Įsitikinkite, kad visi kintamieji priskirti teisingai ir nepažeista struktūra. |
| Nesuderinama TOML išvestis | „Šių duomenų negalima įrašyti kaip tinkamo TOML.“ | TOML reikalauja aukščiausio lygio objekto (lentelės). Negalima konvertuoti pavienio masyvo ar teksto eilutės tiesiai į TOML. |
| Kitos neapibrėžtos klaidos | „Nepavyko konvertuoti šios įvesties.“ | Patikrinkite, ar įvesties duomenys nėra sugadinti. |
Duomenų apdorojimas ir privatumas
Visi konvertavimo veiksmai atliekami lokaliai, tiesiogiai naudotojo interneto naršyklėje. Įvesti struktūrizuoti duomenys nėra siunčiami į išorinius serverius, nieko neperduodama į BroBroGo serverius. Tai užtikrina, kad konfigūracijos failai, API raktai ar kiti jautrūs duomenų fragmentai lieka tik naudotojo įrenginyje.
Dažniausiai užduodami klausimai (DUK)
Kokie konvertavimai yra palaikomi?
Galite konvertuoti tarp YAML, JSON ir TOML formatų bet kuria kryptimi. Prieš konvertuodami pasirinkite įvesties ir išvesties formatus viršuje.
Kodėl kai kurios reikšmės negali tapti TOML?
TOML failams reikalinga aukščiausio lygio lentelė. Atskira eilutė, skaičius ar masyvas vis tiek gali tapti JSON arba YAML, tačiau negali būti įrašyti kaip tinkamas TOML dokumentas.
Ar komentarai išsaugomi?
Ne. Konverteris nuskaito duomenų reikšmes ir sukuria švarų naują dokumentą, todėl komentarai ir originalūs tarpai nėra perkeliami.
Ką daryti, jei gaunu pranešimą apie per didelę įvestį?
Įrankis riboja įvestį iki 2 000 000 simbolių. Jei jūsų failas viršija šį dydį, turite sumažinti įvesties duomenų kiekį arba konvertuoti juos dalimis.