seuss 0.3.1

A batteries-included framework for implementing Redfish-compliant services.
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

use axum::{response::IntoResponse, Json};
use redfish_codegen::{Metadata, SCHEMA_BASE_URL};

/// Constructs an HTTP response with the Link header set to the path of the
/// json-schema document describing the Redfish model contained in the response
/// body.
pub struct Link<M>(
    /// The base URL of the json-schema document. This can be used to refer the
    /// json-schema client to a relative path on the current service, or (the
    /// default behavior with the use of [crate::Response]) relative to the
    /// public Redfish schema index.
    pub &'static str,
    /// The model instance forming the response body.
    pub M,
);

impl<M> IntoResponse for Link<M>
where
    M: Metadata<'static>,
    Json<M>: IntoResponse,
{
    fn into_response(self) -> axum::response::Response {
        (
            [(
                "Link",
                "<".to_string() + self.0 + "/" + M::JSON_SCHEMA + ">; rel=describedby",
            )],
            Json(self.1),
        )
            .into_response()
    }
}

/// Constructs an HTTP response from a Redfish model instance.
///
/// This creates a request with the following:
/// 1. The Link header is set with the URL to the json-schema of the model
///    contained in the request body.
/// 2. The Cache-Control header is set to "no-cache".
/// 3. The response body is serialized to JSON.
pub struct Response<M>(pub M);

impl<M> IntoResponse for Response<M>
where
    M: Metadata<'static>,
    Json<M>: IntoResponse,
{
    fn into_response(self) -> axum::response::Response {
        (
            [("Cache-Control", "no-cache")],
            Link(SCHEMA_BASE_URL, self.0),
        )
            .into_response()
    }
}