YAML (YAML कोई मार्कअप भाषा नहीं है) एक मानव-हितैषी, क्रॉस-भाषा डेटा सीरियलाइजेशन भाषा है जो सामान्यतः कॉन्फ़िगरेशन फ़ाइलों के लिए उपयोग की जाती है और डेटा को मैपिंग, अनुक्रम और स्केलर के रूप में दर्शाती है। संस्करण 1.2 ने YAML को JSON का एक सख्त सुपरसेट बना दिया। प्रॉक्सी और स्क्रैपिंग कार्य में, YAML कॉन्फ़िगरेशन फ़ाइलों में दिखाई देता है। उदाहरण के लिए, Envoy प्रॉक्सी की स्थिर कॉन्फ़िगरेशन YAML में लिखी गई है और यह उन श्रोताओं और क्लस्टरों को परिभाषित करती है जिनके माध्यम से ट्रैफ़िक बहता है।
YAML सिंटैक्स की मूल बातें
- मैपिंग:
key: valueजोड़े, जैसे शब्दकोश या हैश। - अनुक्रम: सूचियाँ, प्रत्येक आइटम अपनी-अपनी पंक्ति में
-से शुरू होती हैं। - इंडेंटेशन: ब्लॉक शैली में, इंडेंटेशन संरचना को निर्धारित करता है, इसलिए एक गलत स्थान डेटा के अर्थ को बदल देता है।
- कोई टैब नहीं: इंडेंटेशन के लिए टैब वर्णों का उपयोग नहीं किया जाना चाहिए।
- टिप्पणियाँ: एक
#टिप्पणी शुरू करता है।
स्क्रैपर और प्रॉक्सी कॉन्फ़िग्स में YAML का सुरक्षित उपयोग
YAML पार्सर्स केवल साधारण डेटा पढ़ने से अधिक कर सकते हैं। PyYAML दस्तावेज़ चेतावनी देते हैं कि किसी अविश्वसनीय स्रोत से डेटा पर yaml.load कॉल करना सुरक्षित नहीं है, क्योंकि यह मनमाने Python ऑब्जेक्ट्स का निर्माण कर सकता है। इसका yaml.safe_load फ़ंक्शन केवल मानक YAML टैग्स को पहचानता है, जो इसे अविश्वसनीय इनपुट के लिए दस्तावेज़ित विकल्प बनाता है।
मल्टी-लाइन स्ट्रिंग्स, एंकर और कई दस्तावेज़
- लिटरल ब्लॉक (
|): एक मल्टी-लाइन स्ट्रिंग में हर लाइन ब्रेक को बनाए रखता है। - फोल्डेड ब्लॉक (
>): प्रत्येक लाइन ब्रेक को एक स्थान में बदल देता है, खाली या अधिक इंडेंटेड लाइनों के पहले छोड़कर। - एंकर और उपनाम:
&nameएक नोड को चिह्नित करता है, और*nameइसे बाद में दोहराने के बजाय पुनः उपयोग करता है। - कई दस्तावेज़:
---एक दस्तावेज़ की सामग्री की शुरुआत को चिह्नित करता है, इसलिए एक स्ट्रीम में कई दस्तावेज़ हो सकते हैं।...एक दस्तावेज़ को समाप्त करता है बिना एक नया शुरू किए।