rocket-include-tera

Crates.iorocket-include-tera
lib.rsrocket-include-tera
version0.5.8
sourcesrc
created_at2019-05-24 06:22:16.802699
updated_at2023-12-15 03:32:17.923257
descriptionThis is a crate which provides macros `tera_resources_initialize!` and `tera_response!` to statically include Tera files from your Rust project and make them be the HTTP response sources quickly.
homepagehttps://magiclen.org/rocket-include-tera
repositoryhttps://github.com/magiclen/rocket-include-tera
max_upload_size
id136562
size88,224
Magic Len (Ron Li) (magiclen)

documentation

README

Include Tera Templates for Rocket Framework

CI

This is a crate which provides macros tera_resources_initialize! and tera_response! to statically include Tera files from your Rust project and make them be the HTTP response sources quickly.

  • tera_resources_initialize! is used in the fairing of TeraResponseFairing to include Tera files into your executable binary file. You need to specify each file's name and its path relative to the directory containing the manifest of your package. In order to reduce the compilation time and allow to hot-reload templates, files are compiled into your executable binary file together, only when you are using the release profile.
  • tera_response! is used for retrieving and rendering the file you input through the macro tera_resources_initialize! as a TeraResponse instance with rendered HTML. When its respond_to method is called, three HTTP headers, Content-Type, Content-Length and Etag, will be automatically added, and the rendered HTML can optionally not be minified.
  • tera_response_cache! is used for wrapping a TeraResponse and its constructor, and use a key to cache its HTML and ETag in memory. The cache is generated only when you are using the release profile.
  • tera_resources_initializer! is used for generating a fairing for tera resources.

See examples.

Crates.io

https://crates.io/crates/rocket-include-tera

Documentation

https://docs.rs/rocket-include-tera

License

MIT

Commit count: 68

cargo fmt