5 * Copyright (c) 2002-2009, Sebastian Bergmann <sb@sebastian-bergmann.de>.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
12 * * Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
15 * * Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in
17 * the documentation and/or other materials provided with the
20 * * Neither the name of Sebastian Bergmann nor the names of his
21 * contributors may be used to endorse or promote products derived
22 * from this software without specific prior written permission.
24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
25 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
26 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
27 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
28 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
29 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
30 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
31 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
32 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
33 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
34 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35 * POSSIBILITY OF SUCH DAMAGE.
39 * @author Sebastian Bergmann <sb@sebastian-bergmann.de>
40 * @copyright 2002-2009 Sebastian Bergmann <sb@sebastian-bergmann.de>
41 * @license http://www.opensource.org/licenses/bsd-license.php BSD License
43 * @link http://www.phpunit.de/
44 * @since File available since Release 2.1.0
47 require_once 'PHPUnit/Util/Filter.php';
48 require_once 'PHPUnit/Runner/TestCollector.php';
49 require_once 'PHPUnit/Util/FilterIterator.php';
51 PHPUnit_Util_Filter::addFileToFilter(__FILE__, 'PHPUNIT');
54 * A test collector that collects tests from one or more directories
55 * recursively. If no directories are specified, the include_path is searched.
58 * $testCollector = new PHPUnit_Runner_IncludePathTestCollector(
59 * array('/path/to/*Test.php files')
62 * $suite = new PHPUnit_Framework_TestSuite('My Test Suite');
63 * $suite->addTestFiles($testCollector->collectTests());
68 * @author Sebastian Bergmann <sb@sebastian-bergmann.de>
69 * @copyright 2002-2009 Sebastian Bergmann <sb@sebastian-bergmann.de>
70 * @license http://www.opensource.org/licenses/bsd-license.php BSD License
71 * @version Release: 3.3.17
72 * @link http://www.phpunit.de/
73 * @since Class available since Release 2.1.0
75 class PHPUnit_Runner_IncludePathTestCollector implements PHPUnit_Runner_TestCollector
80 protected $filterIterator;
94 * @param string $suffix
96 public function __construct(array $paths = array(), $suffix = 'Test.php')
99 $this->paths = $paths;
101 $this->paths = explode(PATH_SEPARATOR, get_include_path());
104 $this->suffix = $suffix;
110 public function collectTests()
112 $pathIterator = new AppendIterator;
115 foreach ($this->paths as $path) {
116 $pathIterator->append(
117 new RecursiveIteratorIterator(
118 new RecursiveDirectoryIterator($path)
123 $filterIterator = new PHPUnit_Util_FilterIterator(
124 $pathIterator, $this->suffix
127 if ($this->filterIterator !== NULL) {
128 $class = new ReflectionClass($this->filterIterator);
129 $filterIterator = $class->newInstance($filterIterator);
132 return $filterIterator;
136 * Adds a FilterIterator to filter the source files to be collected.
138 * @param string $filterIterator
139 * @throws InvalidArgumentException
141 public function setFilterIterator($filterIterator)
143 if (is_string($filterIterator) && class_exists($filterIterator)) {
145 $class = new ReflectionClass($filterIterator);
147 if ($class->isSubclassOf('FilterIterator')) {
148 $this->filterIterator = $filterIterator;
152 catch (ReflectionException $e) {
153 throw new InvalidArgumentException;
156 throw new InvalidArgumentException;