texform-transform 0.1.0

Profile-based AST transform engine for TeXForm (internal; use the texform crate)
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

//! Compiled transform execution context.

use crate::ast::Ast;
use crate::config::{BuildConfig, TransformConfig};
use crate::engine;
use crate::error::{TransformBuildError, TransformError};
use crate::parse::ParseContext;
use crate::report::TransformReport;
use crate::rewrite;

pub struct TransformContext {
    default_config: TransformConfig,
    rewrite: rewrite::Plan,
}

impl TransformContext {
    pub fn from_build_config(
        config: BuildConfig,
        parse_ctx: &ParseContext,
    ) -> Result<Self, TransformBuildError> {
        let default_config = config.default_transform();
        let rewrite =
            rewrite::Plan::build(&config, parse_ctx).map_err(TransformBuildError::Rewrite)?;
        Ok(Self {
            default_config,
            rewrite,
        })
    }

    pub fn run(
        &self,
        ast: &mut Ast,
        parse_ctx: &ParseContext,
    ) -> Result<TransformReport, TransformError> {
        self.run_with(ast, parse_ctx, &self.default_config)
    }

    pub fn run_with(
        &self,
        ast: &mut Ast,
        parse_ctx: &ParseContext,
        config: &TransformConfig,
    ) -> Result<TransformReport, TransformError> {
        engine::execute(self, ast, parse_ctx, config)
    }

    pub fn default_config(&self) -> &TransformConfig {
        &self.default_config
    }

    pub fn rewrite_plan(&self) -> &rewrite::Plan {
        &self.rewrite
    }

    #[cfg(test)]
    pub(crate) fn from_rewrite_plan_for_tests(
        default_config: TransformConfig,
        rewrite: rewrite::Plan,
    ) -> Self {
        Self {
            default_config,
            rewrite,
        }
    }
}