wheel-rs 1.5.0

A Rust utility library providing file operations, time utilities and Duration serialization support.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

//! # 自定义序列化/反序列化器，用于处理 `Vec<T>` 类型的数据
//!
//! 此模块提供了一系列函数来处理向量类型的序列化和反序列化，
//! 支持将字符串或字符串数组转换为向量，以及将向量序列化为适当的 JSON 格式。

use serde::{
    de::{self, Deserializer, SeqAccess, Visitor},
    ser::{SerializeSeq, Serializer},
};
use std::fmt;

/// # 将 `Vec<String>` 序列化为 JSON 数组
///
/// ## 支持的格式
/// - `vec![]` -> `[]`
/// - `vec!["string"]` -> `["string"]`
/// - `vec!["string1", "string2"]` -> `["string1", "string2"]`
///
/// ## 示例
/// ```rust
/// use serde::Serialize;
/// #[derive(Serialize)]
/// struct Example {
/// #[serde(serialize_with = "crate::serde::vec_serde::serialize")]
/// tags: Vec<String>,
/// }
/// ```
pub fn serialize<S>(vec: &Vec<String>, serializer: S) -> Result<S::Ok, S::Error>
where
    S: Serializer,
{
    let mut seq = serializer.serialize_seq(Some(vec.len()))?;
    for element in vec {
        seq.serialize_element(element)?;
    }
    seq.end()
}

/// # 将 JSON 数据反序列化为 `Vec<String>` 类型
///
/// ## 支持的格式
/// - `"string"` -> `vec!["string"]`
/// - `["string1", "string2"]` -> `vec!["string1", "string2"]`
/// - `null` -> `vec![]`
///
/// ## 示例
/// ```rust
/// use serde::{Serialize, Deserialize};
/// use serde_json;
/// 
/// #[derive(Serialize, Deserialize)]
/// struct Example {
///     #[serde(
///         serialize_with = "crate::serde::vec_serde::serialize",
///         deserialize_with = "crate::serde::vec_serde::deserialize"
///     )]
///     tags: Vec<String>,
/// }
/// 
/// let json = r#'{"tags": ["tag1", "tag2"]}'#;
/// let example: Example = serde_json::from_str(json).unwrap();
/// assert_eq!(example.tags, vec!["tag1", "tag2"]);
/// ```
pub fn deserialize<'de, D>(deserializer: D) -> Result<Vec<String>, D::Error>
where
    D: Deserializer<'de>,
{
    deserializer.deserialize_any(StringOrVecVisitor)
}

/// # 用于处理字符串或字符串数组的访问器
struct StringOrVecVisitor;

impl<'de> Visitor<'de> for StringOrVecVisitor {
    type Value = Vec<String>;

    fn expecting(&self, formatter: &mut fmt::Formatter) -> fmt::Result {
        formatter.write_str("a string, comma-separated string, or array of strings")
    }

    /// # 处理字符串引用（&str）类型
    fn visit_str<E>(self, value: &str) -> Result<Self::Value, E>
    where
        E: de::Error,
    {
        self.visit_string(value.to_string())
    }

    /// # 处理字符串（String）类型
    fn visit_string<E>(self, value: String) -> Result<Self::Value, E>
    where
        E: de::Error,
    {
        // 将字符串通过逗号分割转换为 vec
        Ok(value
            .split(',')
            .map(|s| s.trim().to_string())
            .filter(|s| !s.is_empty())
            .collect())
    }

    /// # 处理序列（数组）类型
    fn visit_seq<A>(self, mut seq: A) -> Result<Self::Value, A::Error>
    where
        A: SeqAccess<'de>,
    {
        let mut vec = Vec::new();
        // 逐个读取序列中的元素
        while let Some(element) = seq.next_element::<String>()? {
            let element = element.trim().to_string();
            if element.is_empty() {
                continue;
            }
            vec.push(element);
        }
        Ok(vec)
    }
}