mdbook-plotly 0.1.7-alpha

An mdbook preprocessor that renders plot code blocks (e.g., ```plot) into interactive or static charts during book build.
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

/// Used to send critical errors.
/// Will exit directly with exit code `1`.
///
/// NOTE: This macro is only useful after Rust version `1.79`.
#[macro_export]
macro_rules! fatal {
    ($($arg:tt)*) => {{
        // This line only compiles smoothly after version `1.79`.
        // Compiling with older versions may result in temporary value errors.
        //
        // If you need some information, here it is:
        // Issue: [#92698](https://github.com/rust-lang/rust/issues/92698)
        // Tracing issues with RFC66: [#15023](https://github.com/rust-lang/rust/issues/15023)
        // The std doc about `Arguments`: [`std::fmt::Arguments`](https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html)
        let msg = format_args!($($arg)*);

        log::error!("Critical error: {}", msg);
        #[cfg(debug_assertions)]
        {
            log::debug!("Backtrace: {:?}", std::backtrace::Backtrace::capture());
        }
        std::process::exit(1);
    }};
}

/// Used to translate `serde_json::Value` into DataPack<T>.
/// This macro avoids writing a lot of duplicate code.
#[macro_export]
macro_rules! translate {
    ($target:expr, $value:expr, $map:expr, $(($method:ident, $ty:ty)),* $(,)?) => {{
        use $crate::preprocessor::handlers::code_handler::until::DataPack;
        let target = $target;
        $(
            let target = if let Some(v) = $value.get_mut(stringify!($method)) {
                let data = serde_json::from_value::<DataPack<$ty>>(v.take())?;
                target.$method(data.unwrap($map)?)
            } else {
                target
            };
        )*
        Ok::<_, serde_json::Error>(target)
    }};
}