ructe

Template yang dikompilasi karat - Ructe

Ini adalah upaya saya untuk menulis sistem template HTML untuk karat. Beberapa inspirasi berasal dari sistem template scala yang digunakan dalam Play 2, serta JSP tua biasa.

Kriteria Desain

• Sebanyak mungkin kesalahan harus ditangkap pada waktu kompilasi.
• Biner yang dikompilasi harus mencakup semua kode template yang dibutuhkan, tidak perlu membaca file template saat runtime.
• Kompilasi mungkin memakan waktu, berlari harus cepat.
• Template menulis harus hampir semudah menulis HTML.
• Bahasa template harus sama ekspresifnya.
• Seharusnya dimungkinkan untuk menulis templat untuk format seperti teks, tidak hanya HTML.
• Nilai apa pun yang mengimplementasikan sifat Display harus dikeluarkan.
• Secara default, semua nilai harus dihindarkan HTML. Seharusnya ada cara yang mudah tetapi eksplisit untuk menghasilkan HTML yang diformat sebelumnya.

Status saat ini

Ruces berada dalam tahap yang agak awal, tetapi bekerja; Templat dapat ditranspilasi ke fungsi karat, yang kemudian dikompilasi dan dapat dipanggil dari Rust Code.

Format template

Template terdiri dari tiga bagian dasar: Pertama pembukaan pernyataan use , masing -masing diisi dengan tanda @ . Kedua, deklarasi parameter yang diambil template. Dan ketiga, tubuh template.

Sintaks lengkap dijelaskan dalam dokumentasi. Beberapa contoh dapat dilihat dalam contoh/sederhana/templat. Template mungkin terlihat seperti ini:

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

Cara menggunakan ructe

Ructe mengkompilasi templat Anda ke kode karat yang harus dikompilasi dengan kode karat Anda yang lain, sehingga perlu dipanggil sebelum menyusun, seperti yang dijelaskan dalam dokumentasi. Ada juga contoh, baik untuk Ructe itu sendiri dan masa depannya dan untuk menggunakannya dengan kerangka web Axum, Actix-Web, Gotham, Iron, Nickel, Tide, dan Warp. Ada juga contoh terpisah menggunakan Ructe dengan Warp dan Diesel.