JSON dan YAML ga O'tkazgich

JSON-ni YAML-ga va YAML-ni JSON-ga brauzeringizda konvertatsiya qiling

JSON va YAML bir xil turdagi ma'lumotni — ichma-ich xaritalar, ro'yxatlar, satrlar, raqamlar va mantiqiy qiymatlarni — tasvirlaydi, lekin ular juda boshqacha ko'rinadi va turli joylarda ishlatiladi. Agar API-lar, konteyner fayllari yoki CI konveyerlari yaqinida vaqt o'tkazsangiz, oxir-oqibat birini boshqasiga aylantirish kerak bo'ladi. Ushbu sahifa bu konvertatsiyani ikkala yo'nalishda ham, to'liq brauzeringiz ichida amalga oshiradi, shunda joylashtirgan ma'lumotingiz hech qachon mashinangizdan chiqmaydi.

Qorong'i indigo fonda abstrakt nurdan qavslar toza chekinishga asoslangan konfiguratsiya qatlamlariga aylanmoqda — JSON tuzilmasi chekinishga asoslangan YAML-ga yoyilmoqda.

JSON nima va u qayerda yashaydi

JSON (JavaScript Object Notation) - avvalambor mashinalar uchun yaratilgan qat'iy, qavs va figurali qavsli format. Har bir obyekt {} ichiga, har bir massiv [] ichiga o'raladi, kalitlar va satr qiymatlari qo'sh tirnoq ichida bo'ladi, va elementlar vergul bilan ajratiladi. Bu REST va GraphQL API-larining standart uzatish formati, ko'pchilik webhook-larning tanasi, NoSQL hujjatlarining shakli, va fetch chaqiruvingiz qaytaradigan narsa. Deyarli har bir til uni qutidan chiqarib tahlil qiladi, aynan shuning uchun u API qatlamida g'olib bo'ldi: JavaScript-da JSON.parse, Python standart kutubxonasida json, va hamma joyda unga o'xshash narsalar. Murosa shundaki, JSON qo'lda yozish uchun batafsil va izohlarni taqiqlaydi, shuning uchun inson kun bo'yi tahrirlaydigan fayllar uchun yomon format.

YAML nima va u qayerda yashaydi

YAML (YAML Ain't Markup Language) qarama-qarshi ustuvorlik uchun ishlab chiqilgan: avvalambor inson uchun. U qavslar va tirnoqlarni tashlab yuboradi, ichma-ichlikni ifodalash uchun chekinishdan foydalanadi, va # bilan izohlar yozishga imkon beradi. Aynan shu o'qish qulayligi uni konfiguratsiyaning umumiy tili qildi. Docker Compose fayllari, Kubernetes manifestlari, GitHub Actions va GitLab CI ish oqimlari, Ansible playbook-lari va son-sanoqsiz ilova konfiguratsiya fayllari - barchasi YAML. Odatiy YAML hujjati bir xil JSON-ga qaraganda sezilarli darajada qisqaroq va pull request-da farqni ko'rish ancha osonroq. Ushbu nafisatning narxi - mo'rtlik, va aynan shu yerda konvertatsiya qiziqarli bo'lib qoladi.

Muhim bo'lgan asosiy farqlar

Uchta farq deyarli har bir konvertatsiya qarorini boshqaradi. Birinchidan, YAML-da bo'shliq ahamiyatga ega, JSON-da esa ma'nosiz. YAML tuzilishni belgilash uchun bo'shliqlardan — hech qachon tab-lardan — foydalanadi, shuning uchun bitta noto'g'ri joylashgan bo'shliq hujjat ma'nosini sezdirmasdan o'zgartirishi mumkin. JSON esa chekinishga umuman e'tibor bermaydi. Ikkinchidan, YAML izohlarni qo'llab-quvvatlaydi, JSON esa qo'llab-quvvatlamaydi. YAML-dagi har qanday # izohi JSON yaratganingizda shunchaki yo'qoladi, chunki uni qo'yadigan joy yo'q. Uchinchidan, YAML-da boyroq, yashirin turlashtirish bor. U sanalar, vaqt belgilari va null-ni bir necha yozilishda o'qishga tayyor, va turlarni tirnoqsiz qiymatlardan taxmin qiladi. JSON-da esa kichik, aniq turlar to'plami va noaniqlik yo'q. Shuni ham yodda tuting: texnik jihatdan JSON YAML 1.2-ning bir qismi hisoblanadi, aynan shuning uchun to'g'ri JSON odatda YAML sifatida toza tahlil qilinadi, ammo teskarisi kafolatlanmaydi.

Ichma-ich joylashgan ma'lumot daraxti ko'k va oltin rangdagi ikki yorqin tuzilgan format orasida almashmoqda — Bir xil ma'lumot daraxti ikki formatda ifodalangan.

Kuzatib borishga arzigulik konvertatsiya nozikliklar

Aylanma yo'l har doim ham yo'qotishsiz emas, va nima buzilishini bilish foydali:

Norvegiya muammosi. YAML 1.1 qoidalariga ko'ra, tirnoqsiz NO mantiqiy false sifatida tahlil qilinadi, va yes, on, off ham mantiqiy qiymatlarga aylanadi. Mamlakat kodi yoki tugma yorlig'i siz sezmasdan true/false-ga aylanib qolishi mumkin. Satr sifatida nazarda tutgan qiymatlaringizni tirnoqqa oling.
Raqam o'zgarishi. 3.10 kabi versiya oxiridagi nolni yo'qotib 3.1-ga aylanishi mumkin, va 1.0 matn deb nazarda tutilganda ham raqamga aylanadi. Versiya satrlari va identifikatorlarni tirnoqqa oling.
Yorliq va havolalar yo'qoladi. YAML-ning &anchor va *alias havolalarining JSON-da ekvivalenti yo'q. Yaxshi konvertor ularni to'liq qiymatiga yoyadi, shuning uchun ma'lumot to'g'ri bo'lib qoladi, lekin takrorlanishning oldini olish yo'qoladi — JSON-dan YAML-ga va qayta JSON-ga o'tish asl yorliqlarni tiklamaydi.
Izohlar va blok skalyarlar. Izohlar JSON-ga o'tishda tashlab yuboriladi. Ko'p qatorli blok skalyarlar (| va >) \n qochish belgilariga ega oddiy JSON satrlariga siqiladi, shuning uchun vizual formatlash niyati yo'qoladi.
YAML-ga qaytishda chekinish. JSON chekinishni kodlamaydi, shuning uchun konvertor izchil uslubni tanlaydi. Tab-ga sezgir vositaga joylashtirishdan oldin uni ko'rib chiqing.

Nima uchun faqat-mahalliy muhim

Konfiguratsiya fayllari va API yuklari aynan tasodifiy serverga yuklanmasligi kerak bo'lgan narsa: ular ko'pincha host nomlari, tokenlar, ichki xizmat nomlari yoki mijoz ma'lumotlarini o'z ichiga oladi. Ushbu konvertor tahlil-va-chiqarish qadamini brauzeringizda JavaScript bilan bajaradi. Hech narsa backend-ga yuborilmaydi, hech narsa qayd etilmaydi, va vosita sahifa yuklangandan keyin oflayn ishlaydi. Kubernetes sirini yoki CI ish oqimini u mashinangizda qolishiga ishonch bilan joylashtiring.

Bog'liq vositalar kerakmi? Bizning to'liq ma'lumot konvertorlarimizni ko'rib chiqing, tartibsiz kirishni JSON formatlash vositasi bilan tozalang, va API dunyosi bilan konfiguratsiya dunyosi orasida harakatlanish kerak bo'lganda bu yerga qayting.

Tez-tez so'raladigan savollar

Ma'lumotim biror joyga yuklanadimi?

Yo'q. Konvertatsiya to'liq brauzeringizda mahalliy JavaScript yordamida amalga oshiriladi. JSON yoki YAML-ingiz hech qachon serverga yuborilmaydi, shuning uchun sirlar va konfiguratsiya fayllari maxfiy qoladi.

Nima uchun YAML qiymatim true yoki false ga kutilmaganda o'zgardi?

YAML 1.1 yes, no, on va off kabi tirnoqsiz so'zlarni mantiqiy qiymat sifatida ko'radi — Norvegiya muammosi. Satr sifatida nazarda tutgan har qanday qiymatingizni tirnoqqa oling, shunda u matn sifatida konvertatsiyadan omon qoladi.

YAML-ni JSON-ga konvertatsiya qilganda izohlarimga nima bo'ladi?

JSON-da izoh sintaksisi yo'q, shuning uchun konvertatsiya jarayonida barcha hash izohlari olib tashlanadi. Eslatmalarni saqlash kerak bo'lsa, asosiy nusxangizni YAML-da saqlang.

YAML yorliq va aliaslar saqlanadimi?

Ular to'liq qiymatlariga yoyiladi, chunki JSON-da havola mexanizmi yo'q. Ma'lumot to'g'ri bo'lib qoladi, ammo YAML-ga qaytadan konvertatsiya qilganingizda takrorlanishning oldini olish tiklanmaydi.

JSON-ni YAML-ga hamda YAML-ni JSON-ga konvertatsiya qila olamanmi?

Ha, vosita ikkala yo'nalishda ham ishlaydi. JSON-ni joylashtiring va YAML oling, yoki YAML-ni joylashtiring va JSON oling, va konvertor boshqa formatni aniqlab, uni yaratadi.

Nima uchun tab ishlatganimda YAML buziladi?

YAML chekinish uchun bo'shliqlarni talab qiladi va tab-larni rad etadi. Agar joylashtirilgan matn tahlil qilinmasa, tab belgilarini bo'shliqlarga almashtiring va chekinishni izchil saqlang.