YAML से JSON कन्वर्टर

ज़्यादातर मॉडर्न इंफ्रास्ट्रक्चर टूल्स के लिए YAML इंसानों द्वारा लिखा जाने वाला पसंदीदा कॉन्फ़िगरेशन फ़ॉर्मैट है, लेकिन प्रोग्राम के ज़रिए डेटा एक्सचेंज, API कम्युनिकेशन और डेटाबेस स्टोरेज के लिए JSON ही मुख्य फ़ॉर्मैट बना हुआ है। नतीजतन, सॉफ़्टवेयर टीमों को अक्सर YAML से JSON में डेटा बदलना पड़ता है: जैसे स्क्रिप्ट में प्रोसेस करने के लिए Kubernetes मैनिफ़ेस्ट से वैल्यू निकालना, टूलचेन कम्पैटिबिलिटी के लिए OpenAPI YAML स्पेसिफ़िकेशन को JSON में बदलना, पाइपलाइन स्ट्रक्चर को एनालाइज़ करने के लिए CI/CD वर्कफ़्लो फ़ाइलों को पढ़ना, या दूसरे टूल्स के इस्तेमाल के लिए Ansible इन्वेंट्री और वेरिएबल फ़ाइलों को JSON में एक्सपोर्ट करना। YAML की कई खास खूबियां — जैसे एंकर, एलियास, मल्टी-लाइन स्ट्रिंग और इम्प्लिसिट टाइपिंग — इस कन्वर्ज़न में ऐसी बारीकियां जोड़ती हैं जिन्हें सिर्फ़ टेक्स्ट बदलकर नहीं संभाला जा सकता।

YAML का इम्प्लिसिट टाइप सिस्टम इसकी सबसे बड़ी सुविधा भी है और कन्वर्ज़न से जुड़ी हैरानी की सबसे आम वजह भी। जब YAML बिना कोटेशन वाले स्केलर वैल्यू को पार्स करता है, तो यह टाइप इन्फरेंस के नियमों को लागू करता है: "true", "false", "yes", "no" बूलियन बन जाते हैं; "null" और "~" नल (null) बन जाते हैं; बिना कोटेशन वाले नंबर इंटीजर या फ्लोट बन जाते हैं; बाकी सब कुछ स्ट्रिंग बन जाता है। JSON आउटपुट में, ये इन्फर किए गए टाइप सही ढंग से दिखते हैं — "true" JSON बूलियन true बन जाता है, न कि स्ट्रिंग "true"। यह टाइप प्रमोशन आमतौर पर सही और वांछनीय होता है, लेकिन डेवलपर्स को पता होना चाहिए कि अगर कोई YAML वैल्यू इन्फरेंस पैटर्न में से किसी एक से मेल खाती है, तो जिसे स्ट्रिंग के तौर पर इस्तेमाल करना था, वह अलग JSON टाइप के तौर पर दिख सकती है। YAML में वैल्यू को स्पष्ट रूप से कोट करने से अनचाहे कन्वर्ज़न (coercion) से बचा जा सकता है।

YAML एंकर्स और एलियास एक शक्तिशाली लेकिन अक्सर गलत समझे जाने वाले फ़ीचर हैं, जो कन्वर्ज़न के आउटपुट पर काफ़ी असर डालते हैं। एक एंकर (&label) किसी वैल्यू को दोबारा इस्तेमाल के लिए मार्क करता है; वहीं एक एलियास (*label) उस वैल्यू की एक कॉपी को डॉक्यूमेंट में कहीं और डालता है। इससे YAML डॉक्यूमेंट्स में बार-बार आने वाले कॉन्फ़िगरेशन ब्लॉक्स को बिना असल में डुप्लिकेट किए, संक्षेप में लिखा जा सकता है। JSON में बदलते समय, सभी एंकर्स और एलियास को रिज़ॉल्व किया जाता है — हर एलियास की जगह एंकर वाली वैल्यू की पूरी कॉपी आ जाती है। बनने वाले JSON में कोई रेफरेंस नहीं होता, सिर्फ़ पूरा डेटा होता है। जटिल Helm चार्ट्स या Ansible प्लेबुक्स के मामले में, जो DRY कॉन्फ़िगरेशन के लिए YAML एंकर्स पर बहुत ज़्यादा निर्भर करते हैं, कन्वर्ट किया गया JSON ओरिजिनल YAML के मुकाबले काफ़ी बड़ा होगा।

यह YAML से JSON कन्वर्टर एक पूरा YAML 1.2 पार्सर इस्तेमाल करता है जो मैपिंग, सीक्वेंस, स्केलर, नेस्टेड स्ट्रक्चर, एंकर, एलियास, स्पष्ट टाइप टैग और मल्टी-लाइन स्ट्रिंग ब्लॉक को हैंडल करता है। आउटपुट से YAML कमेंट्स अपने आप हटा दिए जाते हैं क्योंकि JSON में इसके जैसा कोई सिंटैक्स नहीं होता है। यह कन्वर्टर डिफ़ॉल्ट रूप से कॉम्पैक्ट JSON बनाता है, जिसे पढ़ने लायक आउटपुट के लिए JSON फ़ॉर्मेटर में भेजा जा सकता है। कन्वर्ज़न ब्राउज़र में ही होता है और डेटा को बाहरी सर्वर पर नहीं भेजा जाता, इसलिए संवेदनशील वैल्यू वाले Kubernetes सीक्रेट्स, CI/CD क्रेडेंशियल्स या इंफ्रास्ट्रक्चर कॉन्फ़िगरेशन के साथ इसका इस्तेमाल करना सुरक्षित है। इंफ्रास्ट्रक्चर-एज़-कोड को मैनेज करने वाली टीमों के लिए, यह कन्वर्टर JSON-आधारित टूलचेन के लिए एक भरोसेमंद कड़ी का काम करता है।