From 9dc916db7905f2e8d8a1623d306aa29d641213e0 Mon Sep 17 00:00:00 2001
From: Tetrakern <26898880+Tetrakern@users.noreply.github.com>
Date: Sun, 27 Oct 2024 16:03:44 +0100
Subject: [PATCH] Add development helper to measure performance in microseconds

---
 includes/functions/_development.php | 33 +++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/includes/functions/_development.php b/includes/functions/_development.php
index 2473d6b5..8cc5b6a3 100644
--- a/includes/functions/_development.php
+++ b/includes/functions/_development.php
@@ -1,5 +1,38 @@
 <?php
 
+// =============================================================================
+// PERFORMANCE MEASUREMENT
+// =============================================================================
+
+/**
+ * Stored current microtime globally
+ *
+ * @since 5.26.0
+ */
+
+function fictioneer_start_micro_time() {
+  global $fictioneer_start_time;
+
+  $fictioneer_start_time = microtime( 1 );
+}
+
+/**
+ * Writes elapses microtime to log
+ *
+ * @since 5.26.0
+ */
+
+function fictioneer_log_micro_time( $context = '' ) {
+  global $fictioneer_start_time;
+
+  if ( $fictioneer_start_time ) {
+    $prefix = $context ? "({$context}) Duration: " : 'Duration: ';
+    error_log( $prefix . ( microtime( 1 ) - $fictioneer_start_time ) );
+  }
+
+  $fictioneer_start_time = null;
+}
+
 // =============================================================================
 // GENERATE TEST CONTENT
 // =============================================================================