earthmc 2.0.1

Async client for interacting with the EarthMC API
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

use serde::{Deserialize, Serialize};
use uuid::Uuid;

use crate::model::{
    color::RgbaColor,
    location::PositionXYZ,
    named_uuid::{NamedUuid, NamedUuidOpt},
    timestamp::Timestamp,
};

#[derive(Clone, Deserialize, Serialize, PartialEq, Debug)]
#[serde(rename_all = "camelCase")]
pub struct Quarter {
    pub name: String,
    pub uuid: Uuid,
    #[serde(rename = "type")]
    pub kind: QuarterKind,
    pub creator: Uuid,
    pub owner: NamedUuidOpt,
    pub town: NamedUuid,
    pub timestamps: QuarterTimestamps,
    pub status: QuarterStatus,
    pub stats: QuarterStats,
    pub colour: RgbaColor,
    pub trusted: Vec<NamedUuid>,
    pub cuboids: Vec<QuarterCuboid>,
}

#[derive(Clone, Deserialize, Serialize, PartialEq, Debug)]
#[serde(rename_all = "SCREAMING_SNAKE_CASE")]
pub enum QuarterKind {
    /// The default kind of Quarter.
    Apartment,
    /// Allows bed usage.
    Inn,
    /// Allows vehicle placing and usage.
    Station,
}

#[derive(Clone, Deserialize, Serialize, PartialEq, Debug)]
#[serde(rename_all = "camelCase")]
pub struct QuarterTimestamps {
    #[cfg_attr(
        feature = "chrono",
        serde(with = "crate::model::timestamp::seconds")
    )]
    pub registered: Timestamp,
    #[cfg_attr(
        feature = "chrono",
        serde(with = "crate::model::timestamp::optional_seconds")
    )]
    pub claimed_at: Option<Timestamp>,
}

#[derive(Clone, Deserialize, Serialize, PartialEq, Debug)]
#[serde(rename_all = "camelCase")]
pub struct QuarterStatus {
    pub is_embassy: bool,
    pub is_for_sale: bool,
}

#[derive(Clone, Deserialize, Serialize, PartialEq, Debug)]
#[serde(rename_all = "camelCase")]
pub struct QuarterStats {
    pub price: Option<i32>,
    pub volume: i32,
    pub num_cuboids: u16,
    pub particle_size: Option<f32>,
}

#[derive(Clone, Deserialize, Serialize, PartialEq, Debug)]
#[serde(rename_all = "camelCase")]
pub struct QuarterCuboid {
    pub corner_one: PositionXYZ,
    pub corner_two: PositionXYZ,
}

#[cfg(test)]
mod tests {
    use serde_json::json;

    use crate::{
        endpoints::quarters::QuarterCuboid, model::location::PositionXYZ,
    };

    #[test]
    fn deserializes_cuboid_corners_from_coordinate_arrays() {
        let cuboid: QuarterCuboid = serde_json::from_value(json!({
            "cornerOne": [1, 2, 3],
            "cornerTwo": [4, 5, 6]
        }))
        .unwrap();

        assert_eq!(
            cuboid,
            QuarterCuboid {
                corner_one: PositionXYZ { x: 1, y: 2, z: 3 },
                corner_two: PositionXYZ { x: 4, y: 5, z: 6 },
            }
        );
    }

    #[test]
    fn serializes_cuboid_corners_as_coordinate_arrays() {
        let cuboid = QuarterCuboid {
            corner_one: PositionXYZ { x: 1, y: 2, z: 3 },
            corner_two: PositionXYZ { x: 4, y: 5, z: 6 },
        };

        assert_eq!(
            serde_json::to_value(cuboid).unwrap(),
            json!({
                "cornerOne": [1, 2, 3],
                "cornerTwo": [4, 5, 6]
            })
        );
    }
}