INI को XML में बदलें

यह mapping इतनी सीधी है कि पहले से बताई जा सकती है। एक section header एक element बनता है, उसके नीचे हर key उसकी child element बनती है, और value वह element text बनती है।

यह अनुमान लगाने लायक़ी ही इस जोड़ी को किसी टूल के हक़दार बनाती है, बजाय script के। INI फ़ाइल किसी कन्वर्टर को समझने के लिए लगभग कुछ नहीं देती — एक level की grouping, एक key, एक value प्रति लाइन।

XML को ठीक एक बाहरी element चाहिए और INI फ़ाइल के पास इसकी कोई अवधारणा नहीं। Converter इसे इस तरह हल करता है — अगर फ़ाइल में सिर्फ़ एक section था और कुछ नहीं, वह section root बन जाता है।

कुछ और भी हो तो एक generic root element में लपेटा जाता है। यह उस पल जानना ज़रूरी है जब आप नतीजे के ख़िलाफ़ कोई XSD या XPath लिखें — दूसरा section जोड़ने से root चुपचाप settings से root में बदल जाता है।

INI में बिल्कुल कोई type system नहीं है — equals sign के दाईं तरफ़ जो कुछ है वह अक्षर हैं। Reader फिर भी अंदाज़ा लगाता है, true और false को boolean बनाता है और जो संख्या जैसा parse होता है उसे संख्या बनाता है।

कुछ के लिए यह ग़लत भी होता है। 007 लिखी value 7 पढ़ी जाती है और 7 के रूप में वापस लिखी जाती है। 0x1F लिखा hexadecimal mask 31 बनकर निकलता है। जो कुछ किसी इकाई के साथ है वह बरक़रार रहता है — 128M वैसा ही रहता है।

XML नामों को लेकर INI से कहीं ज़्यादा सख़्त है। किसी INI key में space, slash या brackets हो सकते हैं; element नाम में अक्षर, अंक, underscore, hyphen और full stop के अलावा लगभग कुछ नहीं हो सकता।

Writer इसलिए हर वह character underscore से बदल देता है जो इस्तेमाल नहीं कर सकता, और किसी अंक से शुरू होने वाले नाम के आगे underscore जोड़ता है। यह बदलाव उलटा नहीं है, इसलिए दो अलग keys एक ही element नाम में मिल सकती हैं।

किसी [database.pool] जैसे section header को nest होना चाहिए ऐसा दिखता है, और TOML में यह होता। यहाँ नहीं होता — reader brackets के बीच सब कुछ एक ही section नाम मानता है।

अगर लक्ष्य schema को असली nesting चाहिए, वह structure रूपांतरण से नहीं बनना चाहिए — इसे बाद में XSLT से या हाथ से फिर से बनाना होगा।

INI का कोई मानक नहीं, सिर्फ़ परंपराएँ हैं, और यह reader दोहराए section को merge नहीं करता — यह हर बार एक नई ख़ाली section बनाता है, इसलिए दो बार आई [logging] सिर्फ़ दूसरी घटना की keys रखती है, बिना कोई त्रुटि दिए।

यह विफलता ख़ामोश है और नतीजा पूरी तरह valid XML दस्तावेज़ है जिसमें बस कुछ settings छूट गई हों। बदलने से पहले स्रोत में duplicate headers ढूँढ लीजिए।

दोनों फ़ॉर्मेट comments सँभालते हैं। INI इन्हें semicolon या hash से चिह्नित करता है, XML angle-bracket block से, और यह रूपांतरण इनमें से किसी को पार नहीं करता।

किसी configuration फ़ाइल पर यह सुनने से ज़्यादा मायने रखता है। किसी timeout के ऊपर की लाइन जो बताती है वह 90 सेकंड पर क्यों सेट है, अक्सर उस फ़ैसले का एकमात्र रिकॉर्ड होता है।

इसे बदलने की वजह लगभग कभी syntax नहीं होती। XML 1.0 1998 से W3C recommendation है, और इसके इर्द-गिर्द वह machinery है जो INI के पास कभी नहीं थी — XSD schemas, XPath, XSLT, XML digital signatures।

इनमें से कुछ भी रूपांतरण के साथ नहीं आता। आउटपुट एक well-formed दस्तावेज़ है, बिना attached schema के — schema लिखना असली काम है।

अगर फ़ाइल पढ़ने वाला application वही है जिसने इसे लिखा, और किसी downstream को schema नहीं चाहिए, बदलना बिना किसी फ़ायदे की क़ीमत है। INI फ़ाइल किसी को भी edit करने देती है जो Notepad खोल सकता है।

यह रूपांतरण तब भी ग़लत टूल है जब असल में सिर्फ़ दो-तीन values चाहिए, पूरी फ़ाइल नहीं। उन्हें सीधे पढ़ लीजिए। यह converter उस मामले के लिए है जहाँ INI फ़ाइल ही config है और config कहीं और जा रहा है।