google-cloud-wkt 1.3.0

Google Cloud Client Libraries for Rust - Well Known Types
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

// Copyright 2025 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

//! Implement custom serializers for `u32`.
//!
//! In ProtoJSON 32-bit integers can be serialized as either strings or numbers.

use serde::de::Unexpected::Other;

pub struct U32;

impl<'de> serde_with::DeserializeAs<'de, u32> for U32 {
    fn deserialize_as<D>(deserializer: D) -> Result<u32, D::Error>
    where
        D: serde::de::Deserializer<'de>,
    {
        deserializer.deserialize_any(U32Visitor)
    }
}

visitor_32!(
    U32Visitor,
    u32,
    "a 32-bit unsigned integer in ProtoJSON format"
);

impl serde_with::SerializeAs<u32> for U32 {
    fn serialize_as<S>(source: &u32, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: serde::Serializer,
    {
        serializer.serialize_u32(*source)
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use anyhow::Result;
    use serde_json::{Value, json};
    use serde_with::{DeserializeAs, SerializeAs};
    use test_case::test_case;

    #[test_case(0, 0)]
    #[test_case(0.0, 0; "zero as f64")]
    #[test_case("0", 0; "zero as string")]
    #[test_case("0.0", 0; "zero as f64 string")]
    #[test_case("2.0", 2)]
    #[test_case(3e5, 300_000)]
    #[test_case("5e4", 50_000)]
    #[test_case(84, 84)]
    #[test_case(168.0, 168)]
    #[test_case("21", 21)]
    #[test_case(u32::MAX, u32::MAX; "max")]
    #[test_case(u32::MAX as f64, u32::MAX; "max as f64")]
    #[test_case(format!("{}", u32::MAX), u32::MAX; "max as string")]
    #[test_case(format!("{}.0", u32::MAX), u32::MAX; "max as f64 string")]
    // Not quite a roundtrip test because we always serialize as numbers.
    fn deser_and_ser<T: serde::Serialize>(input: T, want: u32) -> Result<()> {
        let got = U32::deserialize_as(json!(input))?;
        assert_eq!(got, want);

        let serialized = U32::serialize_as(&got, serde_json::value::Serializer)?;
        assert_eq!(serialized, json!(got));
        Ok(())
    }

    #[test_case(json!(u64::MAX))]
    #[test_case(json!(u32::MAX as i64 + 2))]
    #[test_case(json!(u32::MIN as i64 - 2))]
    #[test_case(json!(format!("{}", u64::MAX)))]
    #[test_case(json!("abc"))]
    #[test_case(json!(123.4))]
    #[test_case(json!("234.5"))]
    #[test_case(json!({}))]
    fn deser_error(input: Value) {
        let got = U32::deserialize_as(input).unwrap_err();
        assert!(got.is_data(), "{got:?}");
    }
}