camel-function 0.9.0

Function runtime service for out-of-process function execution
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
133
134
135
136
137
138
139
140

use super::*;
use crate::provider::{HealthReport, ProviderError};
use camel_api::function::*;
use std::time::Duration;

pub struct ProtocolClient {
    http: reqwest::Client,
}

impl Default for ProtocolClient {
    fn default() -> Self {
        Self::new()
    }
}

impl ProtocolClient {
    pub fn new() -> Self {
        Self {
            http: reqwest::Client::builder()
                .timeout(Duration::from_secs(30))
                .build()
                .expect("reqwest client"),
        }
    }

    pub async fn health(&self, endpoint: &str) -> Result<HealthReport, ProviderError> {
        let url = format!("{}/health", endpoint);
        let resp = self
            .http
            .get(&url)
            .send()
            .await
            .map_err(|e| ProviderError::HealthFailed(format!("health request failed: {e}")))?;
        if resp.status().is_success() {
            let health: HealthResponse = resp
                .json()
                .await
                .map_err(|e| ProviderError::HealthFailed(format!("decode health response: {e}")))?;
            if health.status == "ready" {
                Ok(HealthReport::Healthy)
            } else {
                Ok(HealthReport::Unhealthy(health.status))
            }
        } else {
            Ok(HealthReport::Unhealthy(format!("status {}", resp.status())))
        }
    }

    pub async fn register(
        &self,
        endpoint: &str,
        def: &FunctionDefinition,
    ) -> Result<(), ProviderError> {
        let url = format!("{}/register", endpoint);
        let body = RegisterRequest {
            function_id: def.id.0.clone(),
            runtime: def.runtime.clone(),
            source: def.source.clone(),
            timeout_ms: def.timeout_ms,
        };
        let resp =
            self.http.post(&url).json(&body).send().await.map_err(|e| {
                ProviderError::RegisterFailed(format!("register request failed: {e}"))
            })?;
        if resp.status().is_success() {
            Ok(())
        } else {
            let err_resp: ErrorResponse = resp.json().await.map_err(|e| {
                ProviderError::RegisterFailed(format!("decode register error: {e}"))
            })?;
            Err(ProviderError::RegisterFailed(format!(
                "{}: {}",
                err_resp.kind, err_resp.error
            )))
        }
    }

    pub async fn invoke(
        &self,
        endpoint: &str,
        id: &FunctionId,
        exchange: &camel_api::Exchange,
        timeout: Duration,
    ) -> Result<InvokeResponse, ProviderError> {
        let url = format!("{}/invoke", endpoint);
        let wire = ExchangeWire {
            function_id: id.0.clone(),
            correlation_id: exchange.correlation_id.clone(),
            body: BodyWire::from_body(&exchange.input.body),
            headers: exchange.input.headers.clone(),
            properties: exchange.properties.clone(),
            timeout_ms: timeout.as_millis() as u64,
        };
        let resp = self
            .http
            .post(&url)
            .json(&wire)
            .timeout(timeout)
            .send()
            .await
            .map_err(|e| ProviderError::InvokeFailed(format!("invoke request failed: {e}")))?;
        let invoke_resp: InvokeResponse = resp
            .json()
            .await
            .map_err(|e| ProviderError::InvokeFailed(format!("decode invoke response: {e}")))?;
        Ok(invoke_resp)
    }

    pub async fn unregister(&self, endpoint: &str, id: &FunctionId) -> Result<(), ProviderError> {
        let url = format!("{}/unregister", endpoint);
        let body = serde_json::json!({ "function_id": id.0.as_str() });
        let resp = self.http.post(&url).json(&body).send().await.map_err(|e| {
            ProviderError::UnregisterFailed(format!("unregister request failed: {e}"))
        })?;
        if resp.status().is_success() {
            Ok(())
        } else {
            Err(ProviderError::UnregisterFailed(format!(
                "status {}",
                resp.status()
            )))
        }
    }

    pub async fn shutdown(&self, endpoint: &str) -> Result<(), ProviderError> {
        let url = format!("{}/shutdown", endpoint);
        let resp =
            self.http.post(&url).send().await.map_err(|e| {
                ProviderError::ShutdownFailed(format!("shutdown request failed: {e}"))
            })?;
        if resp.status().is_success() {
            Ok(())
        } else {
            Err(ProviderError::ShutdownFailed(format!(
                "status {}",
                resp.status()
            )))
        }
    }
}