Pause and unpause CLI

Author: Spacehuhn

README.md

@@ -298,12 +298,16 @@ Here is a plain overview of all classes and their methods:
 ```c++
 SimpleCLI(int commandQueueSize = 10, int errorQueueSize = 10);
 
+void pause();
+void unpause();
+
 void parse(String& input);
 void parse(const char* input);
 void parse(const char* input, size_t input_len);
 
 bool available() const;
 bool errored() const;
+bool paused() const;
 
 int countCmdQueue() const;
 int countErrorQueue() const;

src/SimpleCLI.cpp

@@ -20,6 +20,41 @@ SimpleCLI::~SimpleCLI() {
     cmd_error_destroy_rec(errorQueue);
 }
 
+void SimpleCLI::pause() {
+    pauseParsing = true;
+}
+
+void SimpleCLI::unpause() {
+    pauseParsing = false;
+
+    // Go through queued errors
+    while (onError && errored()) {
+        onError(getError().getPtr());
+    }
+
+    // Go through queued commands
+    if(available()) {
+        cmd* prev = NULL;
+        cmd* current = cmdQueue;
+        cmd* next = NULL;
+
+        while(current) {
+            next = current->next;
+
+            // Has callback, then run it and remove from queue
+            if(current->callback) {
+                current->callback(current);
+                if(prev) prev->next = next;
+                cmd_destroy(current);
+            } else {
+                prev = current;
+            }
+
+            current = next;
+        }
+    }
+}
+
 void SimpleCLI::parse(const String& input) {
     parse(input.c_str(), input.length());
 }
@@ -45,15 +80,15 @@ void SimpleCLI::parse(const char* str, size_t len) {
 
             // When parsing was successful
             if (e->mode == CMD_PARSE_SUCCESS) {
-                if (h->callback) h->callback(h);
+                if (h->callback && !pauseParsing) h->callback(h);
                 else cmdQueue = cmd_push(cmdQueue, cmd_move(h), commandQueueSize);
 
                 success = true;
             }
 
             // When command name matches but something else went wrong, exit with error
             else if (e->mode > CMD_NOT_FOUND) {
-                if (onError) {
+                if (onError && !pauseParsing) {
                     onError(e);
                 } else {
                     errorQueue = cmd_error_push(errorQueue, cmd_error_copy(e), errorQueueSize);
@@ -79,7 +114,7 @@ void SimpleCLI::parse(const char* str, size_t len) {
         if (!errored && !success) {
             cmd_error* e = cmd_error_create_not_found(NULL, n->words->first);
 
-            if (onError) {
+            if (onError && !pauseParsing) {
                 onError(e);
             } else {
                 errorQueue = cmd_error_push(errorQueue, cmd_error_copy(e), errorQueueSize);
@@ -104,6 +139,10 @@ bool SimpleCLI::errored() const {
     return errorQueue;
 }
 
+bool SimpleCLI::paused() const {
+    return pauseParsing;
+}
+
 int SimpleCLI::countCmdQueue() const {
     cmd* h = cmdQueue;
     int  i = 0;

src/SimpleCLI.h

@@ -17,6 +17,7 @@
 class SimpleCLI {
     private:
         bool caseSensetive { false };
+        bool pauseParsing { false };
 
         cmd* cmdList { NULL };          // List of accessible commands
         cmd* cmdQueue { NULL };         // Queue with parsed commands the user has typed in
@@ -36,12 +37,16 @@ class SimpleCLI {
         SimpleCLI(int commandQueueSize = 10, int errorQueueSize = 10);
         ~SimpleCLI();
 
+        void pause();
+        void unpause();
+
         void parse(const String& input);
         void parse(const char* input);
         void parse(const char* input, size_t input_len);
 
         bool available() const;
         bool errored() const;
+        bool paused() const;
 
         int countCmdQueue() const;
         int countErrorQueue() const;