configparser.ConfigParser参数详解

从configparser的__ini__中可以看到有如下参数:



def __init__(self, defaults=None, dict_type=_default_dict,
                 allow_no_value=False, *, delimiters=('=', ':'),
                 comment_prefixes=('#', ';'), inline_comment_prefixes=None,
                 strict=True, empty_lines_in_values=True,
                 default_section=DEFAULTSECT,
                 interpolation=_UNSET, converters=_UNSET):



 

defaults:设置参数的默认值,这里参数是对所有section下的相同参数,如果没有则使用这里设置的值,如下:



import configparser
import os

filepath = os.path.join(os.getcwd(),'config.ini')
print(filepath)
#增加参数defaults
cp = configparser.ConfigParser(defaults = {'globalmd5':'parametertest'})
print(cp.defaults())
cp.read(filepath)

#删除前分别读取password和IP俩个section下globalmd5的值
get_password_globalmd5 = cp.get('password','globalmd5')
get_IP_minimd5 = cp.get('IP','globalmd5')
print('password_globalmd5:',get_password_globalmd5)
print('IP_globalmd5',get_IP_minimd5)
#删除globalmd5参数
cp.remove_option('password','globalmd5')
#删除后读取globalmd5和minimd5的值
get_password_globalmd5 = cp.get('password','globalmd5')
get_IP_minimd5 = cp.get('IP','globalmd5')
print('password_globalmd5:',get_password_globalmd5)
print('IP_globalmd5',get_IP_minimd5)



上述代码执行结果为:



D:\PycharmProjects\untitled\MyTestProject\MyLearn\config.ini OrderedDict([('globalmd5', 'parametertest')]) password_globalmd5: functest IP_globalmd5 parametertest password_globalmd5: parametertest IP_globalmd5 parametertest



可以看到删除了‘password’节点下的globalmd5后,依然可以获取defaults中的globalmd5的值

此时config.ini文件中会存在default节点,option则为设置的默认globalmd5

 

dict_type:字典类型,默认为OrderedDict

 

allow_no_value:是否允许option的值为空,默认为False,即不允许为空,若为空则报错,如下代码为option设置为空情况:



import configparser
import os

filepath = os.path.join(os.getcwd(),'config.ini')
print(filepath)

cp = configparser.ConfigParser()
print(cp.defaults())
cp.read(filepath)

#设置option值为空
cp.set('IP','url')

with open(filepath,'w+') as f:
    cp.write(f)



运行代码后报错信息如下:



Traceback (most recent call last):
  File "D:/PycharmProjects/untitled/MyTestProject/MyLearn/temp.py", line 11, in <module>
    cp.set('IP','url')
  File "D:\Python37\lib\configparser.py", line 1197, in set
    self._validate_value_types(option=option, value=value)
  File "D:\Python37\lib\configparser.py", line 1182, in _validate_value_types
    raise TypeError("option values must be strings")
TypeError: option values must be strings
D:\PycharmProjects\untitled\MyTestProject\MyLearn\config.ini



倒数第二行清楚写了option的值必须为str类型。

如果把allow_no_value的值修改为True,代码如下:



import configparser
import os

filepath = os.path.join(os.getcwd(),'config.ini')
print(filepath)
#修改allow_no_value值为True
cp = configparser.ConfigParser(allow_no_value = True)
cp.read(filepath)

#设置option值为空
cp.set('IP','url')

with open(filepath,'w+') as f:
    cp.write(f)



 

则不会报错,查看config.ini文件发现多加了一行url,但没有值:



[password]
globalmd5 = functest

[IP]
port = 9900
address = http://sdv.functest.com
url



 

delimiters:分隔符,即参数和值之间的分隔符,默认为冒号(:)和等号(=),也可以自定义分隔符,如下所示,修改config.ini中使用大于号(>)作为分隔符:



[password]
globalmd5 > functest

[IP]
port > 9900
address > http://sdv.functest.com



 

修改代码使用(>)作为分隔符来操作:



import configparser
import os

filepath = os.path.join(os.getcwd(),'config.ini')
print(filepath)
#修改分隔符为>
cp = configparser.ConfigParser(delimiters = ('>'))
cp.read(filepath)

get_port = cp.get('IP','port')
print(get_port)



执行代码可以打印正确的值

 

comment_prefixes:注释前缀,默认为井号(#)或分号(;),可以自己修改,如果分设定的前缀会报错

 

inline_comment_prefixes:非空行后的注释前缀,默认是没有的,如若确实需要可以添加,修改config.ini文件如下:



[password]
#hello
globalmd5 = functest

[IP]
port =  9900 #hello
address = http://sdv.functest.com



若不设置inline_comment_prefixes,则port后面的#hello是最为port的值的,如下代码:



import configparser
import os

filepath = os.path.join(os.getcwd(),'config.ini')
print(filepath)

cp = configparser.ConfigParser()
cp.read(filepath)

get_port = cp.get('IP','port')
print(get_port)



代码执行结果如下:



D:\PycharmProjects\untitled\MyTestProject\MyLearn\config.ini 9900 #hello



若我们把#设置为行内注释符,那么就显示正确了:



import configparser
import os

filepath = os.path.join(os.getcwd(),'config.ini')
print(filepath)
#修改行内分隔符为#
cp = configparser.ConfigParser(inline_comment_prefixes = '#')
cp.read(filepath)

get_port = cp.get('IP','port')
print(get_port)



上述代码执行结果如下:



D:\PycharmProjects\untitled\MyTestProject\MyLearn\config.ini 9900



 

strict:是否允许单一配置文件中有相同的section或同一section中有相同option,默认为True,不允许。修改config.ini文件复制globalmd5项并修改值如下:



import configparser
import os

filepath = os.path.join(os.getcwd(),'config.ini')
print(filepath)

cp = configparser.ConfigParser()
cp.read(filepath)

get_globalmd5 = cp.get('password','globalmd5')
print(get_globalmd5)



可以看到执行报错了:



Traceback (most recent call last):
  File "D:/PycharmProjects/untitled/MyTestProject/MyLearn/temp.py", line 8, in <module>
    cp.read(filepath)
  File "D:\Python37\lib\configparser.py", line 696, in read
D:\PycharmProjects\untitled\MyTestProject\MyLearn\config.ini
    self._read(fp, filename)
  File "D:\Python37\lib\configparser.py", line 1091, in _read
    fpname, lineno)
configparser.DuplicateOptionError: While reading from 'D:\\PycharmProjects\\untitled\\MyTestProject\\MyLearn\\config.ini' [line  3]: option 'globalmd5' in section 'password' already exists



最后报错信息时globalmd5重复了,修改strict为False,如下代码:



import configparser
import os

filepath = os.path.join(os.getcwd(),'config.ini')
print(filepath)

cp = configparser.ConfigParser(strict = False)
cp.read(filepath)

get_globalmd5 = cp.get('password','globalmd5')
print(get_globalmd5)



执行结果为:



D:\PycharmProjects\untitled\MyTestProject\MyLearn\config.ini functest2



使用的是后一个globalmd5的值

 

empty_lines_in_values:option的值是否允许有空行,默认为True,允许有空行。修改config.ini文件如下:



[password]
globalmd5 = functest

[IP]
port = 9900
address = http://sdv.fu

    nctest.com



此时使用如下代码查询address的值是OK的:



import configparser
import os

filepath = os.path.join(os.getcwd(),'config.ini')
print(filepath)

cp = configparser.ConfigParser()
cp.read(filepath)

get_address = cp.get('IP','address')
print(get_address)



若修改empty_lines_in_values为False,则会报错:



import configparser
import os

filepath = os.path.join(os.getcwd(),'config.ini')
print(filepath)

cp = configparser.ConfigParser(empty_lines_in_values = False)
cp.read(filepath)

get_address = cp.get('IP','address')
print(get_address)



 

default_section:默认section,默认的节点为‘default’,也可以指定为存在的section,如下代码可以证明:



import configparser
import os

filepath = os.path.join(os.getcwd(),'config.ini')
print(filepath)

cp = configparser.ConfigParser(default_section = 'IP')
cp.read(filepath)

print(cp.defaults())



上述代码执行结果为:



D:\PycharmProjects\untitled\MyTestProject\MyLearn\config.ini OrderedDict([('port', '9900'), ('address', 'http://sdv.functest.com')])



打印的是IP这个section下面option的键值对

 

interpolation:插值,默认值为_UNSET,支持section插值,不支持跨section插值,修改config.ini文件如下:



[password]
globalmd5 = functest

[IP]
port = 9900
address = http://sdv.functest.com:%(port)s



此时可以使用如下代码查询address的值:



import configparser
import os

filepath = os.path.join(os.getcwd(),'config.ini')
print(filepath)

cp = configparser.ConfigParser()
cp.read(filepath)

get_address = cp.get('IP','address')
print(get_address)



执行结果如下:



D:\PycharmProjects\untitled\MyTestProject\MyLearn\config.ini http://sdv.functest.com:9900



configparser自动把%(port)s解释为同section下port的值

如果需要跨section引用数据,需要使用ExtendedInterpolation这个子类,当然使用方法稍微不同,修改config.ini文件如下:



[password]
globalmd5 = functest

[IP]
port = 9900
address = http://sdv.${password:globalmd5}.com
port_test = ${port}



使用如下代码分别查询port_test和address的值:



import configparser
import os

filepath = os.path.join(os.getcwd(),'config.ini')
print(filepath)

cp = configparser.ConfigParser(interpolation = configparser.ExtendedInterpolation())
cp.read(filepath)

get_port = cp.get('IP','port_test')
get_address = cp.get('IP','address')
print(get_port)
print(get_address)



执行结果如下:



D:\PycharmProjects\untitled\MyTestProject\MyLearn\config.ini 9900 http://sdv.functest.com



这样就比较灵活的来配置文件了

但是不建议使用,因为和基础类的使用方法不一样,容易出错

 

converters:添加一个转换类型,同getint或getfloat。其值为一个字典类型,键为get*(),值为可调用的,比如getint也可以这样自定义:



import configparser
import os

filepath = os.path.join(os.getcwd(),'config.ini')
print(filepath)
#设置converters值为int转换
cp = configparser.ConfigParser(converters = {'toint':int})
cp.read(filepath)

get_port = cp.get('IP','port')
print(type(get_port))
get_port = cp.gettoint('IP','port')
print(type(get_port))

print(get_port)



上述代码执行结果如下:



D:\PycharmProjects\untitled\MyTestProject\MyLearn\config.ini <class 'str'> <class 'int'> 9900



可以看到,默认get到的是一个str类型,通过自定义的转换函数gettoint(),转换为了int型