122 lines
3.6 KiB
PHP
122 lines
3.6 KiB
PHP
<?php
|
|
/**
|
|
* This file contains the following classes: {@link SimpleCollector},
|
|
* {@link SimplePatternCollector}.
|
|
*
|
|
* @author Travis Swicegood <development@domain51.com>
|
|
* @package SimpleTest
|
|
* @subpackage UnitTester
|
|
* @version $Id: collector.php 2011 2011-04-29 08:22:48Z pp11 $
|
|
*/
|
|
|
|
/**
|
|
* The basic collector for {@link GroupTest}
|
|
*
|
|
* @see collect(), GroupTest::collect()
|
|
* @package SimpleTest
|
|
* @subpackage UnitTester
|
|
*/
|
|
class SimpleCollector {
|
|
|
|
/**
|
|
* Strips off any kind of slash at the end so as to normalise the path.
|
|
* @param string $path Path to normalise.
|
|
* @return string Path without trailing slash.
|
|
*/
|
|
protected function removeTrailingSlash($path) {
|
|
if (substr($path, -1) == DIRECTORY_SEPARATOR) {
|
|
return substr($path, 0, -1);
|
|
} elseif (substr($path, -1) == '/') {
|
|
return substr($path, 0, -1);
|
|
} else {
|
|
return $path;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Scans the directory and adds what it can.
|
|
* @param object $test Group test with {@link GroupTest::addTestFile()} method.
|
|
* @param string $path Directory to scan.
|
|
* @see _attemptToAdd()
|
|
*/
|
|
function collect(&$test, $path) {
|
|
$path = $this->removeTrailingSlash($path);
|
|
if ($handle = opendir($path)) {
|
|
while (($entry = readdir($handle)) !== false) {
|
|
if ($this->isHidden($entry)) {
|
|
continue;
|
|
}
|
|
$this->handle($test, $path . DIRECTORY_SEPARATOR . $entry);
|
|
}
|
|
closedir($handle);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* This method determines what should be done with a given file and adds
|
|
* it via {@link GroupTest::addTestFile()} if necessary.
|
|
*
|
|
* This method should be overriden to provide custom matching criteria,
|
|
* such as pattern matching, recursive matching, etc. For an example, see
|
|
* {@link SimplePatternCollector::_handle()}.
|
|
*
|
|
* @param object $test Group test with {@link GroupTest::addTestFile()} method.
|
|
* @param string $filename A filename as generated by {@link collect()}
|
|
* @see collect()
|
|
* @access protected
|
|
*/
|
|
protected function handle(&$test, $file) {
|
|
if (is_dir($file)) {
|
|
return;
|
|
}
|
|
$test->addFile($file);
|
|
}
|
|
|
|
/**
|
|
* Tests for hidden files so as to skip them. Currently
|
|
* only tests for Unix hidden files.
|
|
* @param string $filename Plain filename.
|
|
* @return boolean True if hidden file.
|
|
* @access private
|
|
*/
|
|
protected function isHidden($filename) {
|
|
return strncmp($filename, '.', 1) == 0;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* An extension to {@link SimpleCollector} that only adds files matching a
|
|
* given pattern.
|
|
*
|
|
* @package SimpleTest
|
|
* @subpackage UnitTester
|
|
* @see SimpleCollector
|
|
*/
|
|
class SimplePatternCollector extends SimpleCollector {
|
|
private $pattern;
|
|
|
|
/**
|
|
*
|
|
* @param string $pattern Perl compatible regex to test name against
|
|
* See {@link http://us4.php.net/manual/en/reference.pcre.pattern.syntax.php PHP's PCRE}
|
|
* for full documentation of valid pattern.s
|
|
*/
|
|
function __construct($pattern = '/php$/i') {
|
|
$this->pattern = $pattern;
|
|
}
|
|
|
|
/**
|
|
* Attempts to add files that match a given pattern.
|
|
*
|
|
* @see SimpleCollector::_handle()
|
|
* @param object $test Group test with {@link GroupTest::addTestFile()} method.
|
|
* @param string $path Directory to scan.
|
|
* @access protected
|
|
*/
|
|
protected function handle(&$test, $filename) {
|
|
if (preg_match($this->pattern, $filename)) {
|
|
parent::handle($test, $filename);
|
|
}
|
|
}
|
|
}
|
|
?>
|