पायथन के मानक लाइब्रेरी से configparser मॉड्यूल Microsoft Windows OS द्वारा उपयोग की जाने वाली कॉन्फ़िगरेशन फ़ाइलों को पढ़ने और लिखने की कार्यक्षमता को परिभाषित करता है। ऐसी फ़ाइलों में आमतौर पर .INI एक्सटेंशन होता है।
INI फ़ाइल में अनुभाग होते हैं, प्रत्येक का नेतृत्व एक [section] हेडर द्वारा किया जाता है। वर्गाकार कोष्ठक के बीच, हम अनुभाग का नाम रख सकते हैं। अनुभाग के बाद कुंजी/मान प्रविष्टियाँ होती हैं जो = या : वर्ण द्वारा अलग की जाती हैं। इसमें टिप्पणियाँ शामिल हो सकती हैं, जिन्हें # या ; प्रतीक से उपसर्ग किया जाता है। एक नमूना INI फ़ाइल नीचे दिखाई गई है:
[Settings] # अतिरिक्त डीबगिंग जानकारी के लिए विस्तृत लॉग सेट करें DetailedLog=1 RunStatus=1 StatusPort=6090 StatusRefresh=10 Archive=1 # MV_FTP लॉग फ़ाइल का स्थान सेट करता है LogFile=/opt/ecs/mvuser/MV_IPTel/log/MV_IPTel.log Version=0.9 Build 4 ServerName=Unknown [FTP] # FTP सर्वर को सक्रिय सेट करें RunFTP=1 # FTP नियंत्रण पोर्ट को परिभाषित करता है FTPPort=21 # FTP डेटा निर्देशिका का स्थान सेट करता है FTPDir=/opt/ecs/mvuser/MV_IPTel/data/FTPdata # व्यवस्थापक नाम सेट करें UserName=admin # पासवर्ड सेट करें Password=admin
configparser मॉड्यूल में ConfigParser वर्ग होता है। यह कॉन्फ़िगरेशन फ़ाइलों की सूची को पार्स करने और पार्स किए गए डेटाबेस को प्रबंधित करने के लिए जिम्मेदार है।
ConfigParser का ऑब्जेक्ट निम्नलिखित कथन द्वारा बनाया जाता है:
parser = configparser.ConfigParser()
इस वर्ग में निम्नलिखित विधियाँ परिभाषित हैं:
| sections() | सभी कॉन्फ़िगरेशन अनुभाग नाम लौटाता है। |
| has_section() | दिए गए अनुभाग के अस्तित्व को लौटाता है। |
| has_option() | दिए गए अनुभाग में दिए गए विकल्प के अस्तित्व को लौटाता है। |
| options() | नामित अनुभाग के लिए कॉन्फ़िगरेशन विकल्पों की सूची लौटाता है। |
| read() | नामित कॉन्फ़िगरेशन फ़ाइल को पढ़ता है और पार्स करता है। |
| read_file() | एक कॉन्फ़िगरेशन फ़ाइल को पढ़ता है और पार्स करता है, जिसे फ़ाइल ऑब्जेक्ट के रूप में दिया जाता है। |
| read_string() | दिए गए स्ट्रिंग से कॉन्फ़िगरेशन पढ़ता है। |
| read_dict() | शब्दकोश से कॉन्फ़िगरेशन पढ़ता है। कुंजियाँ अनुभाग नाम हैं, मान कुंजियों और मानों वाले शब्दकोश हैं जो अनुभाग में मौजूद होने चाहिए। |
| get() | नामित विकल्प के लिए एक स्ट्रिंग मान लौटाता है। |
| getint() | get() की तरह, लेकिन मान को पूर्णांक में बदलता है। |
| getfloat() | get() की तरह, लेकिन मान को फ्लोट में बदलता है। |
| getboolean() | get() की तरह, लेकिन मान को बूलियन में बदलता है। False या True लौटाता है। |
| items() | अनुभाग में प्रत्येक विकल्प के लिए (नाम, मान) वाले टपल्स की सूची लौटाता है। |
| remove_section() | दिए गए फ़ाइल अनुभाग और उसके सभी विकल्पों को हटा देता है। |
| remove_option() | दिए गए अनुभाग से दिए गए विकल्प को हटा देता है। |
| set() | दिए गए विकल्प को सेट करता है। |
| write() | .ini प्रारूप में कॉन्फ़िगरेशन स्थिति लिखता है। |
निम्नलिखित स्क्रिप्ट 'sampleconfig.ini' फ़ाइल को पढ़ती और पार्स करती है:
import configparser
parser = configparser.ConfigParser()
parser.read('sampleconfig.ini')
for sect in parser.sections():
print('Section:', sect)
for k,v in parser.items(sect):
print(' {} = {}'.format(k,v))
print()
आउटपुट
Section: Settings detailedlog = 1 runstatus = 1 statusport = 6090 statusrefresh = 10 archive = 1 logfile = /opt/ecs/mvuser/MV_IPTel/log/MV_IPTel.log version = 0.9 Build 4 servername = Unknown Section: FTP runftp = 1 ftpport = 21 ftpdir = /opt/ecs/mvuser/MV_IPTel/data/FTPdata username = admin password = admin
write() विधि का उपयोग कॉन्फ़िगरेशन फ़ाइल बनाने के लिए किया जाता है। निम्नलिखित स्क्रिप्ट पार्सर ऑब्जेक्ट को कॉन्फ़िगर करती है और इसे 'test.ini' का प्रतिनिधित्व करने वाले फ़ाइल ऑब्जेक्ट में लिखती है:
import configparser
parser = configparser.ConfigParser()
parser.add_section('Manager')
parser.set('Manager', 'Name', 'Ashok Kulkarni')
parser.set('Manager', 'email', 'ashok@gmail.com')
parser.set('Manager', 'password', 'secret')
fp = open('test.ini', 'w')
parser.write(fp)
fp.close()