feature #1601 [tests] allow dev's to view test process output locally

Author: jrushlow

phpunit.xml.dist

@@ -21,6 +21,9 @@
         <env name="MAKER_SKIP_PANTHER_TEST" value="false" />
 <!--    Overrides process timeout when step debugging -->
 <!--    <env name="MAKER_PROCESS_TIMEOUT" value="null" /> -->
+<!--    Dump the CLI output for a test runner process immediately after running a test -->
+<!--    You should only set this to true when you need to debug the actual output of a maker command within a test -->
+<!--    <env name="MAKER_TEST_DUMP_OUTPUT" value="false" /> -->
     </php>
 
     <testsuites>

src/Test/MakerTestRunner.php

@@ -35,7 +35,16 @@ public function runMaker(array $inputs, string $argumentsString = '', bool $allo
     {
         $this->executedMakerProcess = $this->environment->runMaker($inputs, $argumentsString, $allowedToFail, $envVars);
 
-        return $this->executedMakerProcess->getOutput();
+        $output = $this->executedMakerProcess->getOutput();
+
+        // Allows for debugging the actual CLI output from within a test process. E.g. Manually viewing the output of the
+        // `make:voter` command that was run within the MakeVoterTest from your local command line.
+        // You should never use this in CI unless you know what you're doing - resource intensive.
+        if ('true' === getenv('MAKER_TEST_DUMP_OUTPUT')) {
+            dump(['Maker Process Output' => $output, 'Maker Process Error Output' => $this->executedMakerProcess->getErrorOutput()]);
+        }
+
+        return $output;
     }
 
     /**