Source for file webunit_reporter.php

Documentation is available at webunit_reporter.php

  1. <?php
  2. /**
  3.  *    base include file for SimpleTest PUnit reporter
  4.  *    @package    SimpleTest
  5.  *    @subpackage    Extensions
  6.  *    @version    $Id: webunit_reporter.php 1836 2008-12-21 00:02:26Z edwardzyang $
  7.  */
  8.  
  9. /**
  10.  * @ignore    originally defined in simple_test.php
  11.  */
  12. if (!defined("SIMPLE_TEST")) {
  13.     define("SIMPLE_TEST", "simpletest/");
  14. }
  15. require_once(SIMPLE_TEST . 'runner.php');
  16. require_once(SIMPLE_TEST . 'reporter.php');
  17. /**
  18.  * Main sprintf template for the start of the page.
  19.  * Sequence of parameters is:
  20.  * - title - string
  21.  * - script path - string
  22.  * - script path - string
  23.  * - css path - string
  24.  * - additional css - string
  25.  * - title - string
  26.  * - image path - string
  27.  */
  28. define('SIMPLETEST_WEBUNIT_HEAD', <<<EOS
  29. <html>
  30. <head>
  31. <title>%s</title>
  32. <script type="text/javascript" src="%sx.js"></script>
  33. <script type="text/javascript" src="%swebunit.js"></script>
  34. <link rel="stylesheet" type="text/css" href="%swebunit.css" title="Default"></link>
  35. <style type="text/css">
  36. %s
  37. </style>
  38. </head>
  39. <body>
  40. <div id="wait">
  41.     <h1>&nbsp;Running %s&nbsp;</h1>
  42.     Please wait...<br />
  43.     <img src="%swait.gif" border="0"><br />&nbsp;
  44. </div>
  45. <script type="text/javascript">
  46. wait_start();
  47. </script>
  48. <div id="webunit">
  49.     <div id="run"></div><br />
  50.     <div id="tabs">
  51.         <div id="visible_tab">visible tab content</div>
  52.         &nbsp;&nbsp;<span id="failtab" class="activetab">&nbsp;&nbsp;<a href="javascript:activate_tab('fail');">Fail</a>&nbsp;&nbsp;</span>
  53.         <span id="treetab" class="inactivetab">&nbsp;&nbsp;<a href="javascript:activate_tab('tree');">Tree</a>&nbsp;&nbsp;</span>
  54.     </div>
  55.     <div id="msg">Click on a failed test case method in the tree tab to view output here.</div>
  56. </div>
  57. <div id="fail"></div>
  58. <div id="tree"></div>
  59. <!-- open a new script to capture js vars as the tests run -->
  60. <script type="text/javascript">
  61. layout();
  62.  
  63. EOS
  64. );
  65.  
  66. /**
  67.  *    Not used yet.
  68.  *  May be needed for localized styles we need at runtime, not in the stylesheet.
  69.  */
  70. define('SIMPLETEST_WEBUNIT_CSS', '/* this space reseved for future use */');
  71.  
  72.     /**
  73.      *    Sample minimal test displayer. Generates only
  74.      *    failure messages and a pass count.
  75.      *      @package SimpleTest
  76.      *      @subpackage UnitTester
  77.      */
  78.     class WebUnitReporter extends SimpleReporter {
  79.         /**
  80.          *    @var string Base directory for PUnit script, images and style sheets.
  81.          *     Needs to be a relative path from where the test scripts are run
  82.          *     (and obviously, visible in the document root).
  83.          */
  84.         var $path;
  85.         
  86.         /**
  87.          *    Does nothing yet. The first output will
  88.          *    be sent on the first test start. For use
  89.          *    by a web browser.
  90.          *    @access public
  91.          */
  92.         function __construct($path='../ui/') {
  93.             parent::__construct();
  94.             $this->path = $path;
  95.         }
  96.         
  97.         /**
  98.          *    Paints the top of the web page setting the
  99.          *    title to the name of the starting test.
  100.          *    @param string $test_name      Name class of test.
  101.          *    @access public
  102.          */
  103.         function paintHeader($test_name) {
  104.             $this->sendNoCacheHeaders();
  105.             echo sprintf(
  106.                 SIMPLETEST_WEBUNIT_HEAD
  107.                 ,$test_name
  108.                 ,$this->path.'js/'
  109.                 ,$this->path.'js/'
  110.                 ,$this->path.'css/'
  111.                 ,$this->_getCss()
  112.                 ,$test_name
  113.                 ,$this->path.'img/'
  114.                 );
  115.             flush();
  116.         }
  117.         
  118.         /**
  119.          *    Send the headers necessary to ensure the page is
  120.          *    reloaded on every request. Otherwise you could be
  121.          *    scratching your head over out of date test data.
  122.          *    @access public
  123.          */
  124.         function sendNoCacheHeaders() {
  125.             header("Expires: Mon, 26 Jul 1997 05:00:00 GMT");
  126.             header("Last-Modified: " . gmdate("D, d M Y H:i:s") . " GMT");
  127.             header("Cache-Control: no-store, no-cache, must-revalidate");
  128.             header("Cache-Control: post-check=0, pre-check=0", false);
  129.             header("Pragma: no-cache");
  130.         }
  131.         
  132.         /**
  133.          *    Paints the CSS. Add additional styles here.
  134.          *    @return string            CSS code as text.
  135.          *    @access protected
  136.          */
  137.         function _getCss() {
  138.             return SIMPLETEST_WEBUNIT_CSS;
  139.         }
  140.         
  141.         /**
  142.          *    Paints the end of the test with a summary of
  143.          *    the passes and failures.
  144.          *    @param string $test_name        Name class of test.
  145.          *    @access public
  146.          */
  147.         function paintFooter($test_name) {
  148.             echo 'make_tree();</script>'.$this->outputScript("xHide('wait');");
  149.             $colour = ($this->getFailCount() + $this->getExceptionCount() > 0 ? "red" : "green");
  150.             $content = "<h1>$test_name</h1>\n";
  151.             $content .= "<div style=\"";
  152.             $content .= "padding: 8px; margin-top: 1em; background-color: $colour; color: white;";
  153.             $content .= "\">";
  154.             $content .= $this->getTestCaseProgress() . "/" . $this->getTestCaseCount();
  155.             $content .= " test cases complete:\n";
  156.             $content .= "<strong>" . $this->getPassCount() . "</strong> passes, ";
  157.             $content .= "<strong>" . $this->getFailCount() . "</strong> fails and ";
  158.             $content .= "<strong>" . $this->getExceptionCount() . "</strong> exceptions.";
  159.             $content .= "</div>\n";
  160.  
  161.             echo $this->outputScript('foo = "'.$this->toJsString($content).'";'."\nset_div_content('run', foo);");
  162.             echo "\n</body>\n</html>\n";
  163.         }
  164.         
  165.         
  166.         /**
  167.          *    Paints formatted text such as dumped variables.
  168.          *    @param string $message        Text to show.
  169.          *    @access public
  170.          */
  171.         function paintFormattedMessage($message) {
  172.            echo "add_log(\"".$this->toJsString("<pre>$message</pre>", true)."\");\n";
  173.         }
  174.         
  175.         /**
  176.          *    Paints the start of a group test. Will also paint
  177.          *    the page header and footer if this is the
  178.          *    first test. Will stash the size if the first
  179.          *    start.
  180.          *    @param string $test_name   Name of test that is starting.
  181.          *    @param integer $size       Number of test cases starting.
  182.          *    @access public
  183.          */
  184.         function paintGroupStart($test_name, $size) {
  185.              Parent::paintGroupStart($test_name, $size);
  186.              echo "add_group('$test_name');\n";
  187.         }
  188.  
  189.          /**
  190.           *    Paints the start of a test case. Will also paint
  191.           *    the page header and footer if this is the
  192.           *    first test. Will stash the size if the first
  193.           *    start.
  194.           *    @param string $test_name   Name of test that is starting.
  195.           *    @access public
  196.           */
  197.          function paintCaseStart($test_name) {
  198.              Parent::paintCaseStart($test_name);
  199.              echo "add_case('$test_name');\n";
  200.          }
  201.  
  202.  
  203.          /**
  204.           *    Paints the start of a test method.
  205.           *    @param string $test_name   Name of test that is starting.
  206.           *    @access public
  207.           */
  208.          function paintMethodStart($test_name) {
  209.              Parent::paintMethodStart($test_name);
  210.              echo "add_method('$test_name');\n";
  211.          }
  212.  
  213.          /**
  214.           *    Paints the end of a test method.
  215.           *    @param string $test_name   Name of test that is ending.
  216.           *    @access public
  217.           */
  218.          function paintMethodEnd($test_name) {
  219.              Parent::paintMethodEnd($test_name);
  220.          }
  221.  
  222.          /**
  223.           *    Paints the test failure with a breadcrumbs
  224.           *    trail of the nesting test suites below the
  225.           *    top level test.
  226.           *    @param string $message    Failure message displayed in
  227.           *                                the context of the other tests.
  228.           *    @access public
  229.           */
  230.          function paintFail($message) {
  231.              parent::paintFail($message);
  232.              $msg = "<span class=\"fail\">Fail</span>: ";
  233.              $breadcrumb = $this->getTestList();
  234.              array_shift($breadcrumb);
  235.              $msg .= implode("-&gt;", $breadcrumb);
  236.              $msg .= "-&gt;" . htmlentities($message) . "<br />";
  237.              echo "add_fail('$msg');\n";
  238.          }
  239.  
  240.         /**
  241.          *    Paints a PHP error or exception.
  242.          *    @param string $message        Message is ignored.
  243.          *    @access public
  244.          *    @abstract
  245.          */
  246.         function paintException($message) {
  247.             parent::paintException($message);
  248.             $msg = "<span class=\"fail\">Exception</span>: ";
  249.             $breadcrumb = $this->getTestList();
  250.             array_shift($breadcrumb);
  251.             $msg .= implode("-&gt;", $breadcrumb);
  252.             $msg .= "-&gt;<strong>" . htmlentities($message) . "</strong><br />";
  253.             echo "add_fail('$msg');\n";
  254.         }
  255.  
  256.         /**
  257.          * Returns the script passed in wrapped in script tags.
  258.          *
  259.          * @param    string    $script        the script to output
  260.          * @return    string    the script wrapped with script tags
  261.          */
  262.         function outputScript($script)
  263.         {
  264.             return "<script type=\"text/javascript\">\n".$script."\n</script>\n";
  265.         }
  266.         
  267.         
  268.         /**
  269.          *    Transform a string into a format acceptable to JavaScript
  270.          *  @param string $str    the string to transform
  271.          *    @return    string 
  272.          */
  273.         function toJsString($str, $preserveCr=false) {
  274.             $cr = ($preserveCr) ? '\\n' : '';
  275.             return str_replace(
  276.                 array('"'
  277.                     ,"\n")
  278.                 ,array('\"'
  279.                     ,"$cr\"\n\t+\"")
  280.                 ,$str
  281.                 );
  282.         }
  283.     }
  284.     
  285. ?>

Documentation generated on Sun, 31 Oct 2010 16:32:57 -0500 by phpDocumentor 1.4.3