clevercloud-sdk

Crates.ioclevercloud-sdk
lib.rsclevercloud-sdk
version0.11.1
sourcesrc
created_at2021-10-12 16:49:04.122164
updated_at2023-07-31 16:40:36.481826
descriptionA rust client and structures to interact with the Clever-Cloud API.
homepage
repositoryhttps://github.com/CleverCloud/clevercloud-sdk-rust
max_upload_size
id464058
size89,763
Florentin DUBOIS (FlorentinDUBOIS)

documentation

README

Clever-Cloud Software Development Kit - Rust edition

crates.io Released API docs Continuous integration

This crate provides structures and a client to interact with the Clever-Cloud API.

Status

This crate is under development, you can use it, but it may have bugs or unimplemented features.

Installation

To install this dependency, just add the following line to your Cargo.toml manifest.

clevercloud-sdk = { version = "^0.11.1", features = ["metrics", "jsonschemas"] }

Usage

Below, you will find an example of executing a request to get information about myself.

use std::error::Error;

use clevercloud_sdk::{Client, v2::myself::{self, Myself}};

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error + Send + Sync>> {
    let client = Client::from(Credentials {
        token: "".to_string(),
        secret: "".to_string(),
        consumer_key: "".to_string(),
        consumer_secret: "".to_string(),
    });

    let _myself: Myself = myself::get(&client).await?;

    Ok(())
}

You could found more examples of how you could use the clevercloud-sdk by looking at the command line example.

Features

name description
trace Use tracing crate to expose traces
tokio Use tokio crate as back-end for tracing crate
jsonschemas Use schemars to add a derive instruction to generate json schemas representation of structures
logging Use the log facility crate to print logs. Implies oauth10a/logging feature
metrics Expose HTTP metrics through oauth10a crate feature.

Metrics

Below, the exposed metrics gathered by prometheus:

name labels kind description
oauth10a_client_request endpoint: String, method: String, status: Integer Counter number of request on api
oauth10a_client_request_duration endpoint: String, method: String, status: Integer, unit: String Counter duration of request on api

License

See the license.

Getting in touch

Commit count: 167

cargo fmt