◾️はじめに

今回は、Rustテンプレートエンジンの「Askama」について扱う

【０】Rustテンプレートエンジン一覧

[1] Askama << 今回のテーマ
[2] Tera
[3] Maud
[4] Handlebars-rust

Tera
https://keats.github.io/tera/
https://github.com/Keats/tera

【１】Askama

* Rust のテンプレート

https://github.com/askama-rs/askama
https://askama.readthedocs.io/en/stable/

１）特徴：型安全

* コンパイル時にチェックを行う
 => テンプレの変数名間違えた場合、コンパイルエラーで把握できる

【２】インストール

* Cargo.tomlに追加する
 => 「cargo add askama」でもいい

Cargo.toml

[dependencies]
askama = "0.14.0"

【３】Hello world

* 以下の公式の「How to get started」をやってみる

https://github.com/askama-rs/askama?tab=readme-ov-file#how-to-get-started

１）フォルダ構成

hello_world ... Rustプロジェクト(任意の名前でOK)
    ├─src
    │  └─ main.rs ... メイン関数
    ├─Cargo.toml ... 「【２】インストール」参照
    └─templates ... 自分で用意しておく
      └─ hello.html ... 自分で用意

２）コード

hello.html

Hello, {{ name }}!

main.rs

use askama::Template;

#[derive(Template)]
#[template(path = "hello.html")] // Templateを指定
struct HelloTemplate<'a> { 
    name: &'a str,
}

fn main() {
    let hello = HelloTemplate { name: "world" };
    println!("{}", hello.render().unwrap()); // Hello, world!
}

３）補足：変数名をわざと間違えてみる

fn main() {
    let hello = HelloTemplate { xxx: "world" }; // 変数名を間違える
    println!("{}", hello.render().unwrap());
}

ビルドエラー例

$ cargo build
... 略
error[E0560]: struct `HelloTemplate<'_>` has no field named `xxx`
  --> src/main.rs:11:33
   |
11 |     let hello = HelloTemplate { xxx: "world" };
   |                                 ^^^ `HelloTemplate<'_>` does not have this field
   |
   = note: available fields are: `name`

For more information about this error, try `rustc --explain E0560`.
error: could not compile `hello_world ` (bin "hello_world") due to 1 previous error