我在多篇文章里面都说过,我非常喜欢使用Yaml格式来写配置文件。Yaml是一个对人非常友好的配置格式。
有时候,我们在开发环境、测试环境和线上环境会有多套不同的配置文件,如何在不修改代码的情况下方便的切换配置文件呢?我以前的文章讲过一种方法,使用环境变量来指定配置文件名。今天我们来介绍一个更先进的工具,专门用来高效加载配置文件。这就是Facebook开源的Hydra。
这个工具有多简单呢?我们先写两个配置文件,然后看看怎么读取它:
使用pip安装Hydra:
python3 -m pip install hydra-core
接下来,我们写一段代码,来读取配置文件:
import os import hydra from omegaconf import DictConfig env = os.getenv('DATA_CENTER', 'dev') @hydra.main(config_path="config", config_name=env) def main(cfg: DictConfig): print('MongoDB链接地址是:', cfg.mongo.uri) print('Redis的key是:', cfg.redis.key) print('黑名单是:', cfg.detail.black_list) if __name__ == '__main__': main()
运行效果如下图所示:
其中,装饰器hydra.main
的参数config_path
指定存放配置文件的文件夹,
config_name
用来指定配置文件的名字(去掉.yaml)。
这样一来,我们可以通过环境变量指定要使用哪个配置文件。
这样看起来似乎跟我以前讲的方法没什么区别啊。那么,高级的功能来了。例如现在我使用dev环境时,临时想修改一下Redis的Key怎么办呢?以前的方法,我就必须去修改Yaml文件,把Key改掉。但是,既然是临时修改,测试完了又要改回来,显然非常麻烦。
使用Hydra,这个问题就不再是问题了。我们来看看直接在命令中覆盖数据的方法:
请看图中,我代码没有做任何修改,Yaml也没有做任何修改。只需要在启动命令的时候增加一个参数redis.key=new_key
,那么程序读取到的就是新的值了。这对临时测试的时候非常有用。
除了我上面介绍的这些,Hydra还可以实现自动补全,自动提示参数名,自动以多个不同的配置连续运行等等功能。大家可以在它的官方文档[1]中看到使用方法。
最后,我补充一个点。有同学在公众号粉丝群提问,Hydra为什么不能在调用函数的时候,传递额外的参数,例如下面这样写就会报错:
这是因为,Hydra的装饰对象应该是程序的入口函数。给入口函数传递参数是很奇怪的。如果你的入口函数要根据参数的不同值执行不同的逻辑,那么这个参数你完全可以放到配置文件中。而不是用函数参数来传入。
所以,这里报错应该是功能而不是bug。本来就不应该在入口函数中添加额外的参数。
参考文献
[1] 官方文档: https://hydra.cc/docs/intro/
请关注微信公众号【未闻Code】获取更多精彩文章。