econf 0.1.4

定义选项

首先，导入econf

from econf import *

对于属于“默认”部分的默认选项：

from econf import BaseConf

class DefaultConf(BaseConf):
    host = StrOpt(default='0.0.0.0', cmdline=True,
                  help='ip address')
    port = IntOpt(default=9090, cmdline=True,
                  help='tcp port')

对于属于其他部分的选项：

class ZKConf(BaseConf):
    __section__ = 'zk'

    hosts = StrOpt(
        required=True,
        help='list of zookeeper ip:port pair. i.e. localhost:2181')
    max_retry = IntOpt(
        default=3,
        help='number of tries before giving up connecting')

在代码中使用选项

有两种方法可以引用选项。 首先，使用特定的Conf类：

host, port = DefaultConf.host, DefaultConf.port

其次，使用常规配置：

host, port = CONF.host, CONF.port
zk_hosts = CONF.zk.hosts

解析cli选项和配置文件

如果提供了默认配置：

from econf import CONF
CONF('path/to/your/default.conf')

或者，

from econf import CONF
CONF()

通常，这段代码是在服务启动之前执行的

def run():
    from econf import CONF
    CONF()

    my_service.init(CONF.host, CONF.port, ...)
    my_service.start()