+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version Release: @package_version@
+ * @link http://pear.php.net/package/PHPUnit
+ * @since Class available since Release 1.0.0
+ */
+class PHPUnit_GUI_HTML
+{
+ var $_suites = array();
+
+ /**
+ * the current implementation of PHPUnit is designed
+ * this way that adding a suite to another suite only
+ * grabs all the tests and adds them to the suite, so you
+ * have no chance to find out which test goes with which suite
+ * therefore you can simply pass an array of suites to this constructor here
+ *
+ * @param array The suites to be tested. If not given, then you might
+ * be using the SetupDecorator, which detects them automatically
+ * when calling getSuitesFromDir()
+ */
+ function PHPUnit_GUI_HTML($suites = array())
+ {
+ if (!is_array($suites)) {
+ $this->_suites = array($suites);
+ } else {
+ $this->_suites = $suites;
+ }
+ }
+
+ /**
+ * Add suites to the GUI
+ *
+ * @param object this should be an instance of PHPUnit_TestSuite
+ */
+ function addSuites($suites)
+ {
+ $this->_suites = array_merge($this->_suites,$suites);
+ }
+
+ /**
+ * this prints the HTML code straight out
+ *
+ */
+ function show()
+ {
+ $request = $_REQUEST;
+ $showPassed = FALSE;
+ $submitted = @$request['submitted'];
+
+ if ($submitted) {
+ $showPassed = @$request['showOK'] ? TRUE : FALSE;
+ }
+
+ $suiteResults = array();
+
+ foreach ($this->_suites as $aSuite) {
+ $aSuiteResult = array();
+
+ // remove the first directory's name from the test-suite name, since it
+ // mostly is something like 'tests' or alike
+ $removablePrefix = explode('_',$aSuite->getName());
+ $aSuiteResult['name'] = str_replace($removablePrefix[0].'_', '', $aSuite->getName());
+
+ if ($submitted && isset($request[$aSuiteResult['name']])) {
+ $result = PHPUnit::run($aSuite);
+
+ $aSuiteResult['counts']['run'] = $result->runCount();
+ $aSuiteResult['counts']['error'] = $result->errorCount();
+ $aSuiteResult['counts']['failure'] = $result->failureCount();
+
+ $aSuiteResult['results'] = $this->_prepareResult($result,$showPassed);
+
+ $per = 100/$result->runCount();
+ $failed = ($per*$result->errorCount())+($per*$result->failureCount());
+ $aSuiteResult['percent'] = round(100-$failed,2);
+ } else {
+ $aSuiteResult['addInfo'] = 'NOT EXECUTED';
+ }
+
+ $suiteResults[] = $aSuiteResult;
+ }
+
+ $final['name'] = 'OVERALL RESULT';
+ $final['counts'] = array();
+ $final['percent'] = 0;
+ $numExecutedTests = 0;
+
+ foreach ($suiteResults as $aSuiteResult) {
+ if (sizeof(@$aSuiteResult['counts'])) {
+ foreach ($aSuiteResult['counts'] as $key=>$aCount) {
+ if (!isset($final['counts'][$key])) {
+ $final['counts'][$key] = 0;
+ }
+
+ $final['counts'][$key] += $aCount;
+ }
+ }
+ }
+
+ if (isset($final['counts']['run'])) {
+ $per = 100/$final['counts']['run'];
+ $failed = ($per*$final['counts']['error'])+($per*$final['counts']['failure']);
+ $final['percent'] = round(100-$failed,2);
+ } else {
+ $final['percent'] = 0;
+ }
+
+ array_unshift($suiteResults,$final);
+
+ include 'PHPUnit/GUI/HTML.tpl';
+ }
+
+ function _prepareResult($result,$showPassed)
+ {
+ $ret = array();
+ $failures = $result->failures();
+
+ foreach($failures as $aFailure) {
+ $ret['failures'][] = $this->_prepareFailure($aFailure);
+ }
+
+ $errors = $result->errors();
+
+ foreach($errors as $aError) {
+ $ret['errors'][] = $this->_prepareErrors($aError);
+ }
+
+ if ($showPassed) {
+ $passed = $result->passedTests();
+
+ foreach($passed as $aPassed) {
+ $ret['passed'][] = $this->_preparePassedTests($aPassed);
+ }
+ }
+
+ return $ret;
+ }
+
+ function _prepareFailure($failure)
+ {
+ $test = $failure->failedTest();
+ $ret['testName'] = $test->getName();
+ $exception = $failure->thrownException();
+
+ // a serialized string starts with a 'character:decimal:{'
+ // if so we try to unserialize it
+ // this piece of the regular expression is for detecting a serialized
+ // type like 'a:3:' for an array with three element or an object i.e. 'O:12:"class":3'
+ $serialized = '(\w:\d+:(?:"[^"]+":\d+:)?\{.*\})';
+
+ // Spaces might make a diff, so we shall show them properly (since a
+ // user agent ignores them).
+ if (preg_match('/^(.*)expected ' . $serialized . ', actual ' . $serialized . '$/sU', $exception, $matches)) {
+ ob_start();
+ print_r(unserialize($matches[2]));
+ $ret['expected'] = htmlspecialchars($matches[1]) . "" . htmlspecialchars(rtrim(ob_get_contents())) . "
";
+ // Improved compatibility, ob_clean() would be PHP >= 4.2.0 only.
+ ob_end_clean();
+
+ ob_start();
+ print_r(unserialize($matches[3]));
+ $ret['actual'] = htmlspecialchars($matches[1]) . "" . htmlspecialchars(rtrim(ob_get_contents())) . "
";
+ ob_end_clean();
+ }
+
+ else if (preg_match('/^(.*)expected (.*), actual (.*)$/sU', $exception, $matches)) {
+ $ret['expected'] = nl2br(str_replace(" ", " ", htmlspecialchars($matches[1] . $matches[2])));
+ $ret['actual'] = nl2br(str_replace(" ", " ", htmlspecialchars($matches[1] . $matches[3])));
+ } else {
+ $ret['message'] = nl2br(str_replace(" ", " ", htmlspecialchars($exception)));
+ }
+
+ return $ret;
+ }
+
+ function _preparePassedTests($passed)
+ {
+ $ret['testName'] = $passed->getName();
+ return $ret;
+ }
+
+ function _prepareError($error)
+ {
+ $ret['testName'] = $error->getName();
+ $ret['message'] = $error->toString();
+ return $ret;
+ }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>
diff --git a/src/tools/pear/src/PHPUnit/GUI/HTML.tpl b/src/tools/pear/src/PHPUnit/GUI/HTML.tpl
new file mode 100644
index 000000000..edf7f2539
--- /dev/null
+++ b/src/tools/pear/src/PHPUnit/GUI/HTML.tpl
@@ -0,0 +1,156 @@
+
+
+
+
+
+
+
+
+
+
+
diff --git a/src/tools/pear/src/PHPUnit/GUI/SetupDecorator.php b/src/tools/pear/src/PHPUnit/GUI/SetupDecorator.php
new file mode 100644
index 000000000..8c871fa43
--- /dev/null
+++ b/src/tools/pear/src/PHPUnit/GUI/SetupDecorator.php
@@ -0,0 +1,209 @@
+.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *
+ * * Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in
+ * the documentation and/or other materials provided with the
+ * distribution.
+ *
+ * * Neither the name of Sebastian Bergmann nor the names of his
+ * contributors may be used to endorse or promote products derived
+ * from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+ * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRIC
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Testing
+ * @package PHPUnit
+ * @author Wolfram Kriesing
+ * @copyright 2002-2005 Sebastian Bergmann
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version CVS: $Id: SetupDecorator.php,v 1.15 2005/11/10 09:47:15 sebastian Exp $
+ * @link http://pear.php.net/package/PHPUnit
+ * @since File available since Release 1.0.0
+ */
+
+/**
+ * This decorator actually just adds the functionality to read the
+ * test-suite classes from a given directory and instanciate them
+ * automatically, use it as given in the example below.
+ *
+ *
+ * getSuitesFromDir('/path/to/dir/tests','.*\.php$',array('index.php','sql.php'));
+ * $gui->show();
+ * ?>
+ *
+ *
+ * The example calls this class and tells it to:
+ *
+ * - find all file under the directory /path/to/dir/tests
+ * - for files, which end with '.php' (this is a piece of a regexp, that's why the . is escaped)
+ * - and to exclude the files 'index.php' and 'sql.php'
+ * - and include all the files that are left in the tests.
+ *
+ * Given that the path (the first parameter) ends with 'tests' it will be assumed
+ * that the classes are named tests_* where * is the directory plus the filename,
+ * according to PEAR standards.
+ *
+ * So that:
+ *
+ * - 'testMe.php' in the dir 'tests' bill be assumed to contain a class tests_testMe
+ * - '/moretests/aTest.php' should contain a class 'tests_moretests_aTest'
+ *
+ * @category Testing
+ * @package PHPUnit
+ * @author Wolfram Kriesing
+ * @copyright 2002-2005 Sebastian Bergmann
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version Release: @package_version@
+ * @link http://pear.php.net/package/PHPUnit
+ * @since Class available since Release 1.0.0
+ */
+class PHPUnit_GUI_SetupDecorator
+{
+ /**
+ *
+ *
+ */
+ function PHPUnit_GUI_SetupDecorator(&$gui)
+ {
+ $this->_gui = &$gui;
+ }
+
+ /**
+ * just forwarding the action to the decorated class.
+ *
+ */
+ function show($showPassed=TRUE)
+ {
+ $this->_gui->show($showPassed);
+ }
+
+ /**
+ * Setup test suites that can be found in the given directory
+ * Using the second parameter you can also choose a subsets of the files found
+ * in the given directory. I.e. only all the files that contain '_UnitTest_',
+ * in order to do this simply call it like this:
+ * getSuitesFromDir($dir,'.*_UnitTest_.*').
+ * There you can already see that the pattern is built for the use within a regular expression.
+ *
+ * @param string the directory where to search for test-suite files
+ * @param string the pattern (a regexp) by which to find the files
+ * @param array an array of file names that shall be excluded
+ */
+ function getSuitesFromDir($dir, $filenamePattern = '', $exclude = array())
+ {
+ if ($dir{strlen($dir)-1} == DIRECTORY_SEPARATOR) {
+ $dir = substr($dir, 0, -1);
+ }
+
+ $files = $this->_getFiles(realpath($dir), $filenamePattern, $exclude, realpath($dir . '/..'));
+ asort($files);
+
+ foreach ($files as $className => $aFile) {
+ include_once($aFile);
+
+ if (class_exists($className)) {
+ $suites[] =& new PHPUnit_TestSuite($className);
+ } else {
+ trigger_error("$className could not be found in $dir$aFile!");
+ }
+ }
+
+ $this->_gui->addSuites($suites);
+ }
+
+ /**
+ * This method searches recursively through the directories
+ * to find all the files that shall be added to the be visible.
+ *
+ * @param string the path where find the files
+ * @param srting the string pattern by which to find the files
+ * @param string the file names to be excluded
+ * @param string the root directory, which serves as the prefix to the fully qualified filename
+ * @access private
+ */
+ function _getFiles($dir, $filenamePattern, $exclude, $rootDir)
+ {
+ $files = array();
+
+ if ($dp = opendir($dir)) {
+ while (FALSE !== ($file = readdir($dp))) {
+ $filename = $dir . DIRECTORY_SEPARATOR . $file;
+ $match = TRUE;
+
+ if ($filenamePattern && !preg_match("~$filenamePattern~", $file)) {
+ $match = FALSE;
+ }
+
+ if (sizeof($exclude)) {
+ foreach ($exclude as $aExclude) {
+ if (strpos($file, $aExclude) !== FALSE) {
+ $match = FALSE;
+ break;
+ }
+ }
+ }
+
+ if (is_file($filename) && $match) {
+ $tmp = str_replace($rootDir, '', $filename);
+
+ if (strpos($tmp, DIRECTORY_SEPARATOR) === 0) {
+ $tmp = substr($tmp, 1);
+ }
+
+ if (strpos($tmp, '/') === 0) {
+ $tmp = substr($tmp, 1);
+ }
+
+ $className = str_replace(DIRECTORY_SEPARATOR, '_', $tmp);
+ $className = basename($className, '.php');
+
+ $files[$className] = $filename;
+ }
+
+ if ($file != '.' && $file != '..' && is_dir($filename)) {
+ $files = array_merge($files, $this->_getFiles($filename, $filenamePattern, $exclude, $rootDir));
+ }
+ }
+
+ closedir($dp);
+ }
+
+ return $files;
+ }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>
diff --git a/src/tools/pear/src/PHPUnit/RepeatedTest.php b/src/tools/pear/src/PHPUnit/RepeatedTest.php
new file mode 100644
index 000000000..e014eb5ae
--- /dev/null
+++ b/src/tools/pear/src/PHPUnit/RepeatedTest.php
@@ -0,0 +1,154 @@
+.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *
+ * * Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in
+ * the documentation and/or other materials provided with the
+ * distribution.
+ *
+ * * Neither the name of Sebastian Bergmann nor the names of his
+ * contributors may be used to endorse or promote products derived
+ * from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+ * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRIC
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Testing
+ * @package PHPUnit
+ * @author Sebastian Bergmann
+ * @copyright 2002-2005 Sebastian Bergmann
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version CVS: $Id: RepeatedTest.php,v 1.13 2005/11/10 09:47:14 sebastian Exp $
+ * @link http://pear.php.net/package/PHPUnit
+ * @since File available since Release 1.0.0
+ */
+
+require_once 'PHPUnit/TestDecorator.php';
+
+/**
+ * A Decorator that runs a test repeatedly.
+ *
+ * Here is an example:
+ *
+ *
+ * PHPUnit_TestCase($name);
+ * }
+ *
+ * function setUp() {
+ * $this->fValue1 = 2;
+ * $this->fValue2 = 3;
+ * }
+ *
+ * function testAdd() {
+ * $this->assertTrue($this->fValue1 + $this->fValue2 == 5);
+ * }
+ * }
+ *
+ * $suite = new PHPUnit_TestSuite;
+ *
+ * $suite->addTest(
+ * new PHPUnit_RepeatedTest(
+ * new MathTest('testAdd'),
+ * 10
+ * )
+ * );
+ *
+ * $result = PHPUnit::run($suite);
+ * print $result->toString();
+ * ?>
+ *
+ *
+ * @category Testing
+ * @package PHPUnit
+ * @author Sebastian Bergmann
+ * @copyright 2002-2005 Sebastian Bergmann
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version Release: @package_version@
+ * @link http://pear.php.net/package/PHPUnit
+ * @since Class available since Release 1.0.0
+ */
+class PHPUnit_RepeatedTest extends PHPUnit_TestDecorator {
+ /**
+ * @var integer
+ * @access private
+ */
+ var $_timesRepeat = 1;
+
+ /**
+ * Constructor.
+ *
+ * @param object
+ * @param integer
+ * @access public
+ */
+ function PHPUnit_RepeatedTest(&$test, $timesRepeat = 1) {
+ $this->PHPUnit_TestDecorator($test);
+ $this->_timesRepeat = $timesRepeat;
+ }
+
+ /**
+ * Counts the number of test cases that
+ * will be run by this test.
+ *
+ * @return integer
+ * @access public
+ */
+ function countTestCases() {
+ return $this->_timesRepeat * $this->_test->countTestCases();
+ }
+
+ /**
+ * Runs the decorated test and collects the
+ * result in a TestResult.
+ *
+ * @param object
+ * @access public
+ * @abstract
+ */
+ function run(&$result) {
+ for ($i = 0; $i < $this->_timesRepeat; $i++) {
+ $this->_test->run($result);
+ }
+ }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>
diff --git a/src/tools/pear/src/PHPUnit/Skeleton.php b/src/tools/pear/src/PHPUnit/Skeleton.php
new file mode 100644
index 000000000..e316373e0
--- /dev/null
+++ b/src/tools/pear/src/PHPUnit/Skeleton.php
@@ -0,0 +1,448 @@
+.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *
+ * * Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in
+ * the documentation and/or other materials provided with the
+ * distribution.
+ *
+ * * Neither the name of Sebastian Bergmann nor the names of his
+ * contributors may be used to endorse or promote products derived
+ * from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+ * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRIC
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Testing
+ * @package PHPUnit
+ * @author Scott Mattocks
+ * @copyright 2002-2005 Sebastian Bergmann
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version CVS: $Id: Skeleton.php,v 1.8 2005/11/10 09:47:14 sebastian Exp $
+ * @link http://pear.php.net/package/PHPUnit
+ * @since File available since Release 1.1.0
+ */
+
+/**
+ * Class for creating a PHPUnit_TestCase skeleton file.
+ *
+ * This class will take a classname as a parameter on construction and will
+ * create a PHP file that contains the skeleton of a PHPUnit_TestCase
+ * subclass. The test case will contain a test foreach method of the class.
+ * Methods of the parent class will, by default, be excluded from the test
+ * class. Passing and optional construction parameter will include them.
+ *
+ * Example
+ *
+ * createTestClass();
+ *
+ * // Write the new test class to file.
+ * // By default, code to run the test will be included.
+ * $ps->writeTestClass();
+ * ?>
+ *
+ * Now open the skeleton class and fill in the details.
+ * If you run the test as is, all tests will fail and
+ * you will see plenty of undefined constant errors.
+ *
+ * @category Testing
+ * @package PHPUnit
+ * @author Scott Mattocks
+ * @copyright 2002-2005 Sebastian Bergmann
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version Release: @package_version@
+ * @link http://pear.php.net/package/PHPUnit
+ * @since Class available since Release 1.1.0
+ */
+class PHPUnit_Skeleton {
+ /**
+ * Path to the class file to create a skeleton for.
+ * @var string
+ */
+ var $classPath;
+
+ /**
+ * The name of the class
+ * @var string
+ */
+ var $className;
+
+ /**
+ * Path to the configuration file needed by class to test.
+ * @var string
+ */
+ var $configFile;
+
+ /**
+ * Whether or not to include the methods of the parent class when testing.
+ * @var boolean
+ */
+ var $includeParents;
+
+ /**
+ * Whether or not to test private methods.
+ * @var boolean
+ */
+ var $includePrivate;
+
+ /**
+ * The test class that will be created.
+ * @var string
+ */
+ var $testClass;
+
+ /**
+ * Constructor. Sets the class members and check that the class
+ * to test is accessible.
+ *
+ * @access public
+ * @param string $className
+ * @param string $classPath
+ * @param boolean $includeParents Wheter to include the parent's methods in the test.
+ * @return void
+ */
+ function PHPUnit_Skeleton($className, $classPath, $includeParents = FALSE, $includePrivate = TRUE) {
+ // Set up the members.
+ if (@is_readable($classPath)) {
+ $this->className = $className;
+ $this->classPath = $classPath;
+ } else {
+ $this->_handleErrors($classPath . ' is not readable. Cannot create test class.');
+ }
+
+ // Do we want to include parent methods?
+ $this->includeParents = $includeParents;
+
+ // Do we want to allow private methods?
+ $this->includePrivate = $includePrivate;
+ }
+
+ /**
+ * The class to test may require a special config file before it can be
+ * instantiated. This method lets you set that file.
+ *
+ * @access public
+ * @param string $configPath
+ * @return void
+ */
+ function setConfigFile($configFile) {
+ // Check that the file is readable
+ if (@is_readable($configFile)) {
+ $this->configFile = $configFile;
+ } else {
+ $this->_handleErrors($configFile . ' is not readable. Cannot create test class.');
+ }
+ }
+
+ /**
+ * Create the code that will be the skeleton of the test case.
+ *
+ * The test case must have a clss definition, one var, a constructor
+ * setUp, tearDown, and methods. Optionally and by default the code
+ * to run the test is added when the class is written to file.
+ *
+ * @access public
+ * @param none
+ * @return void
+ */
+ function createTestClass() {
+ // Instantiate the object.
+ if (isset($this->configFile)) {
+ require_once $this->configFile;
+ }
+
+ require_once $this->classPath;
+
+ // Get the methods.
+ $classMethods = get_class_methods($this->className);
+
+ // Remove the parent methods if needed.
+ if (!$this->includeParents) {
+ $parentMethods = get_class_methods(get_parent_class($this->className));
+
+ if (count($parentMethods)) {
+ $classMethods = array_diff($classMethods, $parentMethods);
+ }
+ }
+
+ // Create the class definition, constructor, setUp and tearDown.
+ $this->_createDefinition();
+ $this->_createConstructor();
+ $this->_createSetUpTearDown();
+
+ if (count($classMethods)) {
+ // Foreach method create a test case.
+ foreach ($classMethods as $method) {
+ // Unless it is the constructor.
+ if (strcasecmp($this->className, $method) !== 0) {
+ // Check for private methods.
+ if (!$this->includePrivate && strpos($method, '_') === 0) {
+ continue;
+ } else {
+ $this->_createMethod($method);
+ }
+ }
+ }
+ }
+
+ // Finis off the class.
+ $this->_finishClass();
+ }
+
+ /**
+ * Create the class definition.
+ *
+ * The definition consist of a header comment, require statment
+ * for getting the PHPUnit file, the actual class definition,
+ * and the definition of the class member variable.
+ *
+ * All of the code needed for the new class is stored in the
+ * testClass member.
+ *
+ * @access private
+ * @param none
+ * @return void
+ */
+ function _createDefinition() {
+ // Create header comment.
+ $this->testClass =
+ "/**\n" .
+ " * PHPUnit test case for " . $this->className . "\n" .
+ " * \n" .
+ " * The method skeletons below need to be filled in with \n" .
+ " * real data so that the tests will run correctly. Replace \n" .
+ " * all EXPECTED_VAL and PARAM strings with real data. \n" .
+ " * \n" .
+ " * Created with PHPUnit_Skeleton on " . date('Y-m-d') . "\n" .
+ " */\n";
+
+ // Add the require statements.
+ $this->testClass .= "require_once 'PHPUnit.php';\n";
+
+ // Add the class definition and variable definition.
+ $this->testClass .=
+ "class " . $this->className . "Test extends PHPUnit_TestCase {\n\n" .
+ " var \$" . $this->className . ";\n\n";
+ }
+
+ /**
+ * Create the class constructor. (PHP4 style)
+ *
+ * The constructor simply calls the PHPUnit_TestCase method.
+ * This code is taken from the PHPUnit documentation.
+ *
+ * All of the code needed for the new class is stored in the
+ * testClass member.
+ *
+ * @access private
+ * @param none
+ * @return void
+ */
+ function _createConstructor() {
+ // Create the test class constructor.
+ $this->testClass.=
+ " function " . $this->className . "Test(\$name)\n" .
+ " {\n" .
+ " \$this->PHPUnit_TestCase(\$name);\n" .
+ " }\n\n";
+ }
+
+ /**
+ * Create setUp and tearDown methods.
+ *
+ * The setUp method creates the instance of the object to test.
+ * The tearDown method releases the instance.
+ * This code is taken from the PHPUnit documentation.
+ *
+ * All of the code needed for the new class is stored in the
+ * testClass member.
+ *
+ * @access private
+ * @param none
+ * @return void
+ */
+ function _createSetUpTearDown() {
+ // Create the setUp method.
+ $this->testClass .=
+ " function setUp()\n" .
+ " {\n";
+
+ if (isset($this->configFile)) {
+ $this->testClass .=
+ " require_once '" . $this->configFile . "';\n";
+ }
+
+ $this->testClass .=
+ " require_once '" . $this->classPath . "';\n" .
+ " \$this->" . $this->className . " =& new " . $this->className . "(PARAM);\n" .
+ " }\n\n";
+
+ // Create the tearDown method.
+ $this->testClass .=
+ " function tearDown()\n" .
+ " {\n" .
+ " unset(\$this->" . $this->className . ");\n" .
+ " }\n\n";
+ }
+
+ /**
+ * Create a basic skeleton for test methods.
+ *
+ * This code is taken from the PHPUnit documentation.
+ *
+ * All of the code needed for the new class is stored in the
+ * testClass member.
+ *
+ * @access private
+ * @param none
+ * @return void
+ */
+ function _createMethod($methodName) {
+ // Create a test method.
+ $this->testClass .=
+ " function test" . $methodName . "()\n" .
+ " {\n" .
+ " \$result = \$this->" . $this->className . "->" . $methodName . "(PARAM);\n" .
+ " \$expected = EXPECTED_VAL;\n" .
+ " \$this->assertEquals(\$expected, \$result);\n" .
+ " }\n\n";
+ }
+
+ /**
+ * Add the closing brace needed for a proper class definition.
+ *
+ * All of the code needed for the new class is stored in the
+ * testClass member.
+ *
+ * @access private
+ * @param none
+ * @return void
+ */
+ function _finishClass() {
+ // Close off the class.
+ $this->testClass.= "}\n";
+ }
+
+ /**
+ * Create the code that will actually run the test.
+ *
+ * This code is added by default so that the test can be run
+ * just by running the file. To have it not added pass false
+ * as the second parameter to the writeTestClass method.
+ * This code is taken from the PHPUnit documentation.
+ *
+ * All of the code needed for the new class is stored in the
+ * testClass member.
+ *
+ * @access private
+ * @param none
+ * @return void
+ */
+ function _createTest() {
+ // Create a call to the test.
+ $test =
+ "// Running the test.\n" .
+ "\$suite = new PHPUnit_TestSuite('" . $this->className . "Test');\n" .
+ "\$result = PHPUnit::run(\$suite);\n" .
+ "echo \$result->toString();\n";
+
+ return $test;
+ }
+
+ /**
+ * Write the test class to file.
+ *
+ * This will write the test class created using the createTestClass
+ * method to a file called Test.php. By default the file
+ * is written to the current directory and will have code to run
+ * the test appended to the bottom of the file.
+ *
+ * @access public
+ * @param string $destination The directory to write the file to.
+ * @param boolean $addTest Wheter to add the test running code.
+ * @return void
+ */
+ function writeTestClass($destination = './', $addTest = TRUE) {
+ // Check for something to write to file.
+ if (!isset($this->testClass)) {
+ $this->_handleErrors('Noting to write.', PHPUS_WARNING);
+ return;
+ }
+
+ // Open the destination file.
+ $fp = fopen($destination . $this->className . 'Test.php', 'w');
+ fwrite($fp, "testClass);
+
+ // Add the call to test the class in the file if we were asked to.
+ if ($addTest) {
+ fwrite($fp, $this->_createTest());
+ }
+
+ // Close the file.
+ fwrite($fp, "?>\n");
+ fclose($fp);
+ }
+
+ /**
+ * Error handler.
+ *
+ * This method should be rewritten to use the prefered error
+ * handling method. (PEAR_ErrorStack)
+ *
+ * @access private
+ * @param string $message The error message.
+ * @param integer $type An indication of the severity of the error.
+ * @return void Code may cause PHP to exit.
+ */
+ function _handleErrors($message, $type = E_USER_ERROR) {
+ // For now just echo the message.
+ echo $message;
+
+ // Check to see if we should quit.
+ if ($type == E_USER_ERROR) {
+ exit;
+ }
+ }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>
diff --git a/src/tools/pear/src/PHPUnit/TestCase.php b/src/tools/pear/src/PHPUnit/TestCase.php
new file mode 100644
index 000000000..78a23aa8c
--- /dev/null
+++ b/src/tools/pear/src/PHPUnit/TestCase.php
@@ -0,0 +1,293 @@
+.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *
+ * * Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in
+ * the documentation and/or other materials provided with the
+ * distribution.
+ *
+ * * Neither the name of Sebastian Bergmann nor the names of his
+ * contributors may be used to endorse or promote products derived
+ * from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+ * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRIC
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Testing
+ * @package PHPUnit
+ * @author Sebastian Bergmann
+ * @copyright 2002-2005 Sebastian Bergmann
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version CVS: $Id: TestCase.php,v 1.21 2005/11/10 09:47:14 sebastian Exp $
+ * @link http://pear.php.net/package/PHPUnit
+ * @since File available since Release 1.0.0
+ */
+
+require_once 'PHPUnit/Assert.php';
+require_once 'PHPUnit/TestResult.php';
+
+/**
+ * A TestCase defines the fixture to run multiple tests.
+ *
+ * To define a TestCase
+ *
+ * 1) Implement a subclass of PHPUnit_TestCase.
+ * 2) Define instance variables that store the state of the fixture.
+ * 3) Initialize the fixture state by overriding setUp().
+ * 4) Clean-up after a test by overriding tearDown().
+ *
+ * Each test runs in its own fixture so there can be no side effects
+ * among test runs.
+ *
+ * Here is an example:
+ *
+ *
+ * PHPUnit_TestCase($name);
+ * }
+ *
+ * function setUp() {
+ * $this->fValue1 = 2;
+ * $this->fValue2 = 3;
+ * }
+ * }
+ * ?>
+ *
+ *
+ * For each test implement a method which interacts with the fixture.
+ * Verify the expected results with assertions specified by calling
+ * assert with a boolean.
+ *
+ *
+ * assertTrue($this->fValue1 + $this->fValue2 == 5);
+ * }
+ * ?>
+ *
+ *
+ * @category Testing
+ * @package PHPUnit
+ * @author Sebastian Bergmann
+ * @copyright 2002-2005 Sebastian Bergmann
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version Release: @package_version@
+ * @link http://pear.php.net/package/PHPUnit
+ * @since Class available since Release 1.0.0
+ */
+class PHPUnit_TestCase extends PHPUnit_Assert {
+ /**
+ * @var boolean
+ * @access private
+ */
+ var $_failed = FALSE;
+
+ /**
+ * The name of the test case.
+ *
+ * @var string
+ * @access private
+ */
+ var $_name = '';
+
+ /**
+ * PHPUnit_TestResult object
+ *
+ * @var object
+ * @access private
+ */
+ var $_result;
+
+ /**
+ * Constructs a test case with the given name.
+ *
+ * @param string
+ * @access public
+ */
+ function PHPUnit_TestCase($name = FALSE) {
+ if ($name !== FALSE) {
+ $this->setName($name);
+ }
+ }
+
+ /**
+ * Counts the number of test cases executed by run(TestResult result).
+ *
+ * @return integer
+ * @access public
+ */
+ function countTestCases() {
+ return 1;
+ }
+
+ /**
+ * Gets the name of a TestCase.
+ *
+ * @return string
+ * @access public
+ */
+ function getName() {
+ return $this->_name;
+ }
+
+ /**
+ * Runs the test case and collects the results in a given TestResult object.
+ *
+ * @param object
+ * @return object
+ * @access public
+ */
+ function run(&$result) {
+ $this->_result = &$result;
+ $this->_result->run($this);
+
+ return $this->_result;
+ }
+
+ /**
+ * Runs the bare test sequence.
+ *
+ * @access public
+ */
+ function runBare() {
+ $this->setUp();
+ $this->runTest();
+ $this->tearDown();
+ $this->pass();
+ }
+
+ /**
+ * Override to run the test and assert its state.
+ *
+ * @access protected
+ */
+ function runTest() {
+ call_user_func(
+ array(
+ &$this,
+ $this->_name
+ )
+ );
+ }
+
+ /**
+ * Sets the name of a TestCase.
+ *
+ * @param string
+ * @access public
+ */
+ function setName($name) {
+ $this->_name = $name;
+ }
+
+ /**
+ * Returns a string representation of the test case.
+ *
+ * @return string
+ * @access public
+ */
+ function toString() {
+ return '';
+ }
+
+ /**
+ * Creates a default TestResult object.
+ *
+ * @return object
+ * @access protected
+ */
+ function &createResult() {
+ return new PHPUnit_TestResult;
+ }
+
+ /**
+ * Fails a test with the given message.
+ *
+ * @param string
+ * @access protected
+ */
+ function fail($message = '') {
+ if (function_exists('debug_backtrace')) {
+ $trace = debug_backtrace();
+
+ if (isset($trace['1']['file'])) {
+ $message = sprintf(
+ "%s in %s:%s",
+
+ $message,
+ $trace['1']['file'],
+ $trace['1']['line']
+ );
+ }
+ }
+
+ $this->_result->addFailure($this, $message);
+ $this->_failed = TRUE;
+ }
+
+ /**
+ * Passes a test.
+ *
+ * @access protected
+ */
+ function pass() {
+ if (!$this->_failed) {
+ $this->_result->addPassedTest($this);
+ }
+ }
+
+ /**
+ * Sets up the fixture, for example, open a network connection.
+ * This method is called before a test is executed.
+ *
+ * @access protected
+ * @abstract
+ */
+ function setUp() { /* abstract */ }
+
+ /**
+ * Tears down the fixture, for example, close a network connection.
+ * This method is called after a test is executed.
+ *
+ * @access protected
+ * @abstract
+ */
+ function tearDown() { /* abstract */ }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>
diff --git a/src/tools/pear/src/PHPUnit/TestDecorator.php b/src/tools/pear/src/PHPUnit/TestDecorator.php
new file mode 100644
index 000000000..41332103c
--- /dev/null
+++ b/src/tools/pear/src/PHPUnit/TestDecorator.php
@@ -0,0 +1,156 @@
+.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *
+ * * Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in
+ * the documentation and/or other materials provided with the
+ * distribution.
+ *
+ * * Neither the name of Sebastian Bergmann nor the names of his
+ * contributors may be used to endorse or promote products derived
+ * from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+ * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRIC
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Testing
+ * @package PHPUnit
+ * @author Sebastian Bergmann
+ * @copyright 2002-2005 Sebastian Bergmann
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version CVS: $Id: TestDecorator.php,v 1.17 2005/11/10 09:47:14 sebastian Exp $
+ * @link http://pear.php.net/package/PHPUnit
+ * @since File available since Release 1.0.0
+ */
+
+require_once 'PHPUnit/TestCase.php';
+require_once 'PHPUnit/TestSuite.php';
+
+if (!function_exists('is_a')) {
+ require_once 'PHP/Compat/Function/is_a.php';
+}
+
+/**
+ * A Decorator for Tests.
+ *
+ * Use TestDecorator as the base class for defining new
+ * test decorators. Test decorator subclasses can be introduced
+ * to add behaviour before or after a test is run.
+ *
+ * @category Testing
+ * @package PHPUnit
+ * @author Sebastian Bergmann
+ * @copyright 2002-2005 Sebastian Bergmann
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version Release: @package_version@
+ * @link http://pear.php.net/package/PHPUnit
+ * @since Class available since Release 1.0.0
+ */
+class PHPUnit_TestDecorator {
+ /**
+ * The Test to be decorated.
+ *
+ * @var object
+ * @access protected
+ */
+ var $_test = NULL;
+
+ /**
+ * Constructor.
+ *
+ * @param object
+ * @access public
+ */
+ function PHPUnit_TestDecorator(&$test) {
+ if (is_object($test) &&
+ (is_a($test, 'PHPUnit_TestCase') ||
+ is_a($test, 'PHPUnit_TestSuite'))) {
+
+ $this->_test = &$test;
+ }
+ }
+
+ /**
+ * Runs the test and collects the
+ * result in a TestResult.
+ *
+ * @param object
+ * @access public
+ */
+ function basicRun(&$result) {
+ $this->_test->run($result);
+ }
+
+ /**
+ * Counts the number of test cases that
+ * will be run by this test.
+ *
+ * @return integer
+ * @access public
+ */
+ function countTestCases() {
+ return $this->_test->countTestCases();
+ }
+
+ /**
+ * Returns the test to be run.
+ *
+ * @return object
+ * @access public
+ */
+ function &getTest() {
+ return $this->_test;
+ }
+
+ /**
+ * Runs the decorated test and collects the
+ * result in a TestResult.
+ *
+ * @param object
+ * @access public
+ * @abstract
+ */
+ function run(&$result) { /* abstract */ }
+
+ /**
+ * Returns a string representation of the test.
+ *
+ * @return string
+ * @access public
+ */
+ function toString() {
+ return $this->_test->toString();
+ }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>
diff --git a/src/tools/pear/src/PHPUnit/TestFailure.php b/src/tools/pear/src/PHPUnit/TestFailure.php
new file mode 100644
index 000000000..7839e4465
--- /dev/null
+++ b/src/tools/pear/src/PHPUnit/TestFailure.php
@@ -0,0 +1,130 @@
+.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *
+ * * Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in
+ * the documentation and/or other materials provided with the
+ * distribution.
+ *
+ * * Neither the name of Sebastian Bergmann nor the names of his
+ * contributors may be used to endorse or promote products derived
+ * from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+ * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRIC
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Testing
+ * @package PHPUnit
+ * @author Sebastian Bergmann
+ * @copyright 2002-2005 Sebastian Bergmann
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version CVS: $Id: TestFailure.php,v 1.13 2005/11/10 09:47:14 sebastian Exp $
+ * @link http://pear.php.net/package/PHPUnit
+ * @since File available since Release 1.0.0
+ */
+
+/**
+ * A TestFailure collects a failed test together with the caught exception.
+ *
+ * @category Testing
+ * @package PHPUnit
+ * @author Sebastian Bergmann
+ * @copyright 2002-2005 Sebastian Bergmann
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version Release: @package_version@
+ * @link http://pear.php.net/package/PHPUnit
+ * @since Class available since Release 1.0.0
+ */
+class PHPUnit_TestFailure {
+ /**
+ * @var object
+ * @access private
+ */
+ var $_failedTest;
+
+ /**
+ * @var string
+ * @access private
+ */
+ var $_thrownException;
+
+ /**
+ * Constructs a TestFailure with the given test and exception.
+ *
+ * @param object
+ * @param string
+ * @access public
+ */
+ function PHPUnit_TestFailure(&$failedTest, &$thrownException) {
+ $this->_failedTest = &$failedTest;
+ $this->_thrownException = &$thrownException;
+ }
+
+ /**
+ * Gets the failed test.
+ *
+ * @return object
+ * @access public
+ */
+ function &failedTest() {
+ return $this->_failedTest;
+ }
+
+ /**
+ * Gets the thrown exception.
+ *
+ * @return object
+ * @access public
+ */
+ function &thrownException() {
+ return $this->_thrownException;
+ }
+
+ /**
+ * Returns a short description of the failure.
+ *
+ * @return string
+ * @access public
+ */
+ function toString() {
+ return sprintf(
+ "TestCase %s->%s() failed: %s\n",
+
+ get_class($this->_failedTest),
+ $this->_failedTest->getName(),
+ $this->_thrownException
+ );
+ }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>
diff --git a/src/tools/pear/src/PHPUnit/TestListener.php b/src/tools/pear/src/PHPUnit/TestListener.php
new file mode 100644
index 000000000..9cff52cb2
--- /dev/null
+++ b/src/tools/pear/src/PHPUnit/TestListener.php
@@ -0,0 +1,162 @@
+.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *
+ * * Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in
+ * the documentation and/or other materials provided with the
+ * distribution.
+ *
+ * * Neither the name of Sebastian Bergmann nor the names of his
+ * contributors may be used to endorse or promote products derived
+ * from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+ * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRIC
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Testing
+ * @package PHPUnit
+ * @author Sebastian Bergmann
+ * @copyright 2002-2005 Sebastian Bergmann
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version CVS: $Id: TestListener.php,v 1.12 2005/11/10 09:47:15 sebastian Exp $
+ * @link http://pear.php.net/package/PHPUnit
+ * @since File available since Release 1.0.0
+ */
+
+/**
+ * A Listener for test progress.
+ *
+ * Here is an example:
+ *
+ *
+ * PHPUnit_TestCase($name);
+ * }
+ *
+ * function setUp() {
+ * $this->fValue1 = 2;
+ * $this->fValue2 = 3;
+ * }
+ *
+ * function testAdd() {
+ * $this->assertTrue($this->fValue1 + $this->fValue2 == 4);
+ * }
+ * }
+ *
+ * class MyListener extends PHPUnit_TestListener {
+ * function addError(&$test, &$t) {
+ * print "MyListener::addError() called.\n";
+ * }
+ *
+ * function addFailure(&$test, &$t) {
+ * print "MyListener::addFailure() called.\n";
+ * }
+ *
+ * function endTest(&$test) {
+ * print "MyListener::endTest() called.\n";
+ * }
+ *
+ * function startTest(&$test) {
+ * print "MyListener::startTest() called.\n";
+ * }
+ * }
+ *
+ * $suite = new PHPUnit_TestSuite;
+ * $suite->addTest(new MathTest('testAdd'));
+ *
+ * $result = new PHPUnit_TestResult;
+ * $result->addListener(new MyListener);
+ *
+ * $suite->run($result);
+ * print $result->toString();
+ * ?>
+ *
+ *
+ * @category Testing
+ * @package PHPUnit
+ * @author Sebastian Bergmann
+ * @copyright 2002-2005 Sebastian Bergmann
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version Release: @package_version@
+ * @link http://pear.php.net/package/PHPUnit
+ * @since Class available since Release 1.0.0
+ */
+class PHPUnit_TestListener {
+ /**
+ * An error occurred.
+ *
+ * @param object
+ * @param object
+ * @access public
+ * @abstract
+ */
+ function addError(&$test, &$t) { /*abstract */ }
+
+ /**
+ * A failure occurred.
+ *
+ * @param object
+ * @param object
+ * @access public
+ * @abstract
+ */
+ function addFailure(&$test, &$t) { /*abstract */ }
+
+ /**
+ * A test ended.
+ *
+ * @param object
+ * @access public
+ * @abstract
+ */
+ function endTest(&$test) { /*abstract */ }
+
+ /**
+ * A test started.
+ *
+ * @param object
+ * @access public
+ * @abstract
+ */
+ function startTest(&$test) { /*abstract */ }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>
diff --git a/src/tools/pear/src/PHPUnit/TestResult.php b/src/tools/pear/src/PHPUnit/TestResult.php
new file mode 100644
index 000000000..eb42121e1
--- /dev/null
+++ b/src/tools/pear/src/PHPUnit/TestResult.php
@@ -0,0 +1,347 @@
+.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *
+ * * Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in
+ * the documentation and/or other materials provided with the
+ * distribution.
+ *
+ * * Neither the name of Sebastian Bergmann nor the names of his
+ * contributors may be used to endorse or promote products derived
+ * from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+ * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRIC
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Testing
+ * @package PHPUnit
+ * @author Sebastian Bergmann
+ * @copyright 2002-2005 Sebastian Bergmann
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version CVS: $Id: TestResult.php,v 1.18 2005/11/10 09:47:15 sebastian Exp $
+ * @link http://pear.php.net/package/PHPUnit
+ * @since File available since Release 1.0.0
+ */
+
+require_once 'PHPUnit/TestFailure.php';
+require_once 'PHPUnit/TestListener.php';
+
+if (!function_exists('is_a')) {
+ require_once 'PHP/Compat/Function/is_a.php';
+}
+
+/**
+ * A TestResult collects the results of executing a test case.
+ *
+ * @category Testing
+ * @package PHPUnit
+ * @author Sebastian Bergmann
+ * @copyright 2002-2005 Sebastian Bergmann
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version Release: @package_version@
+ * @link http://pear.php.net/package/PHPUnit
+ * @since Class available since Release 1.0.0
+ */
+class PHPUnit_TestResult {
+ /**
+ * @var array
+ * @access protected
+ */
+ var $_errors = array();
+
+ /**
+ * @var array
+ * @access protected
+ */
+ var $_failures = array();
+
+ /**
+ * @var array
+ * @access protected
+ */
+ var $_listeners = array();
+
+ /**
+ * @var array
+ * @access protected
+ */
+ var $_passedTests = array();
+
+ /**
+ * @var integer
+ * @access protected
+ */
+ var $_runTests = 0;
+
+ /**
+ * @var boolean
+ * @access private
+ */
+ var $_stop = FALSE;
+
+ /**
+ * Adds an error to the list of errors.
+ * The passed in exception caused the error.
+ *
+ * @param object
+ * @param object
+ * @access public
+ */
+ function addError(&$test, &$t) {
+ $this->_errors[] = new PHPUnit_TestFailure($test, $t);
+
+ for ($i = 0; $i < sizeof($this->_listeners); $i++) {
+ $this->_listeners[$i]->addError($test, $t);
+ }
+ }
+
+ /**
+ * Adds a failure to the list of failures.
+ * The passed in exception caused the failure.
+ *
+ * @param object
+ * @param object
+ * @access public
+ */
+ function addFailure(&$test, &$t) {
+ $this->_failures[] = new PHPUnit_TestFailure($test, $t);
+
+ for ($i = 0; $i < sizeof($this->_listeners); $i++) {
+ $this->_listeners[$i]->addFailure($test, $t);
+ }
+ }
+
+ /**
+ * Registers a TestListener.
+ *
+ * @param object
+ * @access public
+ */
+ function addListener(&$listener) {
+ if (is_object($listener) &&
+ is_a($listener, 'PHPUnit_TestListener')) {
+ $this->_listeners[] = &$listener;
+ }
+ }
+
+ /**
+ * Adds a passed test to the list of passed tests.
+ *
+ * @param object
+ * @access public
+ */
+ function addPassedTest(&$test) {
+ $this->_passedTests[] = &$test;
+ }
+
+ /**
+ * Informs the result that a test was completed.
+ *
+ * @param object
+ * @access public
+ */
+ function endTest(&$test) {
+ for ($i = 0; $i < sizeof($this->_listeners); $i++) {
+ $this->_listeners[$i]->endTest($test);
+ }
+ }
+
+ /**
+ * Gets the number of detected errors.
+ *
+ * @return integer
+ * @access public
+ */
+ function errorCount() {
+ return sizeof($this->_errors);
+ }
+
+ /**
+ * Returns an Enumeration for the errors.
+ *
+ * @return array
+ * @access public
+ */
+ function &errors() {
+ return $this->_errors;
+ }
+
+ /**
+ * Gets the number of detected failures.
+ *
+ * @return integer
+ * @access public
+ */
+ function failureCount() {
+ return sizeof($this->_failures);
+ }
+
+ /**
+ * Returns an Enumeration for the failures.
+ *
+ * @return array
+ * @access public
+ */
+ function &failures() {
+ return $this->_failures;
+ }
+
+ /**
+ * Returns an Enumeration for the passed tests.
+ *
+ * @return array
+ * @access public
+ */
+ function &passedTests() {
+ return $this->_passedTests;
+ }
+
+ /**
+ * Unregisters a TestListener.
+ * This requires the Zend Engine 2 (to work properly).
+ *
+ * @param object
+ * @access public
+ */
+ function removeListener(&$listener) {
+ for ($i = 0; $i < sizeof($this->_listeners); $i++) {
+ if ($this->_listeners[$i] === $listener) {
+ unset($this->_listeners[$i]);
+ }
+ }
+ }
+
+ /**
+ * Runs a TestCase.
+ *
+ * @param object
+ * @access public
+ */
+ function run(&$test) {
+ $this->startTest($test);
+ $this->_runTests++;
+ $test->runBare();
+ $this->endTest($test);
+ }
+
+ /**
+ * Gets the number of run tests.
+ *
+ * @return integer
+ * @access public
+ */
+ function runCount() {
+ return $this->_runTests;
+ }
+
+ /**
+ * Checks whether the test run should stop.
+ *
+ * @access public
+ */
+ function shouldStop() {
+ return $this->_stop;
+ }
+
+ /**
+ * Informs the result that a test will be started.
+ *
+ * @param object
+ * @access public
+ */
+ function startTest(&$test) {
+ for ($i = 0; $i < sizeof($this->_listeners); $i++) {
+ $this->_listeners[$i]->startTest($test);
+ }
+ }
+
+ /**
+ * Marks that the test run should stop.
+ *
+ * @access public
+ */
+ function stop() {
+ $this->_stop = TRUE;
+ }
+
+ /**
+ * Returns a HTML representation of the test result.
+ *
+ * @return string
+ * @access public
+ */
+ function toHTML() {
+ return '' . htmlspecialchars($this->toString()) . '
';
+ }
+
+ /**
+ * Returns a text representation of the test result.
+ *
+ * @return string
+ * @access public
+ */
+ function toString() {
+ $result = '';
+
+ foreach ($this->_passedTests as $passedTest) {
+ $result .= sprintf(
+ "TestCase %s->%s() passed\n",
+
+ get_class($passedTest),
+ $passedTest->getName()
+ );
+ }
+
+ foreach ($this->_failures as $failedTest) {
+ $result .= $failedTest->toString();
+ }
+
+ return $result;
+ }
+
+ /**
+ * Returns whether the entire test was successful or not.
+ *
+ * @return boolean
+ * @access public
+ */
+ function wasSuccessful() {
+ if (empty($this->_errors) && empty($this->_failures)) {
+ return TRUE;
+ } else {
+ return FALSE;
+ }
+ }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>
diff --git a/src/tools/pear/src/PHPUnit/TestSuite.php b/src/tools/pear/src/PHPUnit/TestSuite.php
new file mode 100644
index 000000000..c0e069eec
--- /dev/null
+++ b/src/tools/pear/src/PHPUnit/TestSuite.php
@@ -0,0 +1,262 @@
+.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *
+ * * Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in
+ * the documentation and/or other materials provided with the
+ * distribution.
+ *
+ * * Neither the name of Sebastian Bergmann nor the names of his
+ * contributors may be used to endorse or promote products derived
+ * from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+ * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRIC
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Testing
+ * @package PHPUnit
+ * @author Sebastian Bergmann
+ * @copyright 2002-2005 Sebastian Bergmann
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version CVS: $Id: TestSuite.php,v 1.17 2005/11/10 09:47:15 sebastian Exp $
+ * @link http://pear.php.net/package/PHPUnit
+ * @since File available since Release 1.0.0
+ */
+
+require_once 'PHPUnit/TestCase.php';
+
+/**
+ * A TestSuite is a Composite of Tests. It runs a collection of test cases.
+ *
+ * Here is an example using the dynamic test definition.
+ *
+ *
+ * addTest(new MathTest('testPass'));
+ * ?>
+ *
+ *
+ * Alternatively, a TestSuite can extract the tests to be run automatically.
+ * To do so you pass the classname of your TestCase class to the TestSuite
+ * constructor.
+ *
+ *
+ *
+ *
+ *
+ * This constructor creates a suite with all the methods starting with
+ * "test" that take no arguments.
+ *
+ * @category Testing
+ * @package PHPUnit
+ * @author Sebastian Bergmann
+ * @copyright 2002-2005 Sebastian Bergmann
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @version Release: @package_version@
+ * @link http://pear.php.net/package/PHPUnit
+ * @since Class available since Release 1.0.0
+ */
+class PHPUnit_TestSuite {
+ /**
+ * The name of the test suite.
+ *
+ * @var string
+ * @access private
+ */
+ var $_name = '';
+
+ /**
+ * The tests in the test suite.
+ *
+ * @var array
+ * @access private
+ */
+ var $_tests = array();
+
+ /**
+ * Constructs a TestSuite.
+ *
+ * @param mixed
+ * @access public
+ */
+ function PHPUnit_TestSuite($test = FALSE) {
+ if ($test !== FALSE) {
+ $this->setName($test);
+ $this->addTestSuite($test);
+ }
+ }
+
+ /**
+ * Adds a test to the suite.
+ *
+ * @param object
+ * @access public
+ */
+ function addTest(&$test) {
+ $this->_tests[] = &$test;
+ }
+
+ /**
+ * Adds the tests from the given class to the suite.
+ *
+ * @param string
+ * @access public
+ */
+ function addTestSuite($testClass) {
+ if (class_exists($testClass)) {
+ $methods = get_class_methods($testClass);
+ $parentClasses = array(strtolower($testClass));
+ $parentClass = $testClass;
+
+ while(is_string($parentClass = get_parent_class($parentClass))) {
+ $parentClasses[] = $parentClass;
+ }
+
+ foreach ($methods as $method) {
+ if (substr($method, 0, 4) == 'test' &&
+ !in_array($method, $parentClasses)) {
+ $this->addTest(new $testClass($method));
+ }
+ }
+ }
+ }
+
+ /**
+ * Counts the number of test cases that will be run by this test.
+ *
+ * @return integer
+ * @access public
+ */
+ function countTestCases() {
+ $count = 0;
+
+ foreach ($this->_tests as $test) {
+ $count += $test->countTestCases();
+ }
+
+ return $count;
+ }
+
+ /**
+ * Returns the name of the suite.
+ *
+ * @return string
+ * @access public
+ */
+ function getName() {
+ return $this->_name;
+ }
+
+ /**
+ * Runs the tests and collects their result in a TestResult.
+ *
+ * @param object
+ * @access public
+ */
+ function run(&$result) {
+ for ($i = 0; $i < sizeof($this->_tests) && !$result->shouldStop(); $i++) {
+ $this->_tests[$i]->run($result);
+ }
+ }
+
+ /**
+ * Runs a test.
+ *
+ * @param object
+ * @param object
+ * @access public
+ */
+ function runTest(&$test, &$result) {
+ $test->run($result);
+ }
+
+ /**
+ * Sets the name of the suite.
+ *
+ * @param string
+ * @access public
+ */
+ function setName($name) {
+ $this->_name = $name;
+ }
+
+ /**
+ * Returns the test at the given index.
+ *
+ * @param integer
+ * @return object
+ * @access public
+ */
+ function &testAt($index) {
+ if (isset($this->_tests[$index])) {
+ return $this->_tests[$index];
+ } else {
+ return FALSE;
+ }
+ }
+
+ /**
+ * Returns the number of tests in this suite.
+ *
+ * @return integer
+ * @access public
+ */
+ function testCount() {
+ return sizeof($this->_tests);
+ }
+
+ /**
+ * Returns the tests as an enumeration.
+ *
+ * @return array
+ * @access public
+ */
+ function &tests() {
+ return $this->_tests;
+ }
+
+ /**
+ * Returns a string representation of the test suite.
+ *
+ * @return string
+ * @access public
+ */
+ function toString() {
+ return '';
+ }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>
diff --git a/src/tools/pear/src/VERSIONS.txt b/src/tools/pear/src/VERSIONS.txt
index d787e3e6b..175e400e2 100644
--- a/src/tools/pear/src/VERSIONS.txt
+++ b/src/tools/pear/src/VERSIONS.txt
@@ -1,4 +1,5 @@
Last updated:
+ - 2010-09-13: PHPUnit added
- 2010-08-17: Updated everything to latest version
- 2007-02-13: Update DB from 1.7.6 to 1.7.9
@@ -16,3 +17,4 @@ Last updated:
* XML_RPC-1.5.4
* XML_Serializer-0.20.0(beta)
* XML_Util-1.2.1
+* PHPUnit 1.3.2