gracile-core 0.1.0

Core engine for the Gracile templating language — lexer, parser, AST, and renderer
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

![gracile-core](gracile-core.png)

# gracile-core

The engine at the heart of Gracile. Contains the lexer, parser, AST, and renderer. Use this crate directly if you want to embed the engine into your own library or framework without the re-export layer.

```toml
[dependencies]
gracile-core = "0.1"
```

```rust
use gracile_core::{Engine, Value, FilterFn};
use std::collections::HashMap;

let engine = Engine::new()
    .with_strict()
    .with_template_loader(|name| {
        std::fs::read_to_string(format!("templates/{}", name))
            .map_err(|e| gracile_core::Error::RenderError {
                message: e.to_string(),
            })
    })
    .register_filter("shout", |val, _args| {
        match val {
            Value::String(s) => Ok(Value::String(format!("{}!!!", s.to_uppercase()))),
            other => Ok(other),
        }
    });

let mut ctx = HashMap::new();
ctx.insert("title".into(), Value::from("hello world"));

let output = engine.render("{title | shout}", ctx)?;
// → "HELLO WORLD!!!"
```

Most users should depend on the [`gracile`](../gracile) crate instead, which re-exports this crate's public API under a cleaner name.