Struct Patch

一个帮助您修补Rust实例的库，并且可以轻松地部分更新配置。

简介

此crate提供了Patch trait和相应的derive宏。

在struct上派生Patch将生成一个类似于原始结构体的结构体，但所有字段都被包裹在Option中。
此类补丁结构体的一个实例可以应用于原始结构体，只有在设置为Some时才替换值，否则保持不变。

快速示例

use struct_patch::Patch;
use serde::{Deserialize, Serialize};

#[derive(Default, Debug, PartialEq, Patch)]
#[patch(attribute(derive(Debug, Default, Deserialize, Serialize)))]
struct Item {
    field_bool: bool,
    field_int: usize,
    field_string: String,
}

fn patch_json() {
    let mut item = Item {
        field_bool: true,
        field_int: 42,
        field_string: String::from("hello"),
    };

    let data = r#"{
        "field_int": 7
    }"#;

    let patch: ItemPatch = serde_json::from_str(data).unwrap();

    item.apply(patch);
    // You can do 
    // `let new_item = item << patch;`

    // For multiple patches,
    // you can do this
    // `let new_item = item << patch_1 << patch_2;`
    // or make an aggregated one, but please make sure the patch fields do not conflict, else will panic
    // ```
    // let overall_patch = patch_1 + patch_2 + patch_3;
    // let new_item = item << overall_patch;
    // ```

    assert_eq!(
        item,
        Item {
            field_bool: true,
            field_int: 7,
            field_string: String::from("hello")
        }
    );
}

文档和示例

此外，您还可以通过在原始结构体或字段上定义#[patch(...)]属性来修改补丁结构体。