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.

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

Usage

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

```rust use std::error::Error;

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

[tokio::main]

async fn main() -> Result<(), Box> { let client = Client::from(Credentials { token: "".tostring(), secret: "".tostring(), consumerkey: "".tostring(), consumersecret: "".tostring(), });

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 | | -------------------------------- | --------------------------------------------------------------- | ------- | -------------------------- | | oauth10aclientrequest | endpoint: String, method: String, status: Integer | Counter | number of request on api | | oauth10aclientrequest_duration | endpoint: String, method: String, status: Integer, unit: String | Counter | duration of request on api |

License

See the license.

Getting in touch