YAML फ़ॉर्मैटर

यह कैसे काम करता है

YAML का पूरा डिज़ाइन इंडेंटेशन पर टिका है, जिससे वह पढ़ने में सुखद और असामान्य रूप से आसानी से टूटने वाला है। एक अकेला फ़ालतू स्पेस बीस मिनट बाद CI पाइपलाइन से एक त्रुटि संदेश बनकर आता है। यह उसे यहीं पार्स करता है और आपको तुरंत बता देता है।

लाइन नंबर के साथ वैलिडेशन

अगर दस्तावेज़ पार्स नहीं होता, तो आपको वह लाइन और कॉलम मिलता है जहाँ वह विफल हुआ और पार्सर का अपना कारण भी। यह लगभग हमेशा फ़ॉर्मैट किए गए आउटपुट से ज़्यादा उपयोगी होता है, और ज़्यादातर लोग ऐसा टूल इसी वजह से खोलते हैं।

दोबारा फ़ॉर्मैट करना

वैध YAML को डेटा संरचना में पार्स करके शुरू से दोबारा लिखा जाता है, इसलिए इंडेंटेशन एक समान हो जाता है, कोटिंग सामान्य हो जाती है और अंत की फ़ालतू खाली जगह गायब हो जाती है। क्योंकि यह टेक्स्ट संपादित करने के बजाय डेटा से होकर गुज़रता है, नतीजा वैध होना तय है।

राउंड-ट्रिप की क्या कीमत चुकानी पड़ती है

कमेंट खो जाते हैं। वे डेटा का हिस्सा नहीं हैं, इसलिए पार्सर उन्हें छोड़ देता है। एंकर और उपनाम सहेजे जाने के बजाय अपनी पूरी वैल्यू में फैला दिए जाते हैं। अगर आपकी फ़ाइल के कमेंट मायने रखते हैं, तो एक कॉपी को फ़ॉर्मैट करें और इंडेंटेशन के सुधार हाथ से लगाएँ।

कीज़ सॉर्ट करना

वर्णानुक्रम से दो कॉन्फ़िगरेशन फ़ाइलें डिफ़ में सचमुच तुलना योग्य हो जाती हैं। लेकिन उस फ़ाइल के लिए यह गलत चुनाव है जिसमें क्रम पढ़ने वाले इंसान के लिए अर्थ रखता है — CI पाइपलाइन वर्णानुक्रम से ज़्यादा निष्पादन के क्रम में बेहतर पढ़ी जाती है।

कई दस्तावेज़

--- से अलग किए गए कई दस्तावेज़ों वाली फ़ाइल संभाली जाती है, और हर एक को बारी-बारी से फ़ॉर्मैट किया जाता है।