Crate askama_web

Source
Expand description

GitHub Workflow Status Crates.io docs.rs

A compatibility add-on for askama to support many different web frameworks.

§Example

E.g. if you are using axum, then add askama_web with the feature "axum-0.8" to your Cargo.toml:

[dependencies]
askama_web = { version = "0.12.0", features = ["axum-0.8"] }

Then just add #[derive(WebTemplate)] to your Askama templated struct or enum:

use askama::Template;
use askama_web::WebTemplate;
use axum::Router;
use axum::routing::get;

#[derive(Template, WebTemplate)]
#[template(path = "hello.html")]
struct HelloTemplate {
    name: String,
}

async fn hello() -> HelloTemplate {
    HelloTemplate {
        name: "world".to_string(),
    }
}

let app = Router::new().route("/", get(hello));

By selecting the feature "axum-0.8", HelloTemplate will implement axum::response::IntoResponse. The user will receive a “Status: 200”, “Content-Type: text/html; charset=utf-8” response with the rendered struct as body.

§Feature flags / web framework selection

These web frameworks are currently implemented and can be selected with their respective feature flag:

As well as these logging / debugging facilities to print error messages if a template could not be rendered:

  • "eprintln": using rust’s built-in eprintln!() macro
  • "log-0.4": using log as logging framework
  • "tracing-0.1": using tracing as logging framework

Some older versions are implemented, too:

Structs§

WebTemplate
Wrap a Template that might not derive WebTemplate to be usable as web response.

Traits§

WebTemplateExt
Extension trait to let any Template be usable as a WebTemplate.

Derive Macros§

WebTemplatederive
Implement the needed traits to use your template as a web response.