Security update for permissions_by_term
[yaffs-website] / vendor / behat / behat / src / Behat / Testwork / Specification / Locator / SpecificationLocator.php
diff --git a/vendor/behat/behat/src/Behat/Testwork/Specification/Locator/SpecificationLocator.php b/vendor/behat/behat/src/Behat/Testwork/Specification/Locator/SpecificationLocator.php
new file mode 100644 (file)
index 0000000..372fbea
--- /dev/null
@@ -0,0 +1,42 @@
+<?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\Specification\Locator;
+
+use Behat\Testwork\Specification\SpecificationFinder;
+use Behat\Testwork\Specification\SpecificationIterator;
+use Behat\Testwork\Suite\Suite;
+
+/**
+ * Provides a custom way to locate specification by provided suite and locator string.
+ *
+ * @see SpecificationFinder
+ *
+ * @author Konstantin Kudryashov <ever.zet@gmail.com>
+ */
+interface SpecificationLocator
+{
+    /**
+     * Returns array of strings representing examples of supported specification locators.
+     *
+     * @return string[]
+     */
+    public function getLocatorExamples();
+
+    /**
+     * Locates specifications and wraps them into iterator.
+     *
+     * @param Suite  $suite
+     * @param string $locator
+     *
+     * @return SpecificationIterator
+     */
+    public function locateSpecifications(Suite $suite, $locator);
+}