Contra

Contra是Rust的配置文件加载器。

序列化/反序列化在很大程度上“受启发”（如果不是明目张胆地复制）自serde crate。特别感谢Josh Mcguigan及其非常有帮助的文章Understanding-serde。

特性

• 加载和保存字面量
  • 字符串字面量
  • 数值字面量
  • 枚举字面量
• 加载和保存结构体
  • 原始结构体
  • 嵌套结构体
• 加载集合
  • 向量
  • 映射
• 支持多种文件格式
  • JSON
  • TOML
  • Cfg

用法

Contra添加了 derive 宏：Serialize，它为给定的结构体实现了 serialize 方法。Contra添加了 derive 宏：Deserialize，它为给定的结构体实现了 deserialize 方法。这些函数最好通过 Persistent trait 来使用，该trait自动为所有既是Serializable又是Deserializable的结构体实现。The Persistent trait 提供了 load 和 save 函数，这些函数根据提供的 path 参数选择合适的序列化器/反序列化器。

示例

#[derive(Serialize, Deserialize, Default)]
pub struct Player {
    name: String,
    health: i32,
    dmg: f32,
    items: Vec<Item>,
}

#[derive(Deserialize, Deserialize)]
pub struct Item {
    name: String,
    slot: u32,
    stats: Vec<f32>,
}

fn main() {
    let saved_player = Player::default();
    player1::save("Player1.json").expect("failed to save player");

    let loaded_player = Player::load("Player1.json").expect("failed to load player");
}