Update tera to 2.3

Author: agluszak

tools/build-templated-pages/Cargo.toml

@@ -9,7 +9,8 @@ license = "MIT OR Apache-2.0"
 toml_edit = { version = "0.25.1", default-features = false, features = [
   "parse",
 ] }
-tera = "2.2"
+tera = { version = "2.3", features = ["glob_fs", "preserve_order"] }
+tera-contrib = { version = "0.3", features = ["slug"] }
 serde = { version = "1.0", features = ["derive"] }
 bitflags = "2.3"
 hashbrown = { version = "0.16.0", features = ["serde"] }

tools/build-templated-pages/src/examples.rs

@@ -1,7 +1,7 @@
+use alloc::collections::BTreeMap;
 use core::cmp::Ordering;
 use std::fs::File;
 
-use hashbrown::HashMap;
 use serde::Serialize;
 use tera::{Context, Tera};
 use toml_edit::{DocumentMut, Item};
@@ -81,7 +81,7 @@ fn parse_examples(panic_on_missing: bool) -> Vec<Example> {
         .collect()
 }
 
-fn parse_categories() -> HashMap<Box<str>, String> {
+fn parse_categories() -> BTreeMap<String, String> {
     let manifest_file = std::fs::read_to_string("Cargo.toml").unwrap();
     let manifest = manifest_file.parse::<DocumentMut>().unwrap();
     manifest
@@ -108,10 +108,10 @@ pub(crate) fn check(what_to_run: Command) {
 
     if what_to_run.contains(Command::UPDATE) {
         let categories = parse_categories();
-        let examples_by_category: HashMap<Box<str>, Category> = examples
+        let examples_by_category: BTreeMap<String, Category> = examples
             .into_iter()
-            .fold(HashMap::<Box<str>, Vec<Example>>::new(), |mut v, ex| {
-                v.entry_ref(ex.category.as_str()).or_default().push(ex);
+            .fold(BTreeMap::<String, Vec<Example>>::new(), |mut v, ex| {
+                v.entry(ex.category.clone()).or_default().push(ex);
                 v
             })
             .into_iter()
@@ -130,13 +130,16 @@ pub(crate) fn check(what_to_run: Command) {
 
         let mut context = Context::new();
         context.insert("all_examples", &examples_by_category);
-        Tera::new("docs-template/*.md.tpl")
-            .expect("error parsing template")
-            .render_to(
-                "EXAMPLE_README.md.tpl",
-                &context,
-                File::create("examples/README.md").expect("error creating file"),
-            )
-            .expect("error rendering template");
+        let mut tera = Tera::new();
+        tera.register_filter("slugify", tera_contrib::slug::slug);
+        tera.load_from_glob("docs-template/*.md.tpl")
+            .expect("error parsing template");
+
+        tera.render_to(
+            "EXAMPLE_README.md.tpl",
+            &context,
+            File::create("examples/README.md").expect("error creating file"),
+        )
+        .expect("error rendering template");
     }
 }

tools/build-templated-pages/src/features.rs

@@ -124,13 +124,18 @@ pub(crate) fn check(what_to_run: Command) {
         let mut context = Context::new();
         context.insert("features", &features);
         context.insert("sorted_features", &sorted_features);
-        Tera::new("docs-template/*.md.tpl")
-            .expect("error parsing template")
-            .render_to(
-                "features.md.tpl",
-                &context,
-                File::create("docs/cargo_features.md").expect("error creating file"),
-            )
-            .expect("error rendering template");
+
+        let mut tera = Tera::new();
+        tera.register_filter("slugify", tera_contrib::slug::slug);
+
+        tera.load_from_glob("docs-template/*.md.tpl")
+            .expect("error parsing template");
+
+        tera.render_to(
+            "features.md.tpl",
+            &context,
+            File::create("docs/cargo_features.md").expect("error creating file"),
+        )
+        .expect("error rendering template");
     }
 }

tools/build-templated-pages/src/main.rs

@@ -1,5 +1,7 @@
 //! Tool used to build the templated pages of the Bevy website.
 
+extern crate alloc;
+
 use bitflags::bitflags;
 
 mod examples;