From bd445b762937264cdc494adb2d58ff13167f03f0 Mon Sep 17 00:00:00 2001
From: seancroach <me@seancroach.dev>
Date: Mon, 24 Jul 2023 23:07:22 -0700
Subject: [PATCH] feat: add `Tera::new_unitialized` (#677)

Exposes a new function which creates an instance of Tera without
registering the default filters, testers, and functions. If this is
merged, the version of `tera` in `Cargo.toml` will have to get
its minor version incremented. No tests were added as no new
code was actually; I simply cut and paste the body from the
`Default` implementation. I need this functionality and thing no-ops
as an overwrite are too hacky. I hope others can benefit from this, too.
---
 src/tera.rs | 34 ++++++++++++++++++++++++----------
 1 file changed, 24 insertions(+), 10 deletions(-)

diff --git a/src/tera.rs b/src/tera.rs
index 0c694f5c..cb0f0a35 100644
--- a/src/tera.rs
+++ b/src/tera.rs
@@ -158,6 +158,24 @@ impl Tera {
         Self::create(dir, true)
     }
 
+    /// Create a new instance of Tera with no templates, filters, testers or functions registered.
+    ///
+    /// To create a new instance of Tera without any templates, but with the default filters,
+    /// testers and functions registered, use [`Tera::default`].
+    ///
+    #[must_use]
+    pub fn new_uninitialized() -> Tera {
+        Tera {
+            glob: None,
+            templates: HashMap::new(),
+            filters: HashMap::new(),
+            testers: HashMap::new(),
+            functions: HashMap::new(),
+            autoescape_suffixes: vec![".html", ".htm", ".xml"],
+            escape_fn: escape_html,
+        }
+    }
+
     /// Loads all the templates found in the glob that was given to [`Tera::new`].
     fn load_from_glob(&mut self) -> Result<()> {
         let glob = match &self.glob {
@@ -890,17 +908,13 @@ impl Tera {
 }
 
 impl Default for Tera {
+    /// Creates a new Tera instance with the default filters, testers, and
+    /// functions registered.
+    ///
+    /// For creating a new Tera instance with no default filters, testers, and
+    /// functions registered, use [`Tera::new_uninitialized`] instead.
     fn default() -> Tera {
-        let mut tera = Tera {
-            glob: None,
-            templates: HashMap::new(),
-            filters: HashMap::new(),
-            testers: HashMap::new(),
-            functions: HashMap::new(),
-            autoescape_suffixes: vec![".html", ".htm", ".xml"],
-            escape_fn: escape_html,
-        };
-
+        let mut tera = Tera::new_uninitialized();
         tera.register_tera_filters();
         tera.register_tera_testers();
         tera.register_tera_functions();