Python 标准库的 ConfigParser 模块提供一套 API 来读取和操作配置文件。
配置文件的格式a) 配置文件中包含一个或多个 section, 每个 section 有自己的 option;
b) section 用[sect_name]表示,每个option是一个键值对,使用分隔符 =或:隔开;
c) 在 option 分隔符两端的空格会被忽略掉
d) 配置文件使用 # 和 ; 注释
一个简单的配置文件样例 myapp.conf
# database source
[db]
host = 127.0.0.1
port = 3306
user = root
pass = root
# ssh
[ssh]
host = 192.168.1.101
user = huey
pass = huey
ConfigParser 的基本操作a) 实例化 ConfigParser 并加载配置文件
cp =ConfigParser.SafeConfigParser()
cp.read('myapp.conf')
b) 获取 section 列表、option 键列表和 option 键值元组列表
PRint'all sections:', cp.sections()#sections: ['db', 'ssh']print'options of [db]:', cp.options('db')#options of [db]: ['host', 'port', 'user', 'pass']print'items of [ssh]:', cp.items('ssh')#items of [ssh]: [('host', '192.168.1.101'), ('user', 'huey'), ('pass', 'huey')]
c) 读取指定的配置信息
print'host of db:', cp.get('db','host')#host of db: 127.0.0.1print'host of ssh:', cp.get('ssh','host')#host of ssh: 192.168.1.101
d) 按类型读取配置信息:getint、 getfloat 和 getboolean
printtype(cp.getint('db','port'))#<type 'int'>
e) 判断 option 是否存在
printcp.has_option('db','host')#True
f) 设置 option
cp.set('db','host','192.168.1.102')
g) 删除 option
cp.remove_option('db','host')
h) 判断 section 是否存在
printcp.has_section('db')#True
i) 添加 section
cp.add_section('new_sect')
j) 删除 section
cp.remove_section('db')
k) 保存配置,set、 remove_option、 add_section 和 remove_section 等操作并不会修改配置文件,write 方法可以将 ConfigParser 对象的配置写到文件中
cp.write(open('myapp.conf','w'))
cp.write(sys.stdout)
Unicode 编码的配置配置文件如果包含 Unicode 编码的数据,需要使用 codecs 模块以合适的编码打开配置文件。
myapp.conf
[msg]
hello = 你好
config_parser_unicode.py
importConfigParserimportcodecs
cp=ConfigParser.SafeConfigParser()
with codecs.open('myapp.conf','r', encoding='utf-8') as f:
cp.readfp(f)printcp.get('msg','hello')
allow_no_value通常情况下, option 是一个键值对。但是,当 SafeConfigParser 的参数 allow_no_value 设置成 True 时,它允许 option 不设置值而只是作为一个标识。
allow_no_value.conf
# option as Flag
[flag]
flag_opt
allow_no_value.py
importConfigParser
cp= ConfigParser.SafeConfigParser(allow_no_value =True)
cp.read('myapp.conf')printcp.get('flag','flag_opt');#None
allow_no_value 默认设置成 False,此时如果配置文件中存在没有设置值的 option,在读取配置文件时将抛出异常 ConfigParser.ParsingError。当 allow_no_value 设置成 True 时,如果一个 option 没有设置值,has_option 方法会返回 True,get 方法会返回 None。
DEFAULT section如果配置文件中存在一个名为 DEFAULT 的 section,那么其他 section 会扩展它的 option 并且可以覆盖它的 option。
db.conf
[DEFAULT]
host = 127.0.0.1
port = 3306
[db_root]
user = root
pass = root
[db_huey]
host = 192.168.1.101
user = huey
pass = huey
default_section.py
printcp.get('db_root','host')#127.0.0.1printcp.get('db_huey','host')#192.168.1.101
插值 InterpolationSafeConfigParser 提供了插值的特性来结合数据。
url.conf
[DEFAULT]
url= %(protocol)s://%(server)s:%(port)s/[http]
protocol=http
server=localhost
port= 8080[ftp]
url= %(protocol)s://%(server)s/protocol=ftp
server= 192.168.1.102
interpolation_demo.py
importConfigParser
cp=ConfigParser.SafeConfigParser()
cp.read('url.conf')printcp.get('http','url')#http://localhost:8080/printcp.get('ftp','url')#ftp://192.168.1.102/
更多 ConfigParser 的使用,参考:
http://pymotw.com/2/ConfigParser/index.htmlhttps://docs.python.org/2/library/configparser.html