From ae1c71fec01fb72228b83fb6cc9a43003038c8e7 Mon Sep 17 00:00:00 2001
From: netkas <netkas@n64.cc>
Date: Tue, 5 Nov 2024 15:48:01 -0500
Subject: [PATCH] Add BacktraceParser class to LogLib

---
 src/LogLib/Classes/BacktraceParser.php | 87 ++++++++++++++++++++++++++
 1 file changed, 87 insertions(+)
 create mode 100644 src/LogLib/Classes/BacktraceParser.php

diff --git a/src/LogLib/Classes/BacktraceParser.php b/src/LogLib/Classes/BacktraceParser.php
new file mode 100644
index 0000000..8a7d0e5
--- /dev/null
+++ b/src/LogLib/Classes/BacktraceParser.php
@@ -0,0 +1,87 @@
+<?php
+
+    namespace LogLib\Classes;
+
+    class BacktraceParser
+    {
+        /**
+         * Determines if the given backtrace originates from the exception handler.
+         *
+         * @param array $backtrace The backtrace array to inspect.
+         * @return bool Returns true if the backtrace originates from the exception handler within LogLib\Runtime class, false otherwise.
+         */
+        public static function fromExceptionHandler(array $backtrace): bool
+        {
+            /** @var array $trace */
+            foreach($backtrace as $trace)
+            {
+                if(!isset($trace['function']) || $trace['function'] != 'exceptionHandler')
+                {
+                    continue;
+                }
+
+                if(!isset($trace['class']) || $trace['class'] != 'LogLib\Runtime')
+                {
+                    continue;
+                }
+
+                return true;
+            }
+
+            return false;
+        }
+
+        /**
+         * Determines if the given backtrace originates from the error handler.
+         *
+         * @param array $backtrace The backtrace array to inspect.
+         * @return bool Returns true if the backtrace originates from the error handler within LogLib\Runtime class, false otherwise.
+         */
+        public static function fromErrorHandler(array $backtrace): bool
+        {
+            /** @var array $trace */
+            foreach($backtrace as $trace)
+            {
+                if(!isset($trace['function']) || $trace['function'] != 'errorHandler')
+                {
+                    continue;
+                }
+
+                if(!isset($trace['class']) || $trace['class'] != 'LogLib\Runtime')
+                {
+                    continue;
+                }
+
+                return true;
+            }
+
+            return false;
+        }
+
+        /**
+         * Determines if a given backtrace contains a call to the shutdownHandler method in the LogLib\Runtime class.
+         *
+         * @param array $backtrace The backtrace to be analyzed.
+         * @return bool True if the shutdownHandler method in the LogLib\Runtime class is found in the backtrace; otherwise, false.
+         */
+        public static function fromShutdownHandler(array $backtrace): bool
+        {
+            /** @var array $trace */
+            foreach($backtrace as $trace)
+            {
+                if(!isset($trace['function']) || $trace['function'] != 'shutdownHandler')
+                {
+                    continue;
+                }
+
+                if(!isset($trace['class']) || $trace['class'] != 'LogLib\Runtime')
+                {
+                    continue;
+                }
+
+                return true;
+            }
+
+            return false;
+        }
+    }
\ No newline at end of file