mdbook-plotly 0.3.0-alpha

A 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

pub mod color;
pub(crate) mod eval;
pub(crate) mod map;
pub mod parse_context;
pub mod plot_obj_parser;
pub mod until;

use crate::preprocessor::config::{MapEvalConfig, PlotlyInputType};
use anyhow::Result;
use plotly::Plot;
use serde_json::Value;

pub fn handle(
    raw_code: String,
    input_type: &PlotlyInputType,
    map_eval: &MapEvalConfig,
) -> Result<Plot> {
    let result = match input_type {
        PlotlyInputType::JSONInput => handle_json_input(raw_code, map_eval)?,
        PlotlyInputType::TOMLInput => handle_toml_input(raw_code, map_eval)?,
    };
    Ok(result)
}

/// `Plot` does not implement `Deserialize`, so this routine is only an
/// unofficial best-effort translation.
///
/// Do not be surprised if the output of `Plot::serialize` cannot be
/// round-tripped through this function.
///
/// In addition, fields that cannot be translated are silently dropped.
pub fn handle_json_input(raw_code: String, map_eval: &MapEvalConfig) -> Result<Plot> {
    // Use Json5 to provide more flexible JSON.
    let mut value: Value = json5::from_str(&raw_code)?;
    plot_obj_parser::parse(&mut value, map_eval)
}

pub fn handle_toml_input(raw_code: String, map_eval: &MapEvalConfig) -> Result<Plot> {
    let toml_value: toml::Value = toml::from_str(&raw_code)?;
    let mut value = serde_json::to_value(toml_value)?;
    plot_obj_parser::parse(&mut value, map_eval)
}