fly-sdk 0.1.3

Unofficial Fly.io SDK for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

//! # Unofficial Fly SDK
//!
//! The Fly SDK provides an interface for interacting with the Fly.io Machines API.
//! It allows you to manage applications, machines, volumes, and secrets on Fly.io.
//! The SDK is designed to simplify the usage of the Fly.io API with convenient methods for common tasks.
//!
//! ## Example
//!
//! ```rust
//! use fly_sdk::FlyControl;
//!
//! let api_token = "your_api_token".to_string();
//! let fly_control = FlyControl::new(api_token);
//!
//! // Now you can use fly_control to manage apps, machines, secrets, and volumes
//! ```
//!
//! The `FlyControl` struct is the main entry point for interacting with the Fly.io API.
//! It encapsulates managers for applications, machines, volumes, and secrets, allowing
//! you to manage these entities using a single unified interface.
//!
//! # Fields
//! - `apps`: Manages Fly.io applications.
//! - `machines`: Manages Fly.io machines.
//! - `volumes`: Manages Fly.io volumes.
//! - `secrets`: Manages Fly.io secrets.
//!
//! # Example usage
//! - `fly_control.apps.create_app(...);`
//! - `fly_control.machines.list_machines(...);`
//! - `fly_control.volumes.create_volume(...);`
//! - `fly_control.secrets.set_secret(...);`
//!
//! # Features
//! This crate supports the following features:
//! - `apps`: Enable app management.
//! - `machines`: Enable machine management.
//! - `volumes`: Enable volume management.
//! - `secrets`: Enable secret management.
//! - `full`: Enable all features.

#[cfg(feature = "apps")]
pub mod apps;

#[cfg(feature = "machines")]
pub mod machines;

#[cfg(feature = "secrets")]
pub mod secrets;

#[cfg(feature = "volumes")]
pub mod volumes;

use reqwest::Client;

const API_BASE_URL: &str = "https://api.machines.dev/v1";

pub struct FlyControl {
    #[cfg(feature = "apps")]
    pub apps: apps::AppManager,

    #[cfg(feature = "machines")]
    pub machines: machines::MachineManager,

    #[cfg(feature = "volumes")]
    pub volumes: volumes::VolumeManager,

    #[cfg(feature = "secrets")]
    pub secrets: secrets::SecretsManager,
}

impl FlyControl {
    pub fn new(api_token: String) -> Self {
        let client = Client::new();
        FlyControl {
            #[cfg(feature = "apps")]
            apps: apps::AppManager::new(client.clone(), api_token.clone()),

            #[cfg(feature = "machines")]
            machines: machines::MachineManager::new(client.clone(), api_token.clone()),

            #[cfg(feature = "volumes")]
            volumes: volumes::VolumeManager::new(client.clone(), api_token.clone()),

            #[cfg(feature = "secrets")]
            secrets: secrets::SecretsManager::new(client.clone(), api_token.clone()),
        }
    }
}