* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Behat\Testwork\Suite; use Behat\Testwork\Suite\Exception\SuiteConfigurationException; use Behat\Testwork\Suite\Exception\SuiteGenerationException; use Behat\Testwork\Suite\Generator\SuiteGenerator; /** * Acts like a suite repository by auto-generating suites for registered suite configurations using registered * generators. * * @author Konstantin Kudryashov */ final class SuiteRegistry implements SuiteRepository { /** * @var Boolean */ private $suitesGenerated = false; /** * @var SuiteGenerator[] */ private $generators = array(); /** * @var array */ private $suiteConfigurations = array(); /** * @var Suite[] */ private $suites = array(); /** * Registers suite generator. * * @param SuiteGenerator $generator */ public function registerSuiteGenerator(SuiteGenerator $generator) { $this->generators[] = $generator; $this->suitesGenerated = false; } /** * Registers suite using provided name, type & parameters. * * @param string $name * @param string $type * @param array $settings * * @throws SuiteConfigurationException */ public function registerSuiteConfiguration($name, $type, array $settings) { if (isset($this->suiteConfigurations[$name])) { throw new SuiteConfigurationException(sprintf( 'Suite configuration for a suite "%s" is already registered.', $name ), $name); } $this->suiteConfigurations[$name] = array($type, $settings); $this->suitesGenerated = false; } /** * Returns all available suites. * * @return Suite[] */ public function getSuites() { if ($this->suitesGenerated) { return $this->suites; } $this->suites = array(); foreach ($this->suiteConfigurations as $name => $configuration) { list($type, $settings) = $configuration; $this->suites[] = $this->generateSuite($name, $type, $settings); } $this->suitesGenerated = true; return $this->suites; } /** * Generates suite using registered generators. * * @param string $name * @param string $type * @param array $settings * * @return Suite * * @throws SuiteGenerationException If no appropriate generator found */ private function generateSuite($name, $type, array $settings) { foreach ($this->generators as $generator) { if (!$generator->supportsTypeAndSettings($type, $settings)) { continue; } return $generator->generateSuite($name, $settings); } throw new SuiteGenerationException(sprintf( 'Can not find suite generator for a suite `%s` of type `%s`.', $name, $type ), $name); } }