soth-mitm 0.2.1

Rust intercepting proxy crate with deterministic handler/event contracts for SOTH.
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

use std::future::Future;
use std::panic::resume_unwind;
use std::sync::Arc;
use std::time::Duration;

use crate::metrics::ProxyMetricsStore;

#[derive(Debug)]
pub(crate) struct HandlerCallbackGuard {
    request_timeout: Duration,
    response_timeout: Duration,
    recover_from_panics: bool,
    metrics_store: Arc<ProxyMetricsStore>,
}

impl HandlerCallbackGuard {
    pub(crate) fn new(
        request_timeout: Duration,
        response_timeout: Duration,
        recover_from_panics: bool,
        metrics_store: Arc<ProxyMetricsStore>,
    ) -> Self {
        Self {
            request_timeout,
            response_timeout,
            recover_from_panics,
            metrics_store,
        }
    }

    pub(crate) async fn run_sync<R, F>(&self, default_value: R, callback: F) -> R
    where
        R: Send + 'static,
        F: FnOnce() -> R + Send + 'static,
    {
        self.run_sync_with_timeout(self.request_timeout, default_value, callback)
            .await
    }

    async fn run_sync_with_timeout<R, F>(
        &self,
        timeout: Duration,
        default_value: R,
        callback: F,
    ) -> R
    where
        R: Send + 'static,
        F: FnOnce() -> R + Send + 'static,
    {
        let mut task = tokio::task::spawn_blocking(callback);
        match tokio::time::timeout(timeout, &mut task).await {
            Ok(Ok(value)) => value,
            Ok(Err(join_error)) if join_error.is_panic() => {
                self.metrics_store.record_handler_panic();
                if self.recover_from_panics {
                    default_value
                } else {
                    resume_unwind(join_error.into_panic());
                }
            }
            Ok(Err(_join_error)) => default_value,
            Err(_) => {
                task.abort();
                let _ = task.await;
                self.metrics_store.record_handler_timeout();
                default_value
            }
        }
    }

    pub(crate) async fn run_request<R, Fut>(&self, default_value: R, future: Fut) -> R
    where
        R: Send + 'static,
        Fut: Future<Output = R> + Send + 'static,
    {
        self.run_async_with_timeout(self.request_timeout, default_value, future)
            .await
    }

    pub(crate) async fn run_response<R, Fut>(&self, default_value: R, future: Fut) -> R
    where
        R: Send + 'static,
        Fut: Future<Output = R> + Send + 'static,
    {
        self.run_async_with_timeout(self.response_timeout, default_value, future)
            .await
    }

    async fn run_async_with_timeout<R, Fut>(
        &self,
        timeout: Duration,
        default_value: R,
        future: Fut,
    ) -> R
    where
        R: Send + 'static,
        Fut: Future<Output = R> + Send + 'static,
    {
        let mut task = tokio::spawn(future);
        match tokio::time::timeout(timeout, &mut task).await {
            Ok(Ok(value)) => value,
            Ok(Err(join_error)) if join_error.is_panic() => {
                self.metrics_store.record_handler_panic();
                if self.recover_from_panics {
                    default_value
                } else {
                    resume_unwind(join_error.into_panic());
                }
            }
            Ok(Err(_join_error)) => default_value,
            Err(_) => {
                task.abort();
                let _ = task.await;
                self.metrics_store.record_handler_timeout();
                default_value
            }
        }
    }
}