feat: introduce network-group API

Author: b4D8

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "clevercloud-sdk"
-description = "A rust client and structures to interact with the Clever-Cloud API."
+description = "A Rust client and structures to interact with the Clever-Cloud API."
 version = "0.15.0"
 edition = "2024"
 rust-version = "1.85.0"
@@ -12,12 +12,26 @@ keywords = ["clevercloud", "sdk", "logging", "metrics", "jsonschemas"]
 
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
 
+[features]
+default = ["logging"]
+jsonschemas = ["dep:schemars"]
+logging = ["dep:log", "oauth10a/logging", "tracing/log-always"]
+metrics = ["oauth10a/metrics"]
+tracing = ["oauth10a/tracing", "dep:tracing"]
+network-group = ["dep:base64", "x25519-dalek", "dep:rand_core", "dep:zeroize"]
+
 [dependencies]
-chrono = { version = "^0.4.40", features = ["serde"] }
-oauth10a = { version = "^2.1.1", default-features = false, features = [
+base64 = { version = "^0.22.1", optional = true }
+chrono = { version = "^0.4.41", features = ["serde"] }
+oauth10a = { path = "../oauth10a-rust", default-features = false, features = [
     "client",
+    "serde",
+    "rest",
+    "sse",
+    "zeroize",
 ] }
-log = { version = "^0.4.26", optional = true }
+log = { version = "^0.4.27", optional = true }
+rand_core = { version = "^0.9.3", features = ["os_rng"], optional = true }
 schemars = { version = "^0.8.22", features = [
     "chrono",
     "indexmap1",
@@ -30,11 +44,12 @@ serde_repr = "^0.1.20"
 serde_json = "^1.0.140"
 thiserror = "^2.0.12"
 tracing = { version = "^0.1.41", optional = true }
-uuid = { version = "^1.16.0", features = ["serde", "v4"] }
-
-[features]
-default = ["logging"]
-jsonschemas = ["schemars"]
-logging = ["oauth10a/logging", "tracing/log-always", "log"]
-metrics = ["oauth10a/metrics"]
-tracing = ["oauth10a/tracing", "dep:tracing"]
+uuid = { version = "^1.17.0", features = ["serde", "v4"] }
+x25519-dalek = { version = "^2.0.1", features = [
+    "zeroize",
+    "static_secrets",
+], optional = true }
+zeroize = { version = "^1.8.1", features = [
+    "serde",
+    "derive",
+], optional = true }

examples/cleverctl/src/cfg.rs

@@ -4,14 +4,14 @@
 
 use std::path::PathBuf;
 
-use clevercloud_sdk::Credentials;
+use clevercloud_sdk::oauth10a::credentials::Credentials;
 use config::{Config, ConfigError, File};
 use serde::{Deserialize, Serialize};
 
 // -----------------------------------------------------------------------------
 // Error enumeration
 
-#[derive(thiserror::Error, Debug)]
+#[derive(Debug, thiserror::Error)]
 pub enum Error {
     #[error("failed to load configuration from file '{0}', {1}")]
     LoadConfiguration(String, ConfigError),
@@ -24,7 +24,7 @@ pub enum Error {
 // -----------------------------------------------------------------------------
 // Configuration structure
 
-#[derive(Serialize, Deserialize, Eq, PartialEq, Clone, Debug)]
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 pub struct Configuration {
     #[serde(rename = "credentials", flatten)]
     pub credentials: Credentials,

examples/cleverctl/src/cmd/addon/config_provider/environment.rs

@@ -16,7 +16,7 @@ use crate::{
 // -----------------------------------------------------------------------------
 // Error enumeration
 
-#[derive(thiserror::Error, Debug)]
+#[derive(Debug, thiserror::Error)]
 pub enum Error {
     #[error("failed to format output, {0}")]
     FormatOutput(Box<cmd::Error>),
@@ -37,7 +37,7 @@ pub enum Error {
 // -----------------------------------------------------------------------------
 // Environment enumeration
 
-#[derive(Subcommand, PartialEq, Eq, Clone, Debug)]
+#[derive(Debug, Clone, PartialEq, Eq, Subcommand)]
 pub enum Environment {
     #[clap(name = "get", about = "Get environment variables")]
     Get {

examples/cleverctl/src/cmd/addon/config_provider/mod.rs

@@ -16,7 +16,7 @@ pub mod environment;
 // -----------------------------------------------------------------------------
 // Error enumeration
 
-#[derive(thiserror::Error, Debug)]
+#[derive(Debug, thiserror::Error)]
 pub enum Error {
     #[error("failed to execute command on config-provider environment, {0}")]
     Environment(environment::Error),
@@ -25,7 +25,7 @@ pub enum Error {
 // -----------------------------------------------------------------------------
 // ConfigProvider structure
 
-#[derive(Subcommand, Eq, PartialEq, Clone, Debug)]
+#[derive(Debug, Clone, PartialEq, Eq, Subcommand)]
 pub enum ConfigProvider {
     #[clap(name = "environment", aliases = &["env"], subcommand, about = "Interact with config-provider environment")]
     Environment(Environment),

examples/cleverctl/src/cmd/addon/mod.rs

@@ -16,7 +16,7 @@ pub mod config_provider;
 // -----------------------------------------------------------------------------
 // Error enumeration
 
-#[derive(thiserror::Error, Debug)]
+#[derive(Debug, thiserror::Error)]
 pub enum Error {
     #[error("failed to format output, {0}")]
     FormatOutput(Box<cmd::Error>),
@@ -33,7 +33,7 @@ pub enum Error {
 // -----------------------------------------------------------------------------
 // Addon enumeration
 
-#[derive(Subcommand, Eq, PartialEq, Clone, Debug)]
+#[derive(Debug, Clone, PartialEq, Eq, Subcommand)]
 pub enum Command {
     #[clap(name = "list", about = "List addons of an organisation")]
     List {

examples/cleverctl/src/cmd/functions/deployments.rs

@@ -5,7 +5,6 @@
 
 use std::{collections::BTreeMap, path::PathBuf, sync::Arc};
 
-use clap::Subcommand;
 use clevercloud_sdk::{
     Client,
     oauth10a::reqwest,
@@ -22,7 +21,7 @@ use crate::{
 // ----------------------------------------------------------------------------
 // Error
 
-#[derive(thiserror::Error, Debug)]
+#[derive(Debug, thiserror::Error)]
 pub enum Error {
     #[error("failed to format output, {0}")]
     FormatOutput(Box<cmd::Error>),
@@ -49,7 +48,7 @@ pub enum Error {
 // ----------------------------------------------------------------------------
 // Command
 
-#[derive(Subcommand, PartialEq, Eq, Clone, Debug)]
+#[derive(Debug, Clone, PartialEq, Eq, clap::Subcommand)]
 pub enum Command {
     #[clap(name = "list", aliases = &["l"], about = "List functions information of an organisation")]
     List {

examples/cleverctl/src/cmd/functions/mod.rs

@@ -3,7 +3,6 @@
 //! This module provides command implementation related to functions product
 use std::{collections::BTreeMap, sync::Arc};
 
-use clap::Subcommand;
 use clevercloud_sdk::{Client, oauth10a::reqwest, v4::functions};
 use tracing::info;
 
@@ -23,7 +22,7 @@ pub const DEFAULT_MAX_MEMORY: u64 = 64 * 1024 * 1024;
 // -----------------------------------------------------------------------------
 // Error enumeration
 
-#[derive(thiserror::Error, Debug)]
+#[derive(Debug, thiserror::Error)]
 pub enum Error {
     #[error("failed to format output, {0}")]
     FormatOutput(Box<cmd::Error>),
@@ -57,7 +56,7 @@ pub enum Error {
 // Command
 
 /// Command enum contains all operations that could be achieved on the user
-#[derive(Subcommand, Eq, PartialEq, Clone, Debug)]
+#[derive(Debug, Clone, PartialEq, Eq, clap::Subcommand)]
 pub enum Command {
     #[clap(name = "list", aliases = &["l"], about = "List functions information of an organisation")]
     List {

examples/cleverctl/src/cmd/mod.rs

@@ -25,7 +25,7 @@ pub mod zone;
 // -----------------------------------------------------------------------------
 // Error enumeration
 
-#[derive(thiserror::Error, Debug)]
+#[derive(Debug, thiserror::Error)]
 pub enum Error {
     #[error("failed to parse output '{0}', available options are 'json' or 'yaml'")]
     ParseOutput(String),
@@ -46,7 +46,7 @@ pub enum Error {
 // -----------------------------------------------------------------------------
 // Output enumeration
 
-#[derive(PartialEq, Eq, PartialOrd, Ord, Hash, Clone, Debug, Default)]
+#[derive(Debug, Default, Clone, PartialEq, Eq, Hash, PartialOrd, Ord)]
 pub enum Output {
     #[default]
     Json,
@@ -103,7 +103,7 @@ pub trait Executor {
 // Command enumeration
 
 /// Command enum contains all operations that the command line could handle
-#[derive(Subcommand, Eq, PartialEq, Clone, Debug)]
+#[derive(Debug, Clone, PartialEq, Eq, Subcommand)]
 pub enum Command {
     #[clap(name = "self", aliases = &["sel", "se", "s"], subcommand, about = "Interact with the current user")]
     Myself(myself::Command),
@@ -133,7 +133,7 @@ impl Executor for Command {
 
 /// Args structure contains all commands and global flags that the command line
 /// supports
-#[derive(Parser, Eq, PartialEq, Clone, Debug)]
+#[derive(Debug, Clone, PartialEq, Eq, Parser)]
 #[clap(author, version, about)]
 pub struct Args {
     /// Specify a configuration file

examples/cleverctl/src/cmd/myself.rs

@@ -14,7 +14,7 @@ use crate::{
 // -----------------------------------------------------------------------------
 // Error enumeration
 
-#[derive(thiserror::Error, Debug)]
+#[derive(Debug, thiserror::Error)]
 pub enum Error {
     #[error("failed to format output, {0}")]
     FormatOutput(Box<cmd::Error>),
@@ -28,7 +28,7 @@ pub enum Error {
 // Command enumeration
 
 /// Command enum contains all operations that could be achieved on the user
-#[derive(Subcommand, Eq, PartialEq, Clone, Debug)]
+#[derive(Debug, Clone, PartialEq, Eq, Subcommand)]
 pub enum Command {
     #[clap(name = "get", aliases = &["ge", "g"], about = "Get information about the current user")]
     Get {

examples/cleverctl/src/cmd/zone.rs

@@ -3,7 +3,6 @@
 //! This module provides command implementation related to the zone API
 use std::sync::Arc;
 
-use clap::Subcommand;
 use clevercloud_sdk::{Client, oauth10a::reqwest, v4::products::zones};
 
 use crate::{
@@ -14,7 +13,7 @@ use crate::{
 // -----------------------------------------------------------------------------
 // Error enumeration
 
-#[derive(thiserror::Error, Debug)]
+#[derive(Debug, thiserror::Error)]
 pub enum Error {
     #[error("failed to format output, {0}")]
     FormatOutput(Box<cmd::Error>),
@@ -28,7 +27,7 @@ pub enum Error {
 // Command enumeration
 
 /// Command enum contains all operations that could be achieved on the zone API
-#[derive(Subcommand, Eq, PartialEq, Clone, Debug)]
+#[derive(Debug, Clone, PartialEq, Eq, clap::Subcommand)]
 pub enum Command {
     #[clap(name = "list", aliases = &["l"], about = "List available zones")]
     List {
@@ -66,7 +65,7 @@ impl Executor for Command {
 // helpers
 
 pub async fn list(config: Arc<Configuration>, output: &Output) -> Result<(), Error> {
-    let client = Client::from(config.credentials.to_owned());
+    let client = Client::from(&config.credentials);
     let zones = zones::list(&client).await.map_err(Error::List)?;
 
     println!(