wrapping mustache engine to suppress deprecations

carbonphp/View.php

@@ -4,6 +4,7 @@
 
 use CarbonPHP\Error\PrivateAlert;
 use CarbonPHP\Error\PublicAlert;
+use CarbonPHP\Extras\MustacheEngine;
 
 /**
  * Class View
@@ -85,7 +86,7 @@ public static function content(string $file, string|null $directoryContext = nul
 
         if (pathinfo($file, PATHINFO_EXTENSION) === 'hbs') {
 
-            $mustache = new \Mustache_Engine;
+            $mustache = new MustacheEngine;
 
             if (CarbonPHP::$socket || (!self::$forceWrapper && CarbonPHP::$pjax && CarbonPHP::$ajax)) {        // Send JSON To Socket
 
@@ -116,7 +117,7 @@ public static function content(string $file, string|null $directoryContext = nul
             #################### Send the Outer Wrapper
         } else if (pathinfo(self::$wrapper, PATHINFO_EXTENSION) === 'hbs') {   // Outer Wrapper is Mustache
             $json['content'] = $buffer;
-            $mustache = $mustache ?? new \Mustache_Engine;
+            $mustache = $mustache ?? new MustacheEngine;
             print $mustache->render(file_get_contents(self::$wrapper), $json);
         } else {                                                                       // Outer Wrapper is PHP?
             self::$bufferedContent = $buffer;

carbonphp/error/ThrowableHandler.php

@@ -9,10 +9,10 @@
 use CarbonPHP\CarbonPHP;
 use CarbonPHP\Database;
 use CarbonPHP\Enums\ThrowableReportDisplay;
+use CarbonPHP\Extras\MustacheEngine;
 use CarbonPHP\Interfaces\iColorCode;
 use CarbonPHP\Rest;
 use CarbonPHP\Tables\Reports;
-use Mustache_Engine;
 use PDOException;
 use ReflectionException;
 use ReflectionMethod;
@@ -1164,7 +1164,7 @@ protected static function errorTemplate(array $message, int $code = 200): string
 
             // @note if the Mustache_Engine fails, then tries to re-load itsself the message will say "Class "Mustache_Engine" not found"
             // This is very deceptive as the class is found, but failing to be loaded via compile time error. E_DEPRECATED is the first sign
-            $return =  (new Mustache_Engine)->render(self::$errorTemplate, $mustacheInfo);
+            $return =  (new MustacheEngine)->render(self::$errorTemplate, $mustacheInfo);
 
             self::start();
 

carbonphp/extras/MustacheEngine.php

@@ -0,0 +1,59 @@
+<?php
+
+namespace CarbonPHP\Extras;
+
+use CarbonPHP\Error\ThrowableHandler;
+use Mustache_Engine;
+use Throwable;
+
+class MustacheEngine extends Mustache_Engine
+{
+    public function __construct(array $options = [])
+    {
+        try {
+
+            ThrowableHandler::stop();
+
+            error_reporting(ThrowableHandler::$level ^ (E_NOTICE | E_WARNING | E_DEPRECATED));
+
+            // @note if the Mustache_Engine fails, then tries to re-load itsself the message will say "Class "Mustache_Engine" not found"
+            // This is very deceptive as the class is found, but failing to be loaded via compile time error. E_DEPRECATED is the first sign
+            parent::__construct($options);
+
+            ThrowableHandler::start();
+
+        } catch (Throwable $e) {
+
+            sortDump(['Mustache_Engine Failed', $e->getMessage(), $e->getTraceAsString()]);
+
+            exit(11);
+
+        }
+    }
+
+    public function render($template, $context = array())
+    {
+        try {
+
+            ThrowableHandler::stop();
+
+            error_reporting(ThrowableHandler::$level ^ (E_NOTICE | E_WARNING | E_DEPRECATED));
+
+            // @note if the Mustache_Engine fails, then tries to re-load itsself the message will say "Class "Mustache_Engine" not found"
+            // This is very deceptive as the class is found, but failing to be loaded via compile time error. E_DEPRECATED is the first sign
+            $result = parent::render($template, $context);
+
+            ThrowableHandler::start();
+
+            return $result;
+
+        } catch (Throwable $e) {
+
+            sortDump(['Mustache_Engine Failed', $e->getMessage(), $context]);
+
+            exit(11);
+
+        }
+    }
+}
+

carbonphp/programs/RestBuilder.php

@@ -12,6 +12,7 @@
 use CarbonPHP\Error\PrivateAlert;
 use CarbonPHP\Error\PublicAlert;
 use CarbonPHP\Error\ThrowableHandler;
+use CarbonPHP\Extras\MustacheEngine;
 use CarbonPHP\Interfaces\iColorCode;
 use CarbonPHP\Interfaces\iCommand;
 use CarbonPHP\Interfaces\iRest;
@@ -398,7 +399,7 @@ public function run(array $argv): void
         }
 
         // This is our mustache template engine implemented in php, used for rendering user content
-        $mustache = new \Mustache_Engine;
+        $mustache = new MustacheEngine;
 
         $verbose and var_dump(MySQL::$mysqldump);
 

carbonphp/tables/Carbons.php

@@ -228,14 +228,15 @@ public function __construct(array &$return = [])
                     // typically used to validate the full request, add additional data to the request, and even creating a history log
                     static fn() => self::disallowPublicAccess(self::class)
                 ],
-                self::FINISH => [
+                self::PRE_EXECUTE => [
                     // the compiled sql is passed to the callback, the statement has not been executed yet
                 ]  
             ],
             self::GET => [
                 self::PREPROCESS => [
                    static fn() => self::disallowPublicAccess(self::class)
-               ]
+               ],
+               self::PRE_EXECUTE => []
             ],
             self::POST => [
                 self::PREPROCESS => [
@@ -320,7 +321,7 @@ public function __construct(array &$return = [])
      *              Method validations under the main 'PREPROCESS' key will be run first, while validations specific to 
      *              ( GET | POST | PUT | DELETE )::PREPROCESS will be run directly after.
      *
-     *           FINAL:: 
+     *           PRE_EXECUTE:: 
      *              Each method will be passed the final ( & $SQL ), which may be a sub-query, by reference.
      *              Modifying the SQL string will effect the parent function. This can have disastrous effects.
      *
@@ -354,7 +355,7 @@ public function __construct(array &$return = [])
      *              Each method will be passed ( POST => void|&$returnID, DELETE => &$remove, PUT => &$returnUpdated ) by reference. 
      *              POST will BE PASSED NULL.          
      *
-     *          FINAL::
+     *          PRE_EXECUTE::
      *              Run directly after method specific [FINAL] callbacks.
      *              The final, 'final' callback set. After these run rest will return. 
      *              Each method will be passed ( GET => void|&$returnID, DELETE => &$remove, PUT => &$returnUpdated ) by reference. 
@@ -383,7 +384,7 @@ public function __construct(array &$return = [])
      *              Each method will be passed ( POST => void|&$returnID, DELETE => &$remove, PUT => &$returnUpdated ) by reference. 
      *              POST will BE PASSED NULL.
      *
-     *          FINAL::
+     *          PRE_EXECUTE::
      *              Passed the ( & $return )  
      *              Run before any other column validation 
      *

carbonphp/tables/Comments.php

@@ -206,14 +206,15 @@ public function __construct(array &$return = [])
                     // typically used to validate the full request, add additional data to the request, and even creating a history log
                     static fn() => self::disallowPublicAccess(self::class)
                 ],
-                self::FINISH => [
+                self::PRE_EXECUTE => [
                     // the compiled sql is passed to the callback, the statement has not been executed yet
                 ]  
             ],
             self::GET => [
                 self::PREPROCESS => [
                    static fn() => self::disallowPublicAccess(self::class)
-               ]
+               ],
+               self::PRE_EXECUTE => []
             ],
             self::POST => [
                 self::PREPROCESS => [
@@ -298,7 +299,7 @@ public function __construct(array &$return = [])
      *              Method validations under the main 'PREPROCESS' key will be run first, while validations specific to 
      *              ( GET | POST | PUT | DELETE )::PREPROCESS will be run directly after.
      *
-     *           FINAL:: 
+     *           PRE_EXECUTE:: 
      *              Each method will be passed the final ( & $SQL ), which may be a sub-query, by reference.
      *              Modifying the SQL string will effect the parent function. This can have disastrous effects.
      *
@@ -332,7 +333,7 @@ public function __construct(array &$return = [])
      *              Each method will be passed ( POST => void|&$returnID, DELETE => &$remove, PUT => &$returnUpdated ) by reference. 
      *              POST will BE PASSED NULL.          
      *
-     *          FINAL::
+     *          PRE_EXECUTE::
      *              Run directly after method specific [FINAL] callbacks.
      *              The final, 'final' callback set. After these run rest will return. 
      *              Each method will be passed ( GET => void|&$returnID, DELETE => &$remove, PUT => &$returnUpdated ) by reference. 
@@ -361,7 +362,7 @@ public function __construct(array &$return = [])
      *              Each method will be passed ( POST => void|&$returnID, DELETE => &$remove, PUT => &$returnUpdated ) by reference. 
      *              POST will BE PASSED NULL.
      *
-     *          FINAL::
+     *          PRE_EXECUTE::
      *              Passed the ( & $return )  
      *              Run before any other column validation 
      *

carbonphp/tables/Documentation.php

@@ -202,14 +202,15 @@ public function __construct(array &$return = [])
                     // typically used to validate the full request, add additional data to the request, and even creating a history log
                     static fn() => self::disallowPublicAccess(self::class)
                 ],
-                self::FINISH => [
+                self::PRE_EXECUTE => [
                     // the compiled sql is passed to the callback, the statement has not been executed yet
                 ]  
             ],
             self::GET => [
                 self::PREPROCESS => [
                    static fn() => self::disallowPublicAccess(self::class)
-               ]
+               ],
+               self::PRE_EXECUTE => []
             ],
             self::POST => [
                 self::PREPROCESS => [
@@ -294,7 +295,7 @@ public function __construct(array &$return = [])
      *              Method validations under the main 'PREPROCESS' key will be run first, while validations specific to 
      *              ( GET | POST | PUT | DELETE )::PREPROCESS will be run directly after.
      *
-     *           FINAL:: 
+     *           PRE_EXECUTE:: 
      *              Each method will be passed the final ( & $SQL ), which may be a sub-query, by reference.
      *              Modifying the SQL string will effect the parent function. This can have disastrous effects.
      *
@@ -328,7 +329,7 @@ public function __construct(array &$return = [])
      *              Each method will be passed ( POST => void|&$returnID, DELETE => &$remove, PUT => &$returnUpdated ) by reference. 
      *              POST will BE PASSED NULL.          
      *
-     *          FINAL::
+     *          PRE_EXECUTE::
      *              Run directly after method specific [FINAL] callbacks.
      *              The final, 'final' callback set. After these run rest will return. 
      *              Each method will be passed ( GET => void|&$returnID, DELETE => &$remove, PUT => &$returnUpdated ) by reference. 
@@ -357,7 +358,7 @@ public function __construct(array &$return = [])
      *              Each method will be passed ( POST => void|&$returnID, DELETE => &$remove, PUT => &$returnUpdated ) by reference. 
      *              POST will BE PASSED NULL.
      *
-     *          FINAL::
+     *          PRE_EXECUTE::
      *              Passed the ( & $return )  
      *              Run before any other column validation 
      *

carbonphp/tables/Feature_Group_References.php

@@ -288,7 +288,7 @@ public function __construct(array &$return = [])
      *              Method validations under the main 'PREPROCESS' key will be run first, while validations specific to 
      *              ( GET | POST | PUT | DELETE )::PREPROCESS will be run directly after.
      *
-     *           FINAL:: 
+     *           PRE_EXECUTE:: 
      *              Each method will be passed the final ( & $SQL ), which may be a sub-query, by reference.
      *              Modifying the SQL string will effect the parent function. This can have disastrous effects.
      *
@@ -322,7 +322,7 @@ public function __construct(array &$return = [])
      *              Each method will be passed ( POST => void|&$returnID, DELETE => &$remove, PUT => &$returnUpdated ) by reference. 
      *              POST will BE PASSED NULL.          
      *
-     *          FINAL::
+     *          PRE_EXECUTE::
      *              Run directly after method specific [FINAL] callbacks.
      *              The final, 'final' callback set. After these run rest will return. 
      *              Each method will be passed ( GET => void|&$returnID, DELETE => &$remove, PUT => &$returnUpdated ) by reference. 
@@ -351,7 +351,7 @@ public function __construct(array &$return = [])
      *              Each method will be passed ( POST => void|&$returnID, DELETE => &$remove, PUT => &$returnUpdated ) by reference. 
      *              POST will BE PASSED NULL.
      *
-     *          FINAL::
+     *          PRE_EXECUTE::
      *              Passed the ( & $return )  
      *              Run before any other column validation 
      *

carbonphp/tables/Features.php

@@ -290,7 +290,7 @@ public function __construct(array &$return = [])
      *              Method validations under the main 'PREPROCESS' key will be run first, while validations specific to 
      *              ( GET | POST | PUT | DELETE )::PREPROCESS will be run directly after.
      *
-     *           FINAL:: 
+     *           PRE_EXECUTE:: 
      *              Each method will be passed the final ( & $SQL ), which may be a sub-query, by reference.
      *              Modifying the SQL string will effect the parent function. This can have disastrous effects.
      *
@@ -324,7 +324,7 @@ public function __construct(array &$return = [])
      *              Each method will be passed ( POST => void|&$returnID, DELETE => &$remove, PUT => &$returnUpdated ) by reference. 
      *              POST will BE PASSED NULL.          
      *
-     *          FINAL::
+     *          PRE_EXECUTE::
      *              Run directly after method specific [FINAL] callbacks.
      *              The final, 'final' callback set. After these run rest will return. 
      *              Each method will be passed ( GET => void|&$returnID, DELETE => &$remove, PUT => &$returnUpdated ) by reference. 
@@ -353,7 +353,7 @@ public function __construct(array &$return = [])
      *              Each method will be passed ( POST => void|&$returnID, DELETE => &$remove, PUT => &$returnUpdated ) by reference. 
      *              POST will BE PASSED NULL.
      *
-     *          FINAL::
+     *          PRE_EXECUTE::
      *              Passed the ( & $return )  
      *              Run before any other column validation 
      *