rok-core 0.6.0

Core primitives for the rok ecosystem — errors, crypto, i18n, config, DI, and more
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

/// Dump value(s) to stderr and halt by returning an error HTTP response.
///
/// Requires `debug` + `axum` features on `rok-core`.
#[macro_export]
macro_rules! rok_dd {
    ($($val:expr),* $(,)?) => {{
        eprintln!("┌─────────────────────────────────────────────────────────────");
        eprintln!("│ {}:{}  rok_dd!", file!(), line!());
        eprintln!("├─────────────────────────────────────────────────────────────");
        $(
            eprintln!("│ {:?}", $val);
        )*
        eprintln!("└─────────────────────────────────────────────────────────────");
        return $crate::debug::__rok_dd_response(file!(), line!());
    }};
}

/// Dump value(s) to stderr without halting execution.
#[macro_export]
macro_rules! rok_dump {
    ($($val:expr),* $(,)?) => {{
        eprintln!("┌─────────────────────────────────────────────────────────────");
        eprintln!("│ {}:{}  rok_dump!", file!(), line!());
        eprintln!("├─────────────────────────────────────────────────────────────");
        $(
            eprintln!("│ {:?}", $val);
        )*
        eprintln!("└─────────────────────────────────────────────────────────────");
    }};
}

#[doc(hidden)]
#[cfg(feature = "axum")]
pub fn __rok_dd_response(file: &str, line: u32) -> axum::response::Response {
    use axum::response::IntoResponse;
    (
        axum::http::StatusCode::INTERNAL_SERVER_ERROR,
        axum::Json(serde_json::json!({
            "error": "E_DEBUG_DUMP",
            "message": "Request halted by rok_dd!()",
            "file": file,
            "line": line,
        })),
    )
        .into_response()
}

#[cfg(test)]
mod tests {
    #[test]
    fn rok_dump_compiles() {
        let x = 42;
        rok_dump!(x, "hello");
    }
}

#[cfg(all(test, feature = "axum"))]
mod axum_tests {
    use axum::response::Response;

    /// Verify `rok_dd!` type-checks in an async fn returning `Response`.
    #[allow(dead_code)]
    async fn handler() -> Response {
        rok_dd!("test");
    }
}