वैकल्पिक इंडेंटेशन और कुंजी सॉर्टिंग के साथ YAML कॉन्फ़िगरेशन को TOML में बदलें।
वैकल्पिक इंडेंटेशन और कुंजी सॉर्टिंग के साथ YAML कॉन्फ़िगरेशन को TOML में बदलें। वैकल्पिक इंडेंटेशन और कुंजी सॉर्टिंग के साथ YAML कॉन्फ़िगरेशन को TOML में बदलें।
YAML और TOML दोनों मानव-पठनीय कॉन्फ़िगरेशन प्रारूप बनना चाहते हैं। वे उस डेटा पर जिसका वे प्रतिनिधित्व कर सकते हैं भारी रूप से ओवरलैप करते हैं (मैपिंग्स, सीक्वेंसेस, स्केलर्स), पर वे वाक्यरचना और कुछ कोने के मामलों में भिन्न होते हैं। YAML टैग, एंकर, और मल्टी-लाइन स्केलर्स का समर्थन करता है; TOML इनलाइन टेबल्स और array-of-tables के बीच भेद करता है, और तिथियों को प्रथम-श्रेणी प्रकार के रूप में मानता है।
YAML से TOML कनवर्टर तब सबसे उपयोगी होता है जब किसी कॉन्फ़िग
फ़ाइल को किसी एक उपकरण की पसंदीदा प्रारूप से दूसरे की प्रारूप में स्थानांतरित किया जा रहा हो: उदाहरण के लिए,
किसी Kubernetes मैनिफेस्ट को एक pyproject.toml स्निपेट में ले जाना, या
किसी Ansible इन्वेंटरी को किसी Cargo [dependencies]
टेबल में पुनः व्यक्त करना।
मैपिंग्स (YAML में key: value) संदर्भ के आधार पर TOML टेबल्स या कुंजी/मान
जोड़े बन जाते हैं। सीक्वेंसेस इनलाइन सरणियाँ या
[[array.of.tables]] हेडर्स बन जाते हैं। स्केलर्स तब तक संरक्षित रहते हैं जब तक कि
वे साफ़ मैप होते हैं: स्ट्रिंग्स, इंटीजर्स, फ़्लोट्स, बूलियन, और ISO
तिथियाँ।
YAML एंकर और एलियस पार्सिंग के दौरान समतल किए जाते हैं;
परिवर्तित TOML हर एलियस साइट पर ठोस मान रखता है,
जो अधिकांश उपभोक्ता चाहते हैं। YAML !!binary टैग
संरक्षित नहीं होते क्योंकि TOML के पास कोई समकक्ष नहीं है। टिप्पणियाँ जानबूझकर
हटा दी जाती हैं -- न तो कोई प्रारूप गोल-यात्रा संरक्षण की गारंटी देता है।
परिवर्तित TOML कमिट करने से पहले, अपने प्रोजेक्ट का TOML लिंटर चलाएँ (taplo, toml-check, आदि)। कनवर्टर केवल वाक्यरचना का अनुवाद करता है, शैली का नहीं; लिंटर कोटिंग, इंडेंटेशन, और कुंजी-क्रम के मुद्दों को पकड़ लेता है जिन्हें कनवर्टर नहीं पहचान सकता।