YAML फ़ॉर्मैटर और वैलिडेटर

यह क्या करता है

YAML पढ़ने में आसान है, इसलिए कॉन्फ़िगरेशन फ़ाइलों में खूब इस्तेमाल होता है — Kubernetes मैनिफ़ेस्ट, GitHub Actions और GitLab CI वर्कफ़्लो, Docker Compose, Ansible प्लेबुक, OpenAPI दस्तावेज़। पर इसे तोड़ना भी आसान है: एक गलत इंडेंट, एक टैब, बंद न किया गया कोट या कोलन के बाद छूटा स्पेस फ़ाइल का मतलब बदल सकता है या उसे लोड होने से रोक सकता है।

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

इस्तेमाल कैसे करें

1. इनपुट में YAML पेस्ट करें, .yaml या .yml फ़ाइल अपलोड करें, या उदाहरण पर क्लिक करें।
2. टाइप करते ही नतीजा दिखता है: हरा मान्य YAML बैज, या लाइन 3, कॉलम 2 जैसी एरर सूची।
3. साफ़ कॉपी पाने के लिए फ़ॉर्मैट किया YAML दिखाएँ चालू रखें और 2 या 4 स्पेस का इंडेंट चुनें। ब्लॉक के ऊपर वाले बटन से कॉपी करें।
4. दोहराई गई कुंजियाँ एरर हैं को तभी बंद करें जब आपके टूल दोहराई गई कुंजियाँ स्वीकार करते हों।

आम गलतियाँ

server:
  port: 8080
   host: localhost   # indented one space too far
tags: [web, api      # missing closing bracket

• असंगत इंडेंट: एक ही स्तर के आइटम एक ही कॉलम से शुरू होने चाहिए। YAML इंडेंट के लिए टैब की अनुमति नहीं देता।
• कोलन के बाद स्पेस नहीं: key:value एक सादी स्ट्रिंग है, कुंजी और वैल्यू नहीं।
• बिना कोट के ख़ास कैरेक्टर: जो वैल्यू *, &, !, %, @ या बैकटिक से शुरू होती हैं, या जिनमें : या # है, उन्हें कोट में रखना होता है।
• अनपेक्षित टाइप: yes, no, on और off YAML 1.2 में स्ट्रिंग हैं, पर पुराने YAML 1.1 पार्सर में बूलियन; सुरक्षित रहने के लिए इन्हें कोट में रखें। 1.10 जैसे वर्ज़न नंबर बिना कोट के संख्या 1.1 बन जाते हैं।

संरचना की जाँच

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