clevercloud_sdk/v4/addon_provider/
mod.rs

1//! # Addon provider module
2//!
3//! This module provide structures and helpers to interact with clever-cloud's
4//! addon-provider
5
6use std::{
7    collections::BTreeMap,
8    convert::TryFrom,
9    fmt::{self, Debug, Display, Formatter},
10    hash::Hash,
11    str::FromStr,
12};
13
14#[cfg(feature = "jsonschemas")]
15use schemars::JsonSchema;
16use serde::{Deserialize, Serialize};
17
18pub mod config_provider;
19pub mod elasticsearch;
20pub mod mongodb;
21pub mod mysql;
22pub mod plan;
23pub mod postgresql;
24pub mod redis;
25
26// -----------------------------------------------------------------------------
27// Feature structure
28
29#[cfg_attr(feature = "jsonschemas", derive(JsonSchema))]
30#[derive(Serialize, Deserialize, PartialEq, Eq, PartialOrd, Clone, Debug)]
31pub struct Feature {
32    #[serde(rename = "name")]
33    pub name: String,
34    #[serde(rename = "enabled")]
35    pub enabled: bool,
36}
37
38// -----------------------------------------------------------------------------
39// Cluster structure
40
41#[cfg_attr(feature = "jsonschemas", derive(JsonSchema))]
42#[derive(Serialize, Deserialize, PartialEq, Eq, Clone, Debug)]
43pub struct Cluster<T> {
44    #[serde(rename = "id")]
45    pub id: String,
46    #[serde(rename = "label")]
47    pub label: String,
48    #[serde(rename = "zone")]
49    pub zone: String,
50    #[serde(rename = "features")]
51    pub features: Vec<Feature>,
52    #[serde(rename = "version")]
53    pub version: T,
54}
55
56// -----------------------------------------------------------------------------
57// AddonProvider structure
58
59#[cfg_attr(feature = "jsonschemas", derive(JsonSchema))]
60#[derive(Serialize, Deserialize, PartialEq, Eq, Clone, Debug)]
61pub struct AddonProvider<T>
62where
63    T: Ord,
64{
65    #[serde(rename = "providerId")]
66    pub provider_id: AddonProviderId,
67    #[serde(rename = "clusters")]
68    pub clusters: Vec<Cluster<T>>,
69    #[serde(rename = "dedicated")]
70    pub dedicated: BTreeMap<T, Vec<Feature>>,
71    #[serde(rename = "defaultDedicatedVersion")]
72    pub default: T,
73}
74
75// -----------------------------------------------------------------------------
76// Error enumeration
77
78#[derive(thiserror::Error, Debug)]
79pub enum Error {
80    #[error(
81        "failed to parse addon provider identifier '{0}', available options are \
82        'postgresql-addon', 'redis-addon', 'mysql-addon', 'mongodb-addon', \
83        'addon-pulsar', 'config-provider', 'es-addon', 'kv', 'metabase' and 'keycloak'"
84    )]
85    Parse(String),
86}
87
88// -----------------------------------------------------------------------------
89// AddonProviderName structure
90
91#[cfg_attr(feature = "jsonschemas", derive(JsonSchema))]
92#[derive(Serialize, Deserialize, PartialEq, Eq, PartialOrd, Ord, Hash, Clone, Debug)]
93#[serde(untagged, try_from = "String", into = "String")]
94pub enum AddonProviderId {
95    PostgreSql,
96    Redis,
97    MySql,
98    MongoDb,
99    Pulsar,
100    KV,
101    ConfigProvider,
102    ElasticSearch,
103    Metabase,
104    Keycloak,
105}
106
107impl FromStr for AddonProviderId {
108    type Err = Error;
109
110    #[cfg_attr(feature = "tracing", tracing::instrument)]
111    fn from_str(s: &str) -> Result<Self, Self::Err> {
112        Ok(match s.to_lowercase().as_str() {
113            "postgresql-addon" => Self::PostgreSql,
114            "redis-addon" => Self::Redis,
115            "mysql-addon" => Self::MySql,
116            "mongodb-addon" => Self::MongoDb,
117            "addon-pulsar" => Self::Pulsar,
118            "kv" => Self::KV,
119            "config-provider" => Self::ConfigProvider,
120            "es-addon" => Self::ElasticSearch,
121            "metabase" => Self::Metabase,
122            "keycloack" => Self::Keycloak,
123            _ => return Err(Error::Parse(s.to_owned())),
124        })
125    }
126}
127
128impl TryFrom<String> for AddonProviderId {
129    type Error = Error;
130
131    #[cfg_attr(feature = "tracing", tracing::instrument)]
132    fn try_from(s: String) -> Result<Self, Self::Error> {
133        Self::from_str(&s)
134    }
135}
136
137#[allow(clippy::from_over_into)]
138impl Into<String> for AddonProviderId {
139    #[cfg_attr(feature = "tracing", tracing::instrument)]
140    fn into(self) -> String {
141        self.to_string()
142    }
143}
144
145impl Display for AddonProviderId {
146    fn fmt(&self, f: &mut Formatter) -> fmt::Result {
147        match self {
148            Self::PostgreSql => write!(f, "postgresql-addon"),
149            Self::Redis => write!(f, "redis-addon"),
150            Self::MySql => write!(f, "mysql-addon"),
151            Self::MongoDb => write!(f, "mongodb-addon"),
152            Self::Pulsar => write!(f, "addon-pulsar"),
153            Self::KV => write!(f, "kv"),
154            Self::ConfigProvider => write!(f, "config-provider"),
155            Self::ElasticSearch => write!(f, "es-addon"),
156            Self::Metabase => write!(f, "metabase"),
157            Self::Keycloak => write!(f, "keycloak"),
158        }
159    }
160}
clevercloud_sdk/v4/addon_provider/mod.rs

clevercloud_sdk/v4/addon_provider/
mod.rs
