该模块用来解析Microsoft Windows INI文件,就是我们平常所说的ini文件。INI文件是一种按照特点方式排列的文本文件。每一个INI文件结构都非常类似,由若干段落(section)组成,在每个带括号的标题下面,是若干个以单个单词开头的关键词(keyword)和一个等号,等号右边的就是关键字对应的值(value)。其一般形式如下:
[Section1] KeyWord1 = Valuel KeyWord2 = Value2 [Section2] KeyWord3 = Value3 KeyWord4 = Value4
配置文件由section组成,每个section里面由name=value或者name:value组成,values中的空白符会被移除,在同一个section下的values可以包含该section下的其他values,以格式化字符串的形式表现,或者该values在DEFAULT section中定义过。额外的DEFAULT section可以提供values的初始化,以#开头的为注释。
该模块下有三个类:
ConfigParser.RawConfigParser([defaults[, dict_type[, allow_no_value]]])
这是基本的配置类,该类不支持魔术插入。方法如下:RawConfigParser.defaults() 返回一个包含全部实例的字典RawConfigParser.sections() 返回一个包含有效section的列表,DEFAULT不包含在该列表中RawConfigParser.add_section(section) 增加一个section,如果section存在DuplicateSectionError会被触发。RawConfigParser.has_section(section) 判断section是否在配置文件中存在RawConfigParser.options(section) 返回section中可用的options 列表RawConfigParser.has_option(section, option) 判断section中是否存在optionsRawConfigParser.read(filenames) 读入被解析的配置文件RawConfigParser.readfp(fp[, filename]) 读入并解析配置文件RawConfigParser.get(section, option) 获取section中option的值RawConfigParser.getint(section, option) 已整形返回option的值RawConfigParser.getfloat(section, option) 同理上面,返回floatRawConfigParser.getboolean(section, option)RawConfigParser.items(section) 以列表(name,value)的形式返回section中的每个值RawConfigParser.set(section, option, value) 如果section存在,则设置该option和value,否则引起NoSectionError.RawConfigParser.write(fileobject) 配置写入配置文件中RawConfigParser.remove_option(section, option) 移除section中的option,如果section不存在,引起NoSectionError,移除后返回True,否则返回FalseRawConfigParser.remove_section(section) 移除section,返回True/FalseRawConfigParser.optionxform(option)
ConfigParser.ConfigParser([defaults[, dict_type[, allow_no_value]]])
该类是RawConfigParser的派生类。支持魔术插入,增加了get和items方法。ConfigParser.get(section, option[, raw[, vars]]) 获取section中option的值,ConfigParser.items(section[, raw[, vars]]) 返回一个由(name,value)组成的列表对
ConfigParser.SafeConfigParser([defaults[, dict_type[, allow_no_value]]])
该类是ConfigParser的派生类,支持更多的魔术插入。 SafeConfigParser.set(section, option, value) 如果section存在,则设置option的值。value必须是string。
生成ini配置文件
#!/usr/bin/python import ConfigParserconf=ConfigParser.RawConfigParser()conf.add_section('section1')conf.add_section('section2')conf.set('section1','name1','guol')conf.set('section1','name2','alex')conf.set('section2','name3','polo')conf.set('section2','name4','mark')conffile=open('file.ini','wb')conf.write(conffile)结果如下:
解析ini配置文件
import ConfigParserconf=ConfigParser.RawConfigParser()conf.read('file.ini')if conf.has_section('section2'): print 'Exist section2'if conf.has_option('section2','name3'): print 'section2 has opetion name3, is value' + ' ' +conf.get('section2','name3')结果如下:
魔术插入
import ConfigParserconf1=ConfigParser.ConfigParser()conf1.read('file.ini')conf2=ConfigParser.RawConfigParser()conf2.read('file.ini')print 'Use ConfigParser()'print '''conf1.get('section3','name3',0)'''print conf1.get('section3','name3',0)print '''conf1.get('section3','name3',1)'''print conf1.get('section3','name3',1)print '================================'print 'Use RawConfigParser()'print '''conf2.get('section3','name3')'''print conf2.get('section3','name3')结果如下: