Converge

使用少量代码构建的分层配置系统。通过仅合并配置，配置源的灵活性和合并方式都由用户控制。

简介

用户期望应用程序具有分层配置，包括命令行参数、环境和配置文件。这个库允许以最小的努力和代码将这些源分层。

动机

Unix哲学和微服务思想都导致编写大量应用程序。合理地预期这些应用程序将从命令行参数、环境以及通常的配置文件中获取配置。随着应用程序的成熟，配置选项的数量往往会增加。管理这些配置的简单方法是重复且易出错，而向其中添加测试则会增加重复。

关于

这个库让用户可以自由决定配置文件格式、命令行解析方法，并且具有最小依赖。它支持作为字段存储配置项的结构。这些结构必须实现一个具有单个方法的特质，这对于大多数结构通常是可派生的。

此方法与不可变数据结构一起工作，代码量非常少，但代价是在分层过程中克隆配置。这是一个合理的折衷方案，因为这种情况通常只在应用程序的生命周期中发生一次。

快速入门

它基于一个特质 Converge，该特质包含一个名为 converge 的方法，该方法位于 converge 包中。

pub trait Converge<Rhs = Self> {
    fn converge(self, default: Rhs) -> Self;
}

此特质可以通过 converge_derive 派生，如下所示。

#[derive(Converge)]
pub struct Config {
    pub config_file: Option<String>,
    pub loglevel: Option<i8>,
    pub xunit_local_globs: Option<Vec<String>>,
    pub environment_sk: Option<String>,
    pub environment_keys: Option<Vec<String>>,
    pub project_sk: Option<String>,
    pub project_identifier: Option<String>,
    pub project_human_name: Option<String>,
    pub run_identifier: Option<String>,
    pub run_sk: Option<String>,
    pub service_url: Option<String>,
}

可以填充这些结构的结构可以嵌套，然后可以将其耦合在一起以派生具有清晰简单预见性的新实例。

let config_commandline : Config = parse_commandline_to_config();
let config_file : Config = parse_file_to_config();
let config_env : Config = parse_env_to_config();
let cfg = config_commandline.converge(config_file).converge(config_env);

可以存在T类型字段，这些字段不是可选值，但这并不常见，因为在这种情况下 converge 只会取左侧值。

设计您的配置结构

实现 Converge 特质的结构应该包含一个逻辑分组字段，以表示您可能希望作为分层配置一部分使用的每个设置。

示例：推导嵌套 Converge 结构

#[derive(Converge)]
pub struct ConfigRabbitMqCredentials {
    pub username: Option<String>,
    pub password: Option<String>,
}

#[derive(Converge)]
pub struct ConfigRabbitMQ {
    pub host: Option<String>,
    pub port: Option<i32>,
    #[converge(nest)]
    pub credentials: Option<ConfigRabbitMqCredentials>,
}

当使用也实现 Converge 的 Fields 类型时，可以使用 #[converge(nest)] 属性来标记字段也支持 Converge，这样就可以通过 converge 在此结构上使用 converge。

使用自定义字段收敛策略进行推导

#[derive(Converge)]
pub struct ConfigRabbitMqCredentials {
    pub username: Option<String>,
    pub password: Option<String>,
}

#[derive(Converge)]
pub struct ConfigRabbitMQ {
    pub host: Option<String>,
    pub port: Option<i32>,
    #[converge(strategy = converge::strategies::vec::replace_empty)]
    pub credentials: Vec<ConfigRabbitMqCredentials>,
}

字段也可以使用自定义策略来标记自定义收敛。其中策略是函数的路径，其形式为

fn custom_function<T>(lhs: T, rhs: T) -> T

其中 T 匹配字段的类型。converge 包包含一些按容器类型排序的通用泛型策略。

如何集成数据源

这个库预计将与其他库结合使用，以解析配置文件格式、命令行和执行环境变量。在实践中，这些库所呈现的结果结构通常与输入源紧密相关。《Converge trait》要求每个源提供公共数据结构。通过为您常用的数据格式实现 From 特性 或其他 TryFrom 特性，可以将 Converge 应用到这些数据源。

相关库

我们推荐的一些数据源库列表（非详尽）。

• 解析应用程序命令行
  • clap
  • StructOpt
• 解析配置文件
  • toml
  • serde_yaml
  • serde_json
  • serde_xml_rs
• 解析环境变量
  • envy
  • envconfig

替代方案

可能的替代方案列表（非详尽）。

• merge
  • 与 converge 类似的思想。
• twelf
  • Rust 的配置解决方案，包括 12-Factor 支持。