التابع ConfigParser.read_dict()‎‎ في بايثون

يحمّل التابع الإعدادات من أي كائن يوفّر تابعًا شبيهًا بالتابع items()‎ في كائنات dict. تتضمّن المفاتيح أسماء الأقسام، أمّا القيم فعبارة عن قواميس تتضمّن المفاتيح والقيم التي تنطوي عليها الأقسام. إن كان القاموس المستخدم قادرًا على الاحتفاظ بترتيب العناصر، فستضاف الأقسام ومفاتيحها بحسب الترتيب. تُحوّل القيم إلى سلاسل نصية تلقائيًا.

يمكن استخدام هذا التابع لنسخ الحالة بين المحلّلات المختلفة.

البنية العامة

read_dict(dictionary, source='<dict>')

‎

المعاملات

dictionary

القاموس الذي سيقرأ التابع منه الإعدادات.

‎source

معامل اختياري يحدد اسمًا خاصًّا بالسياق context-specific name للقاموس الممرّر. تُستخدم القيمة <dict> في حال عدم استخدام هذا المعامل.

أمثلة

يبين المثال التالي طريقة عمل التابع:

>>> import configparser
>>> config = configparser.ConfigParser()
>>> cfgdict = {'bitbucket.org': {'User': 'hg'}, 'topsecret.server.com': {'Port': 50022, 'ForwardX11': 'no'}}
>>> config.read_dict(cfgdict)
>>> config.sections()
['bitbucket.org', 'topsecret.server.com']
>>> config.options('topsecret.server.com')
['port', 'forwardx11']

انظر أيضًا

• التابع read()‎: يحاول التابع قراءة وتفسير مكرِّر iterable من أسماء الملفات ويعيد قائمة بأسماء الملفات التي جرى تفسيرها بنجاح.
• التابع read_file()‎: يقرأ التابع ويفسّر الإعدادات من المكرِّر المعطى.
• التابع read_string()‎: يفسّر التابع الإعدادات من سلسلة نصية.

مصادر

• صفحة Configuration file parser في توثيق بايثون الرسمي.