redfish 0.3.2

Production-grade Rust SDK for DMTF Redfish (async-first, optional blocking).
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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132

#![cfg(feature = "_async")]

use std::time::Duration;

use http::StatusCode;
use redfish::{Auth, Client, RetryPolicy};
use wiremock::matchers::{method, path};
use wiremock::{Mock, MockServer, ResponseTemplate};

#[tokio::test]
async fn service_root_get_works() {
    let server = MockServer::start().await;

    Mock::given(method("GET"))
        .and(path("/redfish/v1"))
        .respond_with(ResponseTemplate::new(200).set_body_raw(
            r#"{"RedfishVersion":"1.9.0","UUID":"test"}"#,
            "application/json",
        ))
        .mount(&server)
        .await;

    let client = Client::builder(&server.uri())
        .unwrap()
        .auth(Auth::none())
        .build()
        .unwrap();

    let root = client.service_root().get().await.unwrap();
    assert_eq!(root.redfish_version, "1.9.0");
    assert_eq!(root.uuid.as_deref(), Some("test"));
}

#[tokio::test]
async fn retries_on_503_for_idempotent_methods() {
    let server = MockServer::start().await;

    // First call -> 503, second call -> 200
    Mock::given(method("GET"))
        .and(path("/redfish/v1/Systems"))
        .respond_with(ResponseTemplate::new(503))
        .up_to_n_times(1)
        .expect(1)
        .mount(&server)
        .await;

    Mock::given(method("GET"))
        .and(path("/redfish/v1/Systems"))
        .respond_with(ResponseTemplate::new(200).set_body_raw(
            r#"{"Members":[{"@odata.id":"/redfish/v1/Systems/1"}],"Members@odata.count":1}"#,
            "application/json",
        ))
        .expect(1)
        .mount(&server)
        .await;

    let retry = RetryPolicy::default()
        .with_max_retries(2)
        .with_base_delay(Duration::from_millis(1))
        .with_max_delay(Duration::from_millis(1))
        .with_jitter(false);

    let client = Client::builder(&server.uri())
        .unwrap()
        .retry_policy(retry)
        .build()
        .unwrap();

    let systems = client.systems().list().await.unwrap();
    assert_eq!(systems.members.len(), 1);
}

#[tokio::test]
async fn does_not_retry_on_500() {
    let server = MockServer::start().await;

    Mock::given(method("GET"))
        .and(path("/redfish/v1/Systems"))
        .respond_with(ResponseTemplate::new(500))
        .expect(1)
        .mount(&server)
        .await;

    let retry = RetryPolicy::default()
        .with_max_retries(2)
        .with_base_delay(Duration::from_millis(1))
        .with_max_delay(Duration::from_millis(1))
        .with_jitter(false);

    let client = Client::builder(&server.uri())
        .unwrap()
        .retry_policy(retry)
        .build()
        .unwrap();

    let err = client
        .systems()
        .list()
        .await
        .expect_err("expected 500 error");
    assert_eq!(err.status(), Some(StatusCode::INTERNAL_SERVER_ERROR));

    let requests = server.received_requests().await.expect("request history");
    assert_eq!(requests.len(), 1);
}

#[tokio::test]
async fn session_create_parses_token_and_location() {
    let server = MockServer::start().await;

    Mock::given(method("POST"))
        .and(path("/redfish/v1/SessionService/Sessions"))
        .respond_with(
            ResponseTemplate::new(StatusCode::CREATED.as_u16())
                .insert_header("X-Auth-Token", "abc123")
                .insert_header("Location", "/redfish/v1/SessionService/Sessions/1")
                .set_body_raw(
                    r#"{"Id":"1","Name":"Session","UserName":"admin"}"#,
                    "application/json",
                ),
        )
        .mount(&server)
        .await;

    let client = Client::builder(&server.uri()).unwrap().build().unwrap();
    let login = client.sessions().create("admin", "pw").await.unwrap();

    // We cannot (and should not) expose the raw secret here; but we can use it to build auth.
    let _auth = redfish::Auth::SessionToken(login.token.clone());
    assert_eq!(login.location, "/redfish/v1/SessionService/Sessions/1");
    assert_eq!(login.session.unwrap().id.as_deref(), Some("1"));
}