ructe

Modelos compilados de ferrugem - Ructe

Esta é a minha tentativa de escrever um sistema de modelo HTML para ferrugem. Alguma inspiração vem do sistema de modelo Scala usado no Play 2, bem como no JSP antigo e simples.

Critérios de design

• O maior número possível de erros deve ser capturado em tempo de compilação.
• Um binário compilado deve incluir todo o código de modelo necessário, não é necessário ler arquivos de modelo no tempo de execução.
• A compilação pode levar tempo, a execução deve ser rápida.
• Os modelos de escrita devem ser quase tão fáceis quanto escrever HTML.
• A linguagem do modelo deve ser o mais expressiva possível.
• Deve ser possível escrever modelos para qualquer formato semelhante ao texto, não apenas HTML.
• Qualquer valor que implementa a característica Display deve ser produzida.
• Por padrão, todos os valores devem ser escapados em HTML. Deve haver uma maneira fácil, mas explícita, de produzir HTML pré -formado.

Status atual

Os rastos estão em um estágio bastante inicial, mas funciona; Os modelos podem ser transpilados para funções de ferrugem, que são compiladas e podem ser chamadas do código de ferrugem.

Formato de modelo

Um modelo consiste em três peças básicas: primeiro um preâmbulo de instruções use , cada uma com antecedência por um sinal @ . Em segundo lugar, uma declaração dos parâmetros que o modelo leva. E terceiro, o corpo do modelo.

A sintaxe completa é descrita na documentação. Alguns exemplos podem ser vistos em exemplos/simples/modelos. Um modelo pode parecer algo assim:

@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 > 

Como usar Ructe

A Ructe compila seus modelos para o código de ferrugem que deve ser compilado com seu outro código de ferrugem, por isso precisa ser chamado antes de compilar, conforme descrito na documentação. Existem também exemplos, tanto para a própria Ructe quanto seus futuros e para usá-lo com as estruturas da web axum, actix-web, gotham, ferro, níquel, maré e urdidura. Há também um exemplo separado de usar Ructe com Warp e Diesel.