Security update for permissions_by_term

[yaffs-website] / vendor / behat / behat / src / Behat / Testwork / Environment / EnvironmentManager.php

diff --git a/vendor/behat/behat/src/Behat/Testwork/Environment/EnvironmentManager.php b/vendor/behat/behat/src/Behat/Testwork/Environment/EnvironmentManager.php
new file mode 100644 (file)
index 0000000..b1dda50
--- /dev/null
+++ b/vendor/behat/behat/src/Behat/Testwork/Environment/EnvironmentManager.php
@@ -0,0 +1,121 @@
+<?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\Environment;
+
+use Behat\Testwork\Call\Callee;
+use Behat\Testwork\Environment\Exception\EnvironmentBuildException;
+use Behat\Testwork\Environment\Exception\EnvironmentIsolationException;
+use Behat\Testwork\Environment\Handler\EnvironmentHandler;
+use Behat\Testwork\Environment\Reader\EnvironmentReader;
+use Behat\Testwork\Suite\Suite;
+
+/**
+ * Builds, isolates and reads environments using registered handlers and readers.
+ *
+ * @author Konstantin Kudryashov <ever.zet@gmail.com>
+ */
+final class EnvironmentManager
+{
+    /**
+     * @var EnvironmentHandler[]
+     */
+    private $handlers = array();
+    /**
+     * @var EnvironmentReader[]
+     */
+    private $readers = array();
+
+    /**
+     * Registers environment handler.
+     *
+     * @param EnvironmentHandler $handler
+     */
+    public function registerEnvironmentHandler(EnvironmentHandler $handler)
+    {
+        $this->handlers[] = $handler;
+    }
+
+    /**
+     * Registers environment reader.
+     *
+     * @param EnvironmentReader $reader
+     */
+    public function registerEnvironmentReader(EnvironmentReader $reader)
+    {
+        $this->readers[] = $reader;
+    }
+
+    /**
+     * Builds new environment for provided test suite.
+     *
+     * @param Suite $suite
+     *
+     * @return Environment
+     *
+     * @throws EnvironmentBuildException
+     */
+    public function buildEnvironment(Suite $suite)
+    {
+        foreach ($this->handlers as $handler) {
+            if ($handler->supportsSuite($suite)) {
+                return $handler->buildEnvironment($suite);
+            }
+        }
+
+        throw new EnvironmentBuildException(sprintf(
+            'None of the registered environment handlers seem to support `%s` suite.',
+            $suite->getName()
+        ), $suite);
+    }
+
+    /**
+     * Creates new isolated test environment using built one.
+     *
+     * @param Environment $environment
+     * @param mixed       $testSubject
+     *
+     * @return Environment
+     *
+     * @throws EnvironmentIsolationException If appropriate environment handler is not found
+     */
+    public function isolateEnvironment(Environment $environment, $testSubject = null)
+    {
+        foreach ($this->handlers as $handler) {
+            if ($handler->supportsEnvironmentAndSubject($environment, $testSubject)) {
+                return $handler->isolateEnvironment($environment, $testSubject);
+            }
+        }
+
+        throw new EnvironmentIsolationException(sprintf(
+            'None of the registered environment handlers seem to support `%s` environment.',
+            get_class($environment)
+        ), $environment, $testSubject);
+    }
+
+    /**
+     * Reads all callees from environment using registered environment readers.
+     *
+     * @param Environment $environment
+     *
+     * @return Callee[]
+     */
+    public function readEnvironmentCallees(Environment $environment)
+    {
+        $callees = array();
+        foreach ($this->readers as $reader) {
+            if ($reader->supportsEnvironment($environment)) {
+                $callees = array_merge($callees, $reader->readEnvironmentCallees($environment));
+            }
+        }
+
+        return $callees;
+    }
+}