squarecloud 0.1.0

Async Rust client for the SquareCloud 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
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161

use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};

use crate::{http::ApiClient, resources::DatabaseResource};

/// A single historical resource-usage sample for a database.
///
/// Returned as part of a [`Vec`] by
/// [`DatabaseResource::metrics`](crate::resources::DatabaseResource::metrics).
#[derive(Debug, Serialize, Deserialize)]
pub struct DatabaseMetrics {
    /// The UTC timestamp this sample covers.
    pub date: DateTime<Utc>,
    /// CPU usage as a percentage at this point in time.
    pub cpu: f32,
    /// RAM usage as a percentage at this point in time.
    pub ram: f32,
    /// Network byte counts as `[bytes_in, bytes_out]`.
    pub net: [u32; 2],
}

/// The type of managed database engine to provision.
#[derive(Debug, Serialize, Deserialize)]
#[serde(rename_all = "lowercase")]
pub enum DatabaseType {
    /// Redis in-memory data store.
    Redis,
    /// PostgreSQL relational database.
    Postgres,
    /// MongoDB document database.
    Mongo,
}

/// Static metadata for a SquareCloud managed database.
///
/// Returned by
/// [`DatabaseResource::info`](crate::resources::DatabaseResource::info).
/// To obtain a [`DatabaseResource`] handle from an existing value, use
/// [`ApiClient::database`](crate::ApiClient::database) with the `id` field.
#[derive(Debug, Serialize, Deserialize)]
pub struct DatabaseInfo {
    /// The database's unique identifier.
    pub id: String,
    /// The user-defined name of the database.
    pub name: String,
    /// The owner account's unique identifier.
    pub owner: String,
    /// The data-centre cluster the database is hosted on.
    pub cluster: String,
    /// RAM allocation in megabytes.
    pub ram: u32,
    /// The database engine type (e.g. `"mongodb"`, `"postgresql"`).
    #[serde(rename = "type")]
    pub db_type: String,
    /// The network port the database listens on.
    pub port: u32,
    /// The UTC timestamp when the database was created.
    pub created_at: DateTime<Utc>,
}

/// Condensed database metadata as returned inside the `me` response.
#[derive(Debug, Serialize, Deserialize)]
pub struct DatabaseSummary {
    /// The database's unique identifier.
    pub id: String,
    /// The user-defined name of the database.
    pub name: String,
    /// RAM allocation in megabytes.
    pub ram: u32,
    /// The database engine type (e.g. `"mongodb"`, `"redis"`).
    #[serde(rename = "type")]
    pub db_type: String,
    /// The data-centre cluster the database is hosted on.
    pub cluster: String,
    /// The UTC timestamp when the database was created.
    pub created_at: DateTime<Utc>,
}

/// Full details for a provisioned database.
///
/// Returned by
/// [`ApiClient::create_database`](crate::ApiClient::create_database). To
/// obtain a [`DatabaseResource`] handle from this value, call
/// [`into_resource`](Database::into_resource).
#[derive(Debug, Serialize, Deserialize)]
pub struct Database {
    /// The database's unique identifier.
    pub id: String,
    /// The human-readable name given at creation time.
    pub name: String,
    /// RAM allocation in megabytes.
    pub memory: u32,
    /// CPU allocation in abstract units.
    pub cpu: u8,
    /// The database engine type (e.g. `"redis"`, `"postgres"`).
    #[serde(rename = "type")]
    pub db_type: String,
    /// The current database password.
    pub password: String,
    /// The PEM-encoded TLS client certificate.
    pub certificate: String,
    /// The full connection URL including credentials.
    pub connection_url: String,
}

/// Selects which credential to regenerate when calling
/// [`DatabaseResource::redefine_credential`](crate::resources::DatabaseResource::redefine_credential).
pub enum CredentialType {
    /// Regenerate the TLS client certificate.
    Certificate,
    /// Generate a new password.
    Password,
}

impl CredentialType {
    /// Returns the wire string for this credential type (`"certificate"` or `"password"`).
    pub fn as_str(&self) -> &str {
        match self {
            CredentialType::Certificate => "certificate",
            CredentialType::Password => "password",
        }
    }
}

/// A resolved credential value.
pub struct Credential {
    /// The type of credential that was rotated.
    pub credential_type: CredentialType,
    /// The new credential value (password string or PEM certificate).
    pub value: String,
}

impl Database {
    /// Converts this value into a [`DatabaseResource`] handle bound to `api`.
    pub fn into_resource(&self, api: ApiClient) -> DatabaseResource {
        DatabaseResource::new(api, &self.id)
    }
}

#[cfg(test)]
mod tests {
    use super::Database;
    use crate::http::ApiClient;

    #[test]
    fn into_resource_binds_correct_id() {
        unsafe { std::env::set_var("API_TOKEN", "test") };
        let db = Database {
            id: "db-abc".to_string(),
            name: "test".to_string(),
            memory: 512,
            cpu: 1,
            db_type: "postgres".to_string(),
            password: "pass".to_string(),
            certificate: "cert".to_string(),
            connection_url: "postgres://localhost/test".to_string(),
        };
        let resource = db.into_resource(ApiClient::new());
        assert_eq!(resource.id, "db-abc");
    }
}