hrobot 6.1.0

Unofficial Hetzner Robot API client
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
90
91
92
93
94
95

mod common;

use hrobot::{
    api::boot::{Cpanel, CpanelConfig, CpanelDistribution},
    AsyncRobot,
};
use serial_test::file_serial;
use tracing::info;
use tracing_test::traced_test;

#[tokio::test]
#[traced_test]
#[file_serial]
async fn get_cpanel_configuration() {
    let _ = dotenvy::dotenv().ok();

    let robot = AsyncRobot::default();

    let server = common::provisioned_server().await;
    // Fetch the complete server object, so we can get check
    // if the CPanel system is available for this server.
    let Some(availability) = robot.get_server(server.id).await.unwrap().availability else {
        return;
    };

    if availability.cpanel {
        let config = robot.get_cpanel_config(server.id).await.unwrap();
        info!("{config:#?}");
    }
}

#[tokio::test]
#[traced_test]
#[file_serial]
async fn last_cpanel_config() {
    let _ = dotenvy::dotenv().ok();

    let robot = crate::AsyncRobot::default();

    let server = common::provisioned_server().await;

    let Some(availability) = server.availability else {
        return;
    };

    if availability.cpanel {
        let last_config = robot.get_last_cpanel_config(server.id).await.unwrap();
        info!("{last_config:#?}");
    }
}

#[tokio::test]
#[traced_test]
#[file_serial]
#[ignore = "enabling the Cpanel installation system is expensive, even if the system is never activated."]
async fn enable_disable_cpanel() {
    let _ = dotenvy::dotenv().ok();

    let robot = crate::AsyncRobot::default();

    let server_id = common::provisioned_server_id().await;

    let mut activated_config = robot
        .enable_cpanel_config(
            server_id,
            CpanelConfig {
                distribution: CpanelDistribution::from("CentOS Stream"),
                language: "en_US".to_string(),
                hostname: "cpanel.example.com".to_string(),
            },
        )
        .await
        .unwrap();

    let config = robot.get_cpanel_config(server_id).await.unwrap();
    info!("{config:#?}");

    assert_eq!(Cpanel::Active(activated_config.clone()), config);

    let _ = robot.disable_cpanel_config(server_id).await.unwrap();

    assert!(matches!(
        robot.get_cpanel_config(server_id).await.unwrap(),
        Cpanel::Available(_)
    ));

    // We null out the password so we can compare to the latest
    // config, since the latest does not include passwords.
    activated_config.password = None;

    assert_eq!(
        robot.get_last_cpanel_config(server_id).await.unwrap(),
        activated_config
    );
}