google_maps 3.9.5

An unofficial Google Maps Platform client library for the Rust programming language.
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

//! Serialization helpers for `Option<Weekday>`

use serde::{Deserialize, Deserializer, Serializer};
use serde::de::Error;
use jiff::civil::Weekday;

/// Serializes a `jiff::Weekday` to Google's day numbering system (0=Sunday, 6=Saturday).
/// 
/// Converts from jiff's ISO-8601 numbering (1=Monday, 7=Sunday) to Google's numbering system
/// (0=Sunday, 6=Saturday).
/// 
/// Used with `#[serde(serialize_with = "serialize_weekday")]`
#[allow(clippy::trivially_copy_pass_by_ref)]
pub fn serialize_weekday<S>(weekday: &Weekday, serializer: S) -> Result<S::Ok, S::Error>
where
    S: Serializer
{
    let google_day = weekday_to_google_day(weekday);
    serializer.serialize_i32(google_day)
}

/// Deserializes Google's day numbering to a `jiff::Weekday`.
/// 
/// Converts from Google's numbering system (0=Sunday, 6=Saturday) to jiff's ISO-8601 `Weekday`
/// enum.
/// 
/// Used with `#[serde(deserialize_with = "deserialize_weekday")]`
pub fn deserialize_weekday<'de, D>(deserializer: D) -> Result<Weekday, D::Error>
where
    D: Deserializer<'de>
{
    let google_day = i32::deserialize(deserializer)?;
    
    google_day_to_weekday(google_day)
        .map_or_else(
            || Err(D::Error::custom(format!(
                "Unrecognized weekday {google_day:#?}: expected 0-6 (0=Sunday, 6=Saturday)",
            ))),
            Ok

        )
}

// -------------------------------------------------------------------------------------------------
//
// Private Functions

const fn google_day_to_weekday(google_day: i32) -> Option<Weekday> {
    match google_day {
        0 => Some(Weekday::Sunday),
        1 => Some(Weekday::Monday),
        2 => Some(Weekday::Tuesday),
        3 => Some(Weekday::Wednesday),
        4 => Some(Weekday::Thursday),
        5 => Some(Weekday::Friday),
        6 => Some(Weekday::Saturday),
        _ => None,
    }
}

#[allow(clippy::trivially_copy_pass_by_ref, reason = "for serde")]
const fn weekday_to_google_day(weekday: &Weekday) -> i32 {
    match weekday {
        Weekday::Sunday => 0,
        Weekday::Monday => 1,
        Weekday::Tuesday => 2,
        Weekday::Wednesday => 3,
        Weekday::Thursday => 4,
        Weekday::Friday => 5,
        Weekday::Saturday => 6,
    }
}

// -------------------------------------------------------------------------------------------------
//
// Tests

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_weekday_conversion() {
        // Test Google -> jiff conversion
        assert_eq!(google_day_to_weekday(0), Some(Weekday::Sunday));
        assert_eq!(google_day_to_weekday(1), Some(Weekday::Monday));
        assert_eq!(google_day_to_weekday(6), Some(Weekday::Saturday));
        assert_eq!(google_day_to_weekday(7), None); // Invalid

        // Test jiff -> Google conversion
        assert_eq!(weekday_to_google_day(&Weekday::Sunday), 0);
        assert_eq!(weekday_to_google_day(&Weekday::Monday), 1);
        assert_eq!(weekday_to_google_day(&Weekday::Saturday), 6);
    }
}