Subversion Repositories SmartDukaan

Rev

Blame | Last modification | View Log | RSS feed

<?php
/**
 * CakeTestSuiteDispatcher controls dispatching TestSuite web based requests.
 *
 * CakePHP(tm) Tests <http://book.cakephp.org/2.0/en/development/testing.html>
 * Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
 *
 * Licensed under The MIT License
 * For full copyright and license information, please see the LICENSE.txt
 * Redistributions of files must retain the above copyright notice
 *
 * @copyright     Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
 * @link          http://cakephp.org CakePHP(tm) Project
 * @package       Cake.TestSuite
 * @since         CakePHP(tm) v 1.3
 * @license       http://www.opensource.org/licenses/mit-license.php MIT License
 */

define('CORE_TEST_CASES', CAKE . 'Test' . DS . 'Case');
define('APP_TEST_CASES', TESTS . 'Case');

App::uses('CakeTestSuiteCommand', 'TestSuite');

/**
 * CakeTestSuiteDispatcher handles web requests to the test suite and runs the correct action.
 *
 * @package       Cake.TestSuite
 */
class CakeTestSuiteDispatcher {

/**
 * 'Request' parameters
 *
 * @var array
 */
        public $params = array(
                'codeCoverage' => false,
                'case' => null,
                'core' => false,
                'app' => true,
                'plugin' => null,
                'output' => 'html',
                'show' => 'groups',
                'show_passes' => false,
                'filter' => false,
                'fixture' => null
        );

/**
 * Baseurl for the request
 *
 * @var string
 */
        protected $_baseUrl;

/**
 * Base dir of the request. Used for accessing assets.
 *
 * @var string
 */
        protected $_baseDir;

/**
 * boolean to set auto parsing of params.
 *
 * @var boolean
 */
        protected $_paramsParsed = false;

/**
 * reporter instance used for the request
 *
 * @var CakeBaseReporter
 */
        protected static $_Reporter = null;

/**
 * Constructor
 */
        public function __construct() {
                $this->_baseUrl = $_SERVER['PHP_SELF'];
                $dir = rtrim(dirname($this->_baseUrl), '\\');
                $this->_baseDir = ($dir === '/') ? $dir : $dir . '/';
        }

/**
 * Runs the actions required by the URL parameters.
 *
 * @return void
 */
        public function dispatch() {
                $this->_checkPHPUnit();
                $this->_parseParams();

                if ($this->params['case']) {
                        $value = $this->_runTestCase();
                } else {
                        $value = $this->_testCaseList();
                }

                $output = ob_get_clean();
                echo $output;
                return $value;
        }

/**
 * Static method to initialize the test runner, keeps global space clean
 *
 * @return void
 */
        public static function run() {
                $dispatcher = new CakeTestSuiteDispatcher();
                $dispatcher->dispatch();
        }

/**
 * Checks that PHPUnit is installed. Will exit if it doesn't
 *
 * @return void
 */
        protected function _checkPHPUnit() {
                $found = $this->loadTestFramework();
                if (!$found) {
                        $baseDir = $this->_baseDir;
                        include CAKE . 'TestSuite' . DS . 'templates' . DS . 'phpunit.php';
                        exit();
                }
        }

/**
 * Checks for the existence of the test framework files
 *
 * @return boolean true if found, false otherwise
 */
        public function loadTestFramework() {
                if (class_exists('PHPUnit_Framework_TestCase')) {
                        return true;
                }
                foreach (App::path('vendors') as $vendor) {
                        $vendor = rtrim($vendor, DS);
                        if (is_dir($vendor . DS . 'PHPUnit')) {
                                ini_set('include_path', $vendor . PATH_SEPARATOR . ini_get('include_path'));
                                break;
                        }
                }
                include 'PHPUnit' . DS . 'Autoload.php';
                return class_exists('PHPUnit_Framework_TestCase');
        }

/**
 * Checks for the xdebug extension required to do code coverage. Displays an error
 * if xdebug isn't installed.
 *
 * @return void
 */
        protected function _checkXdebug() {
                if (!extension_loaded('xdebug')) {
                        $baseDir = $this->_baseDir;
                        include CAKE . 'TestSuite' . DS . 'templates' . DS . 'xdebug.php';
                        exit();
                }
        }

/**
 * Generates a page containing the a list of test cases that could be run.
 *
 * @return void
 */
        protected function _testCaseList() {
                $command = new CakeTestSuiteCommand('', $this->params);
                $Reporter = $command->handleReporter($this->params['output']);
                $Reporter->paintDocumentStart();
                $Reporter->paintTestMenu();
                $Reporter->testCaseList();
                $Reporter->paintDocumentEnd();
        }

/**
 * Sets the params, calling this will bypass the auto parameter parsing.
 *
 * @param array $params Array of parameters for the dispatcher
 * @return void
 */
        public function setParams($params) {
                $this->params = $params;
                $this->_paramsParsed = true;
        }

/**
 * Parse URL params into a 'request'
 *
 * @return void
 */
        protected function _parseParams() {
                if (!$this->_paramsParsed) {
                        if (!isset($_SERVER['SERVER_NAME'])) {
                                $_SERVER['SERVER_NAME'] = '';
                        }
                        foreach ($this->params as $key => $value) {
                                if (isset($_GET[$key])) {
                                        $this->params[$key] = $_GET[$key];
                                }
                        }
                        if (isset($_GET['code_coverage'])) {
                                $this->params['codeCoverage'] = true;
                                $this->_checkXdebug();
                        }
                }
                if (empty($this->params['plugin']) && empty($this->params['core'])) {
                        $this->params['app'] = true;
                }
                $this->params['baseUrl'] = $this->_baseUrl;
                $this->params['baseDir'] = $this->_baseDir;
        }

/**
 * Runs a test case file.
 *
 * @return void
 */
        protected function _runTestCase() {
                $commandArgs = array(
                        'case' => $this->params['case'],
                        'core' => $this->params['core'],
                        'app' => $this->params['app'],
                        'plugin' => $this->params['plugin'],
                        'codeCoverage' => $this->params['codeCoverage'],
                        'showPasses' => !empty($this->params['show_passes']),
                        'baseUrl' => $this->_baseUrl,
                        'baseDir' => $this->_baseDir,
                );

                $options = array(
                        '--filter', $this->params['filter'],
                        '--output', $this->params['output'],
                        '--fixture', $this->params['fixture']
                );
                restore_error_handler();

                try {
                        self::time();
                        $command = new CakeTestSuiteCommand('CakeTestLoader', $commandArgs);
                        $command->run($options);
                } catch (MissingConnectionException $exception) {
                        ob_end_clean();
                        $baseDir = $this->_baseDir;
                        include CAKE . 'TestSuite' . DS . 'templates' . DS . 'missing_connection.php';
                        exit();
                }
        }

/**
 * Sets a static timestamp
 *
 * @param boolean $reset to set new static timestamp.
 * @return integer timestamp
 */
        public static function time($reset = false) {
                static $now;
                if ($reset || !$now) {
                        $now = time();
                }
                return $now;
        }

/**
 * Returns formatted date string using static time
 * This method is being used as formatter for created, modified and updated fields in Model::save()
 *
 * @param string $format format to be used.
 * @return string formatted date
 */
        public static function date($format) {
                return date($format, self::time());
        }

}