configparser
configParser 模块用于操作配置文件
注:Parser汉译为“解析”之意。
配置文件的格式与windows ini文件类似,可以包含一个或多个节(section),每个节可以有多个参数(键=值或者键:值)。
为了更好的理解本文,我们先了解一下配置文件的组成及命名:配置文件(INI文件)由节(section)、键、值组成。
样例配置文件config.ini
[book]title = ConfigParser模块教程time = 2018-01-12 11:47:37[size]size = 1024[other]blog = http://blog.51cto.com/kexiaoke
在config.ini里面出现了三个节(section),分别是book,size,other
book里面有两个键值对,size和other里面各一个。
读取配置文件
-read(filename) 直接读取ini文件内容
-sections() 得到所有的section,并以列表的形式返回
-options(section) 得到该section的所有option
-items(section) 得到该section的所有键值对
-get(section,option) 得到section中option的值,返回为string类型
-getint(section,option) 得到section中option的值,返回为int类型
增加或修改配置
-add_section(section) 添加一个新的section
-set( section, option, value) 对section中的option进行设置
需要调用write将内容写入配置文件。
获取config.ini配置示例
read_config.py
#!/usr/bin/env python# -*- coding: utf-8 -*-__author__ = 'xiaoke'__time__ = '2018-01-12 11:17'PROJECT_NAME = 'test_projtcts'#导入configparser模块import configparser#生成conf对象conf= configparser.ConfigParser()#加载config.ini文件内容conf.read('config.ini')#读取配置文件里所有的Sectionprint('读取配置文件里所有的Section')print(conf.sections())#打印出book这个section下包含keyprint('打印出book这个section下包含key')print(conf.options('book'))#打印test1这个section下所有的key及对应的valuesprint('打印book这个section下所有的key及对应的values')print(conf.items("book"))#指定section,option读取值print('获取book这section个title内容')print(conf.get('book','title'))
执行结果如下
读取配置文件里所有的Section['book', 'size', 'other']打印出book这个section下包含key['title', 'time']打印book这个section下所有的key及对应的values[('title', 'ConfigParser模块教程'), ('time', '2018-01-12 11:47:37')]获取book这section个title内容ConfigParser模块教程
在config.ini文件增加一个section
#!/usr/bin/env python# -*- coding: utf-8 -*-__author__ = 'xiaoke'__time__ = '2018-01-12 13:54'PROJECT_NAME = 'test_projtcts'#导入configparser模块import configparser#生成conf对象conf= configparser.ConfigParser()#加载config.ini文件内容conf.read('config.ini')#增加一个sectionconf.add_section('add_test')conf.set('add_test','name','xiaoke')conf.set('add_test','age','25')#添加完毕,必须调用write方法写入conf.write(open('config.ini','w'))#打印刚添加的内容print(conf.items('add_test'))
执行完成后会在配置文件如下的内容
conf.set('section','key','value')
[add_test]name = xiaokeage = 25
修改section的内容
#导入configparser模块import configparser#生成conf对象conf= configparser.ConfigParser()#加载config.ini文件内容conf.read('config.ini')#打印修改之前的值print(conf.items('add_test'))#修改add_test section的age键conf.set('add_test','age','27')#修改完毕,必须调用write方法写入conf.write(open('config.ini','w'))#打印修改之后的值print(conf.items('add_test'))
------------------------结果如下-----------------
修改之前的值
[('name', 'xiaoke'), ('age', '28')]
修改之后的值
[('name', 'xiaoke'), ('age', '27')]
删除section或者option
删除section
config.remove_section("add_test")conf.write(open('config.ini','w'))
删除option
conf.remove_option('add_test','age')conf.write(open('config.ini','w'))
注意要点
注意要点:
1.ConfigParser 在get 时会自动过滤掉‘#’或‘;’注释的行(内容);
一般情况下我们手工会把配置中的暂时不需要的用‘#’注释,问题在于,Configparser 在wirte的时候同file object行为一致,如果将注释’#’的配置经过get后,再wirte到conf,那么’#’的配置就会丢失。
那么就需要一个策略或规则,配置需不需要手工编辑 ?还是建立复杂的对原生文本的处理的东西,我建议是管住手,避免将一些重要的配置爆露给用户编辑,切记行内注释和Section内注释。
有一个相对简单的方法是: 对单独在一行的代码,你可以在读入前把”#”, “;”换成其他字符如’@’,或‘^’(在其bat等其他语言中用的注释符易于理解),使用allow_no_value选项,这样注释会被当成配置保存下来,处理后你再把“#”, “;”换回来。
2.在ConfigParser write之后,配置文本如果有大写字母’PRODUCT’会变为小写字母’product’,并不影响配置的正确读写。