MQE-1713: Generate/run test in single suite context

- added support for 'suite:test' syntax in generate and run:test command
- minor fixes to exceptions in suite mechanisms

Author: KevinBKozan

dev/tests/unit/Magento/FunctionalTestFramework/Console/BaseGenerateCommandTest.php

@@ -156,6 +156,24 @@ public function testThreeTestOneSuiteOneGroupMix()
         $this->assertEquals($expected, $actual);
     }
 
+    public function testSuiteToTestSyntax()
+    {
+        $testOne = new TestObject('Test1', [], [], []);
+        $suiteOne = new SuiteObject(
+            'Suite1',
+            ['Test1' => $testOne],
+            [],
+            []
+        );
+
+        $testArray = ['Test1' => $testOne];
+        $suiteArray = ['Suite1' => $suiteOne];
+        $this->mockHandlers($testArray, $suiteArray);
+        $actual = json_decode($this->callTestConfig(['Suite1:Test1']), true);
+        $expected = ['tests' => null, 'suites' => ['Suite1' => ['Test1']]];
+        $this->assertEquals($expected, $actual);
+    }
+
     /**
      * Mock handlers to skip parsing
      * @param array $testArray

src/Magento/FunctionalTestingFramework/Console/BaseGenerateCommand.php

@@ -87,6 +87,10 @@ protected function getTestAndSuiteConfiguration(array $tests)
         $suiteToTestPair = [];
 
         foreach($tests as $test) {
+            if (strpos($test, ':') !== null) {
+                $suiteToTestPair[] = $test;
+                continue;
+            }
             if (array_key_exists($test, $testsReferencedInSuites)) {
                 $suites = $testsReferencedInSuites[$test];
                 foreach ($suites as $suite) {

src/Magento/FunctionalTestingFramework/Suite/Handlers/SuiteObjectHandler.php

@@ -5,6 +5,7 @@
  */
 namespace Magento\FunctionalTestingFramework\Suite\Handlers;
 
+use Magento\FunctionalTestingFramework\Exceptions\TestReferenceException;
 use Magento\FunctionalTestingFramework\Exceptions\XmlException;
 use Magento\FunctionalTestingFramework\ObjectManager\ObjectHandlerInterface;
 use Magento\FunctionalTestingFramework\ObjectManagerFactory;
@@ -73,7 +74,7 @@ public static function getInstance(): ObjectHandlerInterface
     public function getObject($objectName): SuiteObject
     {
         if (!array_key_exists($objectName, $this->suiteObjects)) {
-            trigger_error("Suite ${objectName} is not defined.", E_USER_ERROR);
+            throw new TestReferenceException("Suite ${objectName} is not defined in xml.");
         }
         return $this->suiteObjects[$objectName];
     }

src/Magento/FunctionalTestingFramework/Suite/SuiteGenerator.php

@@ -178,7 +178,7 @@ private function validateTestsReferencedInSuite($suiteName, $testsReferenced, $o
     {
         $suiteRef = $originalSuiteName ?? $suiteName;
         $possibleTestRef = SuiteObjectHandler::getInstance()->getObject($suiteRef)->getTests();
-        $errorMsg = "Cannot reference tests whcih are not declared as part of suite.";
+        $errorMsg = "Cannot reference tests which are not declared as part of suite.";
 
         $invalidTestRef = array_diff($testsReferenced, array_keys($possibleTestRef));