TOML से YAML: सिंटैक्स मैप और गलतियों के साथ त्वरित रूपांतरण गाइड

TOML को YAML में बदलने का सबसे तेज़ तरीका yq -oy '.' file.toml है। मैन्युअल रूपांतरण के लिए, TOML के [table] हेडर को YAML के इंडेंटेड ब्लॉक से मैप करें, TOML ऐरे को डैश-प्रीफिक्स्ड लिस्ट में बदलें, और हमेशा अस्पष्ट स्ट्रिंग्स को उद्धृत करें ताकि “नॉर्वे समस्या” से बचा जा सके।

त्वरित रूपांतरण: yq CLI का उपयोग

TOML (टॉम्स ऑबवियस, मिनिमल लैंग्वेज) ने दिसंबर 2025 में अपना v1.1.0 संस्करण जारी किया, लेकिन YAML CI/CD पाइपलाइनों और Kubernetes मैनिफेस्ट्स के लिए मानक बना हुआ है। yq टूल एक ही कमांड में रूपांतरण करता है।

yq इंस्टॉल करें

प्लेटफ़ॉर्म	कमांड
macOS/Linux	`brew install yq`
Windows	`choco install yq`
Python (pip)	`pip install yq`

गति के लिए माइक फ़ाराह का Go-आधारित संस्करण पसंद किया जाता है। जैसा कि माइक फ़ाराह के yq दस्तावेज़ में बताया गया है, यह टूल TOML संरचना को डिकोड करके उसे साफ़ YAML के रूप में फिर से एनकोड करता है।

रूपांतरण चलाएँ

टर्मिनल में दिखाएँ:

yq -oy '.' your-config.toml

फ़ाइल में सहेजें:

yq -oy '.' your-config.toml > your-config.yaml

-oy फ़्लैग आउटपुट फ़ॉर्मेट को YAML पर सेट करता है। यह की-वैल्यू जोड़े, नेस्टेड टेबल और ऐरे को संभालता है।

3-चरणीय सरल टर्मिनल रूपांतरण प्रक्रिया

सिंटैक्स अनुवाद मैप: TOML संरचना से YAML में

डेवलपर ड्रू डेवॉल्ट ने बताया है कि हालांकि TOML लोकप्रिय है, YAML गहरी नेस्टिंग को अधिक साफ़ तरीके से संभालता है। यहाँ सटीक मैपिंग है:

टेबल से इंडेंटेड कीज़ तक

TOML ब्रैकेट हेडर का उपयोग करता है; YAML इंडेंटेशन का।

TOML	YAML
`[server]`	`server:`
`host = "127.0.0.1"`	`host: 127.0.0.1`
`port = 8080`	`port: 8080`

महत्वपूर्ण अंतर: TOML में इंडेंटेशन सजावटी है। YAML में इंडेंटेशन संरचनात्मक है — एक गलत स्पेस पूरी कॉन्फ़िगरेशन को खराब कर देती है।

ऐरे से डैश-प्रीफिक्स्ड लिस्ट तक

TOML: ports = [ 8000, 8001 ]

YAML:

ports:
  - 8000
  - 8001

TOML बनाम YAML की संरचनात्मक तुलना

जैसा कि Knightli.com समझाता है, YAML की “ब्लॉक स्टाइल” सूचियों को पठनीय बनाती है, बशर्ते लंबवत संरेखण सुसंगत हो।

इनलाइन टेबल और डॉटेड कीज़

TOML रचना	YAML समकक्ष
`[a.b.c]` (डॉटेड हेडर)	`a:` → `b:` → `c:` (नेस्टेड इंडेंटेशन)
`point = { x = 1, y = 2 }` (इनलाइन टेबल)	`point:` → `x: 1` → `y: 2`

वास्तविक दुनिया के उपयोग के मामले

Hugo स्टैटिक साइट कॉन्फ़िगरेशन

Hugo hugo.toml, hugo.yaml या hugo.json स्वीकार करता है। अधिकांश प्रोजेक्ट TOML (डिफ़ॉल्ट) से शुरू होते हैं, फिर YAML में माइग्रेट करते हैं जब कॉन्फ़िगरेशन को Netlify या GitHub Actions जैसे डिप्लॉयमेंट प्लेटफ़ॉर्म के साथ संरेखित करने की आवश्यकता होती है। हैमर यूरोप बताता है कि hugo कमांड इन फ़ाइलों को पढ़कर यह निर्धारित करता है कि Markdown लाइव साइट में कैसे बदलता है।

Python पैकेजिंग: pyproject.toml से CI/CD YAML तक

Python समुदाय ने PEP 518 के माध्यम से pyproject.toml को मानकीकृत किया। इन सेटिंग्स को अक्सर GitHub Actions CI/CD वर्कफ़्लो के लिए YAML में अनुवादित करने की आवश्यकता होती है। AI एजेंट वर्कफ़्लो के लिए, CocoIndex रिपोर्ट करता है कि अनुकूलित YAML कॉन्फ़िगरेशन टोकन उपयोग को 70% तक कम कर सकते हैं।

नॉर्वे समस्या और अन्य रूपांतरण गलतियाँ

`NO` देश कोड बग

YAML 1.1 में, NO, OFF और YES जैसी बेयर स्ट्रिंग्स स्वचालित रूप से बूलियन false या true में बदल जाती हैं। TOML सभी स्ट्रिंग्स पर उद्धरणों की आवश्यकता करके इससे बचता है। रूपांतरण करते समय, हमेशा YAML में अस्पष्ट मानों को उद्धृत करें:

मान	YAML 1.1 व्याख्या	समाधान
`NO`	`false`	`"NO"`
`OFF`	`false`	`"OFF"`
`YES`	`true`	`"YES"`
`On`	`true`	`"On"`

YAML 1.2 (वर्तमान विनिर्देश) इनमें से अधिकांश कोersion को ठीक करता है, लेकिन कई पार्सर अभी भी डिफ़ॉल्ट रूप से 1.1 व्यवहार का उपयोग करते हैं।

'नॉर्वे समस्या' के लिए दृश्य रूपक (बूलियन बनाम स्ट्रिंग)

इंडेंटेशन त्रुटियाँ

YAML पार्सर असंगत इंडेंटेशन वाली फ़ाइलों को अस्वीकार करते हैं। सामान्य गलतियाँ:

टैब और स्पेस का मिश्रण (YAML टैब प्रतिबंधित करता है)
एक ब्लॉक में 3 स्पेस और दूसरे में 2 का उपयोग
गलत संरेखित लिस्ट आइटम

AI-सहायित जनरेशन

AgentBuilder जैसे टूल आपको सादा अंग्रेज़ी में कॉन्फ़िगरेशन का वर्णन करने और सत्यापित YAML आउटपुट करने की अनुमति देते हैं। यह “वर्णन → जनरेट → सत्यापन” चक्र इंडेंटेशन त्रुटियों और नॉर्वे समस्या दोनों से बचने में मदद करता है।

निष्कर्ष

स्वचालित रूपांतरण के लिए yq -oy '.' file.toml का उपयोग करें। मैन्युअल कार्य के लिए, TOML टेबल को YAML इंडेंटेशन में मैप करें, ऐरे को डैश-प्रीफिक्स्ड लिस्ट में बदलें, और हमेशा उन स्ट्रिंग्स को उद्धृत करें जिन्हें बूलियन समझा जा सकता है। किसी भी रूपांतरण के बाद, डिप्लॉय करने से पहले YAML आउटपुट को मान्य करें — एक गलत संरेखित स्पेस या बिना उद्धृत NO आपकी पूरी पाइपलाइन को खराब कर सकता है।

अक्सर पूछे जाने वाले प्रश्न

क्या YAML TOML की तरह टिप्पणियों का समर्थन करता है?

हाँ। दोनों एकल-पंक्ति टिप्पणियों के लिए # का उपयोग करते हैं। YAML टिप्पणियाँ बहु-पंक्ति स्ट्रिंग पार्सिंग में हस्तक्षेप कर सकती हैं, इसलिए संदेह होने पर उन्हें अलग पंक्तियों पर रखें।

YAML में ‘नॉर्वे समस्या’ क्या है?

YAML 1.1 में, NO (नॉर्वे का देश कोड) जैसी बेयर स्ट्रिंग्स स्वचालित रूप से बूलियन false में बदल जाती हैं। TOML सभी स्ट्रिंग मानों पर उद्धरणों की आवश्यकता करके इससे बचता है। TOML को YAML में बदलते समय, किसी भी संभावित अस्पष्ट स्ट्रिंग को उद्धरण चिह्नों में लपेटें।

कौन सा फ़ॉर्मेट गहरी नेस्टिंग को बेहतर तरीके से संभालता है?

YAML। TOML को प्रत्येक स्तर के लिए [table.subtable.subsubtable] जैसे लंबे हेडर दोहराने की आवश्यकता होती है, जो वर्बोज़ हो जाता है। YAML समान पदानुक्रम को इंडेंटेशन से दर्शाता है — गहराई में अधिक संक्षिप्त और पठनीय।