Python(2.7.6) ConfigParser - 讀寫設定檔

標籤：

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

print type(cp.getint(‘db‘, ‘port‘))        # <type ‘int‘>

e) 判斷 option 是否存在

print cp.has_option(‘db‘, ‘host‘)    # True

f) 設定 option

cp.set(‘db‘, ‘host‘,‘192.168.1.102‘)

g) 刪除 option

cp.remove_option(‘db‘, ‘host‘)

h) 判斷 section 是否存在

print cp.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)

 

allow_no_value

通常情況下， option 是一個索引值對。但是，當 SafeConfigParser 的參數 allow_no_value 設定成 True 時，它允許 option 不設定值而只是作為一個標識。

allow_no_value.conf

# option as Flag
[flag]
flag_opt

allow_no_value.py

import ConfigParsercp = ConfigParser.SafeConfigParser(allow_no_value = True)cp.read(‘myapp.conf‘)print cp.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.1port = 3306[db_root]user = rootpass = root[db_huey]host = 192.168.1.101user = hueypass = huey

default_section.py

print cp.get(‘db_root‘, ‘host‘)    # 127.0.0.1print cp.get(‘db_huey‘, ‘host‘)    # 192.168.1.101

 

插值 Interpolation

SafeConfigParser 提供了插值的特性來結合資料。

url.conf

[DEFAULT]url = %(protocol)s://%(server)s:%(port)s/[http]protocol = httpserver = localhostport = 8080[ftp]url = %(protocol)s://%(server)s/protocol = ftpserver = 192.168.1.102

interpolation_demo.py

import ConfigParsercp = ConfigParser.SafeConfigParser()cp.read(‘url.conf‘)print cp.get(‘http‘, ‘url‘)    # http://localhost:8080/print cp.get(‘ftp‘, ‘url‘)     # ftp://192.168.1.102/

 

更多 ConfigParser 的使用，參考：

• http://pymotw.com/2/ConfigParser/index.html
• https://docs.python.org/2/library/configparser.html

 

Python(2.7.6) ConfigParser - 讀寫設定檔