Pythonで設定ファイルを扱う場合はConfigParserモジュールを使うと便利です。今回はConfigParserの使い方について紹介します。
設定ファイルの構成
ConfigParserで読み込み可能な設定ファイルのフォーマットは以下のような形になります。
|
1 2 3 4 5 6 7 |
[セクション1] オプション1 = 値1 オプション2 = 値2 [セクション2] オプション3 = 値3 オプション4 = 値4 |
設定ファイルは直接ファイルに記述することもできますが、ConfigParserモジュールを使うことで簡単にフォーマットした設定ファイルを作成することができます。
設定ファイルを作成する
セクションを追加するときはadd_section()メソッドを使います。引数はセクション名を表す文字列です。次にセクションの中へ、オプションと値の組を追加していきます。set() メソッドを使って、セクション名、オプション名、値をそれぞれ渡します。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
import ConfigParser config = ConfigParser.ConfigParser() section1 = 'development' config.add_section(section1) config.set(section1, 'host', 'localhost') config.set(section1, 'port', 10001) section2 = 'production' config.add_section(section2) config.set(section2, 'host', 'xxx.co.jp') config.set(section2, 'port', 10002) with open('setting.ini', 'w') as file: config.write(file) |
設定ファイルへ書き込むときはwrite()メソッドにファイルオブジェクトを渡します。
上のプログラムを実行すると、以下のような設定ファイル（setting.ini）が作成されます。
|
1 2 3 4 5 6 7 8 |
$ cat setting.ini [development] host = localhost port = 10001 [production] host = xxx.co.jp port = 10002 |
設定ファイルを読み込む
read()メソッドの引数にファイル名を渡すことで、設定ファイルを読み込むことができます。オプションの値は get()で取得することができます。以下は、先ほど作成した「setting.ini」ファイルを読み込む例です。
|
1 2 3 4 5 6 7 8 9 10 11 12 |
import ConfigParser config = ConfigParser.ConfigParser() config.read('setting.ini') section1 = 'development' print config.get(section1, 'host') # localhost print config.get(section1, 'port') # 10001 section2 = 'production' print config.get(section2, 'host') # xxx.co.jp print config.get(section2, 'port') # 10002 |
また、セクションが定義されているかどうか確認するためにはhas_section()メソッドを使います。
|
1 2 |
print config.has_section('production') # True print config.has_section('staging') # false |
セクション内にオプションが定義されているかどうか確認するためにはhas_option()メソッドを使います。
|
1 2 |
print config.has_option('production', 'host') # true print config.has_option('production', 'user') # false |
options() メソッド を使うと、セクション内のオプション一覧をリストとして取得できます。また、items() はオプションと値のペアをリストで返します。
|
1 2 |
print config.options('development') # ['host', 'port'] print config.items('development') # [('host', 'localhost'), ('port', '10001')] |
