From bf77e1b5539420b7dec00fbe4924003125d5461c Mon Sep 17 00:00:00 2001
From: Pieter Hijma <pieterhijma@users.noreply.github.com>
Date: Sun, 5 Oct 2025 13:44:48 +0200
Subject: [PATCH] Gui: Add a possibility to redirect macro commands

---
 src/Gui/Macro.cpp | 12 ++++++++++-
 src/Gui/Macro.h   | 52 ++++++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 62 insertions(+), 2 deletions(-)

diff --git a/src/Gui/Macro.cpp b/src/Gui/Macro.cpp
index 49713f5ff9..f68c4e7b37 100644
--- a/src/Gui/Macro.cpp
+++ b/src/Gui/Macro.cpp
@@ -218,6 +218,8 @@ MacroManager::~MacroManager()
     this->params->Detach(this);
 }
 
+std::stack<std::function<void(MacroManager::LineType, const char*)>> MacroManager::redirectFuncs;
+
 void MacroManager::OnChange(Base::Subject<const char*> &rCaller, const char * sReason)
 {
     (void)rCaller;
@@ -268,8 +270,16 @@ void MacroManager::addPendingLine(LineType type, const char* line)
 
 void MacroManager::addLine(LineType Type, const char* sLine)
 {
-    if (!sLine)
+    if (!sLine) {
         return;
+    }
+
+    std::function<void(LineType, const char*)> redirectFunc =
+        redirectFuncs.empty() ? nullptr : redirectFuncs.top();
+    if (redirectFunc) {
+        redirectFunc(Type, sLine);
+        return;
+    }
 
     if (buffer.hasPendingLines()) {
         if (buffer.addPendingLineIfComment(Type, sLine)) {
diff --git a/src/Gui/Macro.h b/src/Gui/Macro.h
index eeff49f568..47e5c59829 100644
--- a/src/Gui/Macro.h
+++ b/src/Gui/Macro.h
@@ -24,6 +24,7 @@
 #ifndef GUI_MACRO_H
 #define GUI_MACRO_H
 
+#include <stack>
 #include <tuple>
 #include <QString>
 #include <QStringList>
@@ -121,6 +122,46 @@ public:
         Cmt,  /**< The line is handled as a comment */
     };
 
+    /**  Redirect the macro output temporarily.
+     *
+     * This is a RAII class to redirect the macro output to a function.
+     * Initializing an instance with a redirect function, ensures that
+     * MacroManager::addLine() calls are redirected by means of the redirect
+     * function.  More than one instances can be used, overriding earlier
+     * instances and their redirect functions.
+     *
+     * @code
+     * void myRedirectFunc1(MacroManager::LineType type, const char* line)
+     * { // do something with the line }
+     *
+     * void myRedirectFunc2(MacroManager::LineType type, const char* line)
+     * { // do something else with the line }
+     *
+     * {
+     *   MacroRedirector redirect(myRedirectFunc1);
+     *   // all macro output will go to myRedirectFunc1
+     *   {
+     *     MacroRedirector redirect2(myRedirectFunc2);
+     *     // all macro output will go to myRedirectFunc2
+     *   }
+     *   // all macro output will go to myRedirectFunc1
+     * }
+     * // normal macro output is restored
+     * @endcode
+     */
+    class MacroRedirector
+    {
+    public:
+        explicit MacroRedirector(const std::function<void(LineType, const char*)>& func)
+        {
+            MacroManager::redirectFuncs.push(func);
+        }
+
+        ~MacroRedirector() {
+            MacroManager::redirectFuncs.pop();
+        }
+    };
+
     /** Opens a new Macro recording session
      * Starts a session with the type and the name of the macro.
      * All user interactions will be recorded as long as the commit() or cancel() isn't called.
@@ -139,7 +180,15 @@ public:
     bool isOpen() const {
         return macroFile.isOpen();
     }
-    /// insert a new line in the macro
+
+    /** Insert a new line in the macro.
+     *
+     * The line is added to the macro unless the output is redirected.
+     * @see MacroRedirector.
+     *
+     * @param Type The type of the line
+     * @param sLine The line to add
+     */
     void addLine(LineType Type, const char* sLine);
     /// insert a new pending line in the macro
     void addPendingLine(LineType type, const char* line);
@@ -174,6 +223,7 @@ private:
     mutable PythonConsole* pyConsole{nullptr};       // link to the python console
     PythonDebugger* pyDebugger;
     Base::Reference<ParameterGrp> params;  // link to the Macro parameter group
+    static std::stack<std::function<void(LineType, const char*)>> redirectFuncs;
 
     friend struct ApplicationP;
 };