genkit 0.3.1

A common generator kit for static site generator.
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

use anyhow::Result;
use minijinja::Environment;
use rayon::{
    iter::{IntoParallelRefMutIterator, ParallelIterator},
    prelude::IntoParallelRefIterator,
};
use std::path::Path;

mod markdown;

use crate::context::Context;

pub use markdown::MarkdownConfig;

/// A trait represents the entity of config file.
///
/// An entity contains two stage:
/// - **parse**, the stage the entity to parse its attribute, such as parse markdown to html.
/// - **render**, the stage to render the entity to html file.
///
/// [`Entity`] has default empty implementations for both methods.
#[allow(unused_variables)]
pub trait Entity {
    fn parse(&mut self, source: &Path) -> Result<()> {
        Ok(())
    }

    fn render(&self, env: &Environment, context: Context, dest: &Path) -> Result<()> {
        Ok(())
    }
}

impl<T: Entity> Entity for Option<T> {
    fn parse(&mut self, source: &Path) -> Result<()> {
        if let Some(entity) = self {
            entity.parse(source)?;
        }
        Ok(())
    }

    fn render(&self, env: &Environment, context: Context, dest: &Path) -> Result<()> {
        if let Some(entity) = self {
            entity.render(env, context, dest)?;
        }
        Ok(())
    }
}

impl<T: Entity + Sync + Send + Clone + 'static> Entity for Vec<T> {
    fn parse(&mut self, source: &Path) -> Result<()> {
        self.par_iter_mut()
            .try_for_each(|entity| entity.parse(source))
    }

    fn render(&self, env: &Environment, context: Context, dest: &Path) -> Result<()> {
        self.par_iter().try_for_each(|entity| {
            let context = context.clone();
            entity.render(env, context, dest)
        })
    }
}