apimock-server 6.2.0

HTTP(S) server runtime for apimock: listener loop, request handling, response building.
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

use hyper::HeaderMap;

use std::path::{Path, PathBuf};

use crate::{
    response::{self, error_response::internal_server_error_response, file_response::FileResponse},
    types::BoxBody,
};

pub struct MiddlewareResponse {
    pub file_path: String,
    pub request_headers: HeaderMap,
    /// The middleware script's own directory, already canonicalised —
    /// see `MiddlewareHandler::confine_to`.
    pub confine_to: Option<PathBuf>,
    /// RFC 067 — see `response_handler::default_response_headers`.
    pub cors_allow_credentials_origins: Vec<String>,
}

impl MiddlewareResponse {
    pub fn new(
        file_path: &str,
        request_headers: &HeaderMap,
        confine_to: Option<&Path>,
        cors_allow_credentials_origins: &[String],
    ) -> Self {
        MiddlewareResponse {
            file_path: file_path.to_owned(),
            request_headers: request_headers.to_owned(),
            confine_to: confine_to.map(Path::to_path_buf),
            cors_allow_credentials_origins: cors_allow_credentials_origins.to_vec(),
        }
    }

    /// file content response specified in rhai script
    pub async fn file_response(
        &self,
        rhai_response_file_path: &str,
    ) -> Option<Result<hyper::Response<BoxBody>, hyper::http::Error>> {
        let file_path = if Path::new(rhai_response_file_path).is_absolute() {
            rhai_response_file_path.to_owned()
        } else {
            let middleware_dir_path = Path::new(self.file_path.as_str()).parent();

            let joined_file_path = match middleware_dir_path {
                Some(x) => x.join(rhai_response_file_path),
                None => {
                    log::error!(
                        "failed to get middleware parent dir: {}",
                        self.file_path.as_str(),
                    );
                    return Some(internal_server_error_response(
                        "failed to resolve middleware response file",
                        &self.request_headers,
                        &self.cors_allow_credentials_origins,
                    ));
                }
            };

            match joined_file_path.to_str() {
                Some(x) => x.to_owned(),
                None => {
                    log::error!(
                        "middleware response file path is invalid: {}/{}",
                        self.file_path.as_str(),
                        rhai_response_file_path
                    );
                    return Some(internal_server_error_response(
                        "middleware response file path is invalid",
                        &self.request_headers,
                        &self.cors_allow_credentials_origins,
                    ));
                }
            }
        };

        Some(
            FileResponse::new(
                file_path.as_str(),
                None,
                &self.request_headers,
                self.confine_to.as_deref(),
                &self.cors_allow_credentials_origins,
            )
            .file_content_response()
            .await,
        )
    }

    /// json response created by rhai script
    pub fn json_response(
        &self,
        json_str: &str,
    ) -> Option<Result<hyper::Response<BoxBody>, hyper::http::Error>> {
        Some(response::json_response::json_response(
            json_str,
            None,
            None,
            &self.request_headers,
            Some(self.file_path.as_str()),
            &self.cors_allow_credentials_origins,
        ))
    }

    /// text response created by rhai script
    pub fn text_response(
        &self,
        s: &str,
    ) -> Option<Result<hyper::Response<BoxBody>, hyper::http::Error>> {
        Some(response::text_response::text_response(
            s,
            None,
            None,
            &self.request_headers,
            &self.cors_allow_credentials_origins,
        ))
    }
}