curlyconf

Curlyconf

Curlyconf 是用于命名.conf 和 dhcpd.conf 等配置文件格式的配置文件读取器。

示例配置（file.cfg）

person charlie {
	fullname "Charlie Brown";
	address 192.168.1.1;
}
person snoopy {
	fullname "Snoopy";
}

示例代码

use serde::Deserialize;

// The initial section of any config is a rust struct.
#[derive(Debug, Deserialize)]
struct Config {
    person: Vec<Person>,
}

#[derive(Debug, Deserialize)]
struct Person {
    #[serde(rename = "__label__")]
    name: String,
    #[serde(default)]
    fullname: Option<String>,
    #[serde(default)]
    address: Option<std::net::IpAddr>,
}

fn main() {
    // Read the configuration file.
    let config: Config = match curlyconf::from_file("file.cfg") {
        Ok(cfg) => cfg,
        Err(e) => {
            eprintln!("{}", e);
            std::process::exit(1);
        }
    };

    // Print what we got (println!("{:?}", config) would be easier...).
    for (i, p) in config.person.iter().enumerate() {
        println!("{}: {} fullname {:?} addr {:?}", i, p.name, p.fullname, p.address);
    }
}

这将打印

0: charlie fullname Some("Charlie Brown") addr Some(V4(192.168.1.1))
1: snoopy fullname Some("Snoopy") addr None

Curlyconf 使用 serde 将配置文件值反序列化为 Rust 类型，就像几乎每个做类似事情的 crate 一样。

部分和值。

配置文件包含部分名称、标签、部分、值名称和值

• 部分。它们具有部分名称、可选标签，并包含其他部分和值的列表。部分的 Rust 类型是结构。
• 值。这是一个值名称，后跟一个值。如果值是 Vec，则可以有多种值，用逗号分隔。

如果部分是以下情况之一，则它可以有标签：

• 它是 HashMap<Key, Section> 的一部分，或
• 它是 Vec<Section> 的一部分，并且与该部分对应的 Rust 结构体具有 __label__ 字段。该字段将设置为标签值。

section_name [label] {
    value_name value [,value...];
    value_name value [,value...];
    section_name [label] {
        value_name value [,value...];
    }
}

#[derive(Debug, Deserialize)]
struct Config {
    animal: Animal,
}

#[derive(Debug, Deserialize)]
enum Animal {
    Cat {
         purrs: bool,
    },
    Dog {
         barks: bool,
    },
}

animal cat {
    purrs;
}

include otherconfig.cfg;

configs {
    include conf.d/*.cfg;
}