Security update for permissions_by_term
[yaffs-website] / vendor / behat / behat / src / Behat / Testwork / Suite / SuiteRegistry.php
diff --git a/vendor/behat/behat/src/Behat/Testwork/Suite/SuiteRegistry.php b/vendor/behat/behat/src/Behat/Testwork/Suite/SuiteRegistry.php
new file mode 100644 (file)
index 0000000..5ad98fd
--- /dev/null
@@ -0,0 +1,125 @@
+<?php
+
+/*
+ * This file is part of the Behat Testwork.
+ * (c) Konstantin Kudryashov <ever.zet@gmail.com>
+ *
+ * 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 <ever.zet@gmail.com>
+ */
+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);
+    }
+}