Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rinja-rs/askama
Type-safe, compiled Jinja-like templates for Rust
https://github.com/rinja-rs/askama
custom-derive jinja2 rust rust-library templating
Last synced: about 24 hours ago
JSON representation
Type-safe, compiled Jinja-like templates for Rust
- Host: GitHub
- URL: https://github.com/rinja-rs/askama
- Owner: rinja-rs
- License: apache-2.0
- Created: 2016-12-22T12:50:45.000Z (about 8 years ago)
- Default Branch: main
- Last Pushed: 2025-01-02T04:07:43.000Z (20 days ago)
- Last Synced: 2025-01-16T21:52:40.072Z (5 days ago)
- Topics: custom-derive, jinja2, rust, rust-library, templating
- Language: Rust
- Homepage:
- Size: 3.57 MB
- Stars: 3,575
- Watchers: 24
- Forks: 223
- Open Issues: 133
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE-APACHE
Awesome Lists containing this project
- trackawesomelist - rinja-rs/askama (⭐3.5k) - template rendering engine based on Jinja (Recently Updated / [Dec 17, 2024](/content/2024/12/17/README.md))
README
# Askama
[](https://docs.rs/askama/)
[](https://crates.io/crates/askama)
[](https://github.com/djc/askama/actions?query=workflow%3ACI)
[](https://discord.gg/ZucwjE6bmT)
Askama implements a template rendering engine based on [Jinja](https://jinja.palletsprojects.com/).
It generates Rust code from your templates at compile time
based on a user-defined `struct` to hold the template's context.
See below for an example, or read [the book][docs].
**"Pretty exciting. I would love to use this already."** --
[Armin Ronacher][mitsuhiko], creator of Jinja
All feedback welcome. Feel free to file bugs, requests for documentation and
any other feedback to the [issue tracker][issues] or [tweet me][twitter].
Askama was created by and is maintained by Dirkjan Ochtman. If you are in a
position to support ongoing maintenance and further development or use it
in a for-profit context, please consider supporting my open source work on
[Patreon][patreon].
### Feature highlights
* 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, Rocket, 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)
* Works on stable Rust
### Supported in templates
* Template inheritance
* Loops, if/else statements and include support
* Macro support
* Variables (no mutability allowed)
* Some built-in filters, and the ability to use your own
* Whitespace suppressing with '-' markers
* Opt-out HTML escaping
* Syntax customization
[docs]: https://djc.github.io/askama/
[fafhrd91]: https://github.com/fafhrd91
[mitsuhiko]: http://lucumr.pocoo.org/
[issues]: https://github.com/djc/askama/issues
[twitter]: https://twitter.com/djco/
[patreon]: https://www.patreon.com/dochtman
[benchmarks]: https://github.com/djc/template-benchmarks-rs
How to get started
------------------
First, add the Askama dependency to your crate's `Cargo.toml`:
```sh
cargo add askama
```
Now create a directory called `templates` in your crate root.
In it, create a file called `hello.html`, containing the following:
```
Hello, {{ name }}!
```
In any Rust file inside your crate, add the following:
```rust
use askama::Template; // bring trait in scope
#[derive(Template)] // this will generate the code...
#[template(path = "hello.html")] // using the template in this path, relative
// to the `templates` dir in the crate root
struct HelloTemplate<'a> { // the name of the struct can be anything
name: &'a str, // the field name should match the variable name
// in your template
}
fn main() {
let hello = HelloTemplate { name: "world" }; // instantiate your struct
println!("{}", hello.render().unwrap()); // then render it.
}
```
You should now be able to compile and run this code.
Review the [test cases] for more examples.
[test cases]: https://github.com/djc/askama/tree/main/testing