#regex #deserialize #serde #utilities #flattening #derive-debug

serde_flat_regex

在 serde 反序列化期间用于展平正则表达式匹配键的宏

3 个版本

0.1.2 2023 年 2 月 16 日
0.1.1 2023 年 2 月 11 日
0.1.0 2022 年 8 月 22 日

#1729编码

MIT 许可证

15KB
204

serde_flat_regex

一个小型宏,用于展平具有正则表达式匹配键的 map 类型。

示例

#[flat_regex]
#[derive(Debug, Deserialize)]
struct RouterStatus {
    id: u32,
    wifi_status: bool,
    #[flat_regex(regex = r"lanportstatus_\d+")]
    lanports: std::collections::HashMap<String, String>,
}


#[test]
fn json_test() {
    let raw = r#"{
        "id": 1,
        "wifi_status": true,
        "lanportstatus_0": "UP",
        "lanportstatus_1": "UP",
        "lanportstatus_2": "DOWN",
        "lanportspeed": "100"
    }"#;

    let router_status: RouterStatus = serde_json::from_str(raw).unwrap();

    assert_eq!(router_status.lanports.len(),3)
}

键可以是实现 AsRef<str> 的任何东西,或者可以设置字段属性 key_access,该属性是一个返回 Result<&str,_> 的函数。

该函数必须具有以下签名: fn key_access_fn_name<T>(key: &T) -> Result<&str,Error> 其中 Error 可以是任何错误类型。

use std::collections::BTreeMap;
use std::str::Utf8Error;
use std::ffi::CString;
use serde_flat_regex::flat_regex;
use serde::Deserialize;

#[flat_regex]
#[derive(Debug,Deserialize)]   
struct RouterStatus {
    online: bool,
    #[flat_regex(regex = r"lanportstatus_\d+",key_access = "c_string_as_str")]
    lanport_status: BTreeMap<CString,bool>,
}

fn c_string_as_str(key: &CString) -> Result<&str,Utf8Error> {
    key.to_str()
}

let json = serde_json::json!({
    "online": true,
    "lanportstatus_0": true,
    "lanportspeed_0": "100", // no maching keys will be ignored
    "lanportstatus_1": false,
    "lanport_speed_1": "0", // no maching keys will be ignored
    "wifistatus": true
});

let res: RouterStatus = serde_json::from_value(json).unwrap();
assert_eq!(res.lanport_status.len(),2)

适用集合

用于展平的集合必须是一个 serde-map 类型 并实现 Extend<(K,V)> + Default

依赖项

~3.5–5MB
~96K SLoC