civo-rs

Unofficial rust client for the civo api

Why ?

Because Civo's go client wasn't fast enough( Joking obviously ) 😅. This is purely for educational purposes as i am trying to get better at rust ,this also means that a large part of this code is bad and more expreienced rust devs would be disgusted by it. See something that isn't right? Open a PR as i mentioned earlier i am doing this to improve and would appreciate any feedback and or help i can get.

Fun fact: this originally started out as a client to interact with Civo objectstores.

project goals

Right now there aren't many i would like to mimic as much civo's go client as possible, however i am focused on some of the core functionalities right now

• [x] managing ssh keys
• [x] creating compute instances
• [x] creating kubernetes clusters
• [x] managing object stores
• [ ] support for civo databases

How do i use this thing

```toml [package] name = "epik project" version = "0.1.0" edition = "2021"

See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

[dependencies] tokio = { version = "1", features = ["full"] } # for our async runtime serde = { version = "1.0", features = ["derive"] } serde_json = "1.0"
```

for more advanced use cases checkout the rust docs here ```rust use civors::{client::newcivoclient, instance}; use civors::kubernetes::{SimpleClusterConfig}; use civors::utils::randomname;

async fn main() -> Result<(), Box> { let apikey = String::from("SOME-REALLY-REAL-API-KEY"); let region = String::from("LON1"); let newcc = newcivoclient(apikey, region); let skc = SimpleClusterConfig { name: randomname(), region: "LON1".tostring(), networkid: "f89250e9-da9a-401b-blah-blah-blah".tostring(), pools: vec![KubernetesPoolConfig { id: randomname(), count: 1, size: "g4s.kube.medium".tostring(), }], firewallrule: "443".tostring(), }; let cluster = newcc.newsimplekubernetes_cluster(skc).await; println!("{:?}", cluster); Ok(()) } ```

```rust use civors::{client::newcivo_client,};

async fn main() -> Result<(), Box> { let apikey = String::from("SOME-REALLY-REAL-API-KEY"); let region = String::from("LON1"); let newcc = newcivoclient(apikey, region); let defaultnetwork = newcc.getdefaultnetwork().await.unwrap(); match defaultnetwork { Ok(network) => println!("Default network: {}", network.Name), Err(error) => println!("Error: {}", error.message), }

let mut config  =  new_cc.new_instance_config().await.unwrap();
config.hostname = "civo-rs".to_string();

let instance  =  new_cc.create_instance(config).await;
match instance {
    Ok(instance) => println!("{:?}",serde_json::to_string(&instance)),
    Err(error) => println!("Error: {}",&error),
}
println!("{}",serde_json::to_string(&config).unwrap());
let deleted_instance = new_cc.delete_instance("efd7c5ca-516a-494d-b8ac-8eabbc215fef");
println!("{}",deleted_instance.await.unwrap().result);
Ok(())

} ```

If by any chance you find this useful consider leaving a star or buy me a coffee