From d3b048544eebf7b8402fb585b4e2531de9b28a33 Mon Sep 17 00:00:00 2001 From: cel 🌸 Date: Wed, 24 Jan 2024 20:23:18 +0000 Subject: Add poem integration --- book/src/askama.md | 2 +- book/src/integrations.md | 12 ++++++++++++ 2 files changed, 13 insertions(+), 1 deletion(-) (limited to 'book') diff --git a/book/src/askama.md b/book/src/askama.md index 2eb366c..74068f0 100644 --- a/book/src/askama.md +++ b/book/src/askama.md @@ -26,7 +26,7 @@ in a for-profit context, please consider supporting my open source work on * Construct templates using a familiar, easy-to-use syntax * Benefit from the safety provided by Rust's type system * Template code is compiled into your crate for [optimal performance][benchmarks] -* Optional built-in support for Actix, Axum, Gotham, Mendes, Rocket, tide, and warp web frameworks +* Optional built-in support for Actix, Axum, Gotham, Mendes, Poem, Rocket, tide, and warp web frameworks * Debugging features to assist you in template development * Templates must be valid UTF-8 and produce UTF-8 when rendered * IDE support available in [JetBrains products](https://plugins.jetbrains.com/plugin/16591-askama-template-support) diff --git a/book/src/integrations.md b/book/src/integrations.md index 918b887..3d6d508 100644 --- a/book/src/integrations.md +++ b/book/src/integrations.md @@ -44,6 +44,18 @@ In case of a run-time error occurring during templating, the response will be of signature, with a status code of `500 Internal Server Error`, mime `*/*`, and an empty `Body`. This preserves the response chain if any custom error handling needs to occur. +## Poem integration + +Enabling the `with-poem` feature appends an implementation of Poem's +`IntoResponse` trait for each template type. This makes it easy to trivially +return a value of that type in a Poem handler. See +[the example](https://github.com/djc/askama/blob/main/askama_poem/tests/basic.rs) +from the Askama test suite for more on how to integrate. + +In case of a run-time error occurring during templating, the response will be of the same +signature, with a status code of `500 Internal Server Error`, mime `*/*`, and an empty `Body`. +This preserves the response chain if any custom error handling needs to occur. + ## Warp integration Enabling the `with-warp` feature appends an implementation of Warp's `Reply` -- cgit