ructe

Скомпилированные шаблоны ржавчины - Ructe

Это моя попытка написать систему шаблонов HTML для ржавчины. Некоторое вдохновение исходит из системы шаблонов Scala, используемой в Play 2, а также простых старых JSP.

Критерии дизайна

• Как можно больше ошибок следует поймать во время компиляции.
• Скомпилированный двоичный файл должен включать весь код шаблона, в котором он нуждается, не нужно читать файлы шаблонов во время выполнения.
• Компиляция может занять время, бег должен быть быстрым.
• Письменные шаблоны должны быть почти такими же простыми, как написание HTML.
• Язык шаблона должен быть максимально выразительным.
• Должно быть возможно писать шаблоны для любого текстового формата, а не только HTML.
• Любое значение, которое реализует черту Display должно быть выводимым.
• По умолчанию все значения должны быть сняты HTML. Должен быть простой, но явный способ вывода предварительно форматированного HTML.

Текущий статус

Ructes находится на довольно ранней стадии, но работает; Шаблоны могут быть перенесены на функции ржавчины, которые затем собираются и могут быть вызваны из кода ржавчины.

Формат шаблона

Шаблон состоит из трех основных частей: сначала преамбула с use операторов, каждый из которых приготовлен знаком @ . Во -вторых, объявление параметров, которые принимает шаблон. И в -третьих, тело шаблона.

Полный синтаксис описан в документации. Некоторые примеры можно увидеть в примерах/простых/шаблонах. Шаблон может выглядеть примерно так:

@use any::rust::Type;
@use super::statics::style_css;

@(name: &str, items: &[Type])

< html >
   < head >
     < title > @name </ title >
     < link rel =" stylesheet " href =" /static/@style_css.name " type =" text/css " />
   </ head >
   < body >
     < h1 > @name </ h1 >
     < dl >
     @for item in items {
       < dt > @item.title() </ dt >
       < dd > @item.description() </ dd >
     }
     </ dl >
   < body >
</ html > 

Как использовать ructe

Ructe собирает ваши шаблоны в код Rust, который должен быть составлен с вашим другим кодом ржавчины, поэтому его необходимо вызвать перед компиляцией, как описано в документации. Существуют также примеры, как для самого ructe, так и для его будущего, так и для использования его с веб-каркасами Axum, Actix-Web, Gotham, Iron, Nickel, Tide и Warp. Существует также отдельный пример использования ructe с варп и дизель.