14.7.6 选项搜索路径
ConfigParser查找选项时使用了一个多步搜索过程。开始搜索选项之前,首先会测试节名。如果这个节不存在,而且名不是特殊值DEFAULT,则产生一个NoSectionError异常。
1.如果选项名出现在传递到get()的vars字典中,则会返回vars的值。
2.如果选项名出现在指定的节中,则返回该节中的值。
3.如果选项名出现在FEFAULT节中,则会返回响应的值。
4.如果选项名出现在传递到构造函数的defaults字典中,则会返回响应的值。
如果这个名未出现在以上任何位置,则产生NoOptionError。
可以用以下配置文件来展示这个搜索路径行为。
以下代码清单中的测试程序包括配置文件中未指定的一些默认选项设置,并覆盖了文件中定义的一些值。
import configparser
# Define the names of the options.
option_names = [
'from-default',
'from-section','section-only',
'file-only','init-only','init-and-file',
'from-vars',
]
# Initialize the parser with some defaults.
DEFAULTS = {
'from-default': 'value from defaults passed to init',
'init-only': 'value from defaults passed to init',
'init-and-file': 'value from defaults passed to init',
'from-section': 'value from defaults passed to init',
'from-vars': 'value from defaults passed to init',
}
parser = configparser.ConfigParser(defaults=DEFAULTS)
print('Defaults before loading file:')
defaults = parser.defaults()
for name in option_names:
if name in defaults:
print(' {:<15} = {!r}'.format(name,defaults[name]))
# Load the configuration file.
parser.read('with-defaults.ini')
print('\nDefaults after loading file:')
defaults = parser.defaults()
for name in defaults:
print(' {:<15} = {!r}'.format(name,defaults[name]))
# Define some local overrides.
vars = {'from-vars':'value from vars'}
# Show the values of all the options.
print('\nOption lookup:')
for name in option_names:
value = parser.get('sect',name,vars=vars)
print(' {:<15} = {!r}'.format(name,value))
# Show error messages for options that do not exist.
print('\nError cases:')
try:
print('No such option :',parser.get('sect','no-option'))
except configparser.NoOptionError as err:
print(err)
try:
print('No such section:',parser.get('no-sect','no-option'))
except configparser.NoSectionError as err:
print(err)
输出显示了各个选项值的来源,并展示了不同来源的默认值是如何覆盖现有值的。