ructe

Rost -kompilierte Vorlagen - RUCTE

Dies ist mein Versuch, ein HTML -Vorlagensystem für Rost zu schreiben. Eine gewisse Inspiration stammt aus dem in Play 2 verwendeten Scala -Vorlagensystem sowie der einfachen alten JSP.

Designkriterien

• So viele Fehler wie möglich sollten zur Kompilierungszeit gefangen werden.
• Eine kompilierte Binärdatei sollte den gesamten Vorlagencode enthalten, den es benötigt, und es müssen keine Vorlagendateien zur Laufzeit gelesen werden.
• Die Kompilierung kann Zeit dauern, das Laufen sollte schnell sein.
• Das Schreiben von Vorlagen sollte fast so einfach sein wie das Schreiben von HTML.
• Die Vorlagensprache sollte so ausdrucksstark wie möglich sein.
• Es sollte möglich sein, Vorlagen für ein textähnliches Format zu schreiben, nicht nur für HTML.
• Jeder Wert, der das Display implementiert, sollte ausgegeben werden.
• Standardmäßig sollten alle Werte HTML-Escaped sein. Es sollte eine einfache, aber explizite Möglichkeit geben, vorformatiertes HTML auszugeben.

Aktueller Status

Rätes befinden sich in einem ziemlich frühen Stadium, funktioniert aber; Vorlagen können in Rostfunktionen umgesetzt werden, die dann zusammengestellt und aus Rostcode aufgerufen werden können.

Vorlagenformat

Eine Vorlage besteht aus drei grundlegenden Teilen: Erstens eine Präambel der use , die jeweils von einem @ Zeichen vorbereitet werden. Zweitens eine Deklaration der Parameter, die die Vorlage benötigt. Und drittens der Vorlagekörper.

Die vollständige Syntax ist in der Dokumentation beschrieben. Einige Beispiele sind in Beispielen/einfachen/Vorlagen zu sehen. Eine Vorlage kann ungefähr so ​​aussehen:

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

So verwenden Sie Races

RUCTE erstellt Ihre Vorlagen in Rostcode, der mit Ihrem anderen Rust -Code kompiliert werden sollte. Daher muss er vor dem Kompilieren aufgerufen werden, wie in der Dokumentation beschrieben. Es gibt auch Beispiele, sowohl für Ruces selbst als auch für seine Zukunft und für die Verwendung mit dem Web Frameworks Axum, Actix-Web, Gotham, Eisen, Nickel, Tide und Warp. Es gibt auch ein separates Beispiel für die Verwendung von Ructe mit Warp und Diesel.