lib/simpletestlib/remote.php

   1 <?php
   2 /**
   3  *  base include file for SimpleTest
   4  *  @package    SimpleTest
   5  *  @subpackage UnitTester
   6  *  @version    $Id$
   7  */
   8
   9 /**#@+
  10  *  include other SimpleTest class files
  11  */
  12 require_once(dirname(__FILE__) . '/browser.php');
  13 require_once(dirname(__FILE__) . '/xml.php');
  14 require_once(dirname(__FILE__) . '/test_case.php');
  15 /**#@-*/
  16
  17 /**
  18  *    Runs an XML formated test on a remote server.
  19  *    @package SimpleTest
  20  *    @subpackage UnitTester
  21  */
  22 class RemoteTestCase {
  23     var $_url;
  24     var $_dry_url;
  25     var $_size;
  26
  27     /**
  28      *    Sets the location of the remote test.
  29      *    @param string $url       Test location.
  30      *    @param string $dry_url   Location for dry run.
  31      *    @access public
  32      */
  33     function RemoteTestCase($url, $dry_url = false) {
  34         $this->_url = $url;
  35         $this->_dry_url = $dry_url ? $dry_url : $url;
  36         $this->_size = false;
  37     }
  38
  39     /**
  40      *    Accessor for the test name for subclasses.
  41      *    @return string           Name of the test.
  42      *    @access public
  43      */
  44     function getLabel() {
  45         return $this->_url;
  46     }
  47
  48     /**
  49      *    Runs the top level test for this class. Currently
  50      *    reads the data as a single chunk. I'll fix this
  51      *    once I have added iteration to the browser.
  52      *    @param SimpleReporter $reporter    Target of test results.
  53      *    @returns boolean                   True if no failures.
  54      *    @access public
  55      */
  56     function run(&$reporter) {
  57         $browser = &$this->_createBrowser();
  58         $xml = $browser->get($this->_url);
  59         if (! $xml) {
  60             trigger_error('Cannot read remote test URL [' . $this->_url . ']');
  61             return false;
  62         }
  63         $parser = &$this->_createParser($reporter);
  64         if (! $parser->parse($xml)) {
  65             trigger_error('Cannot parse incoming XML from [' . $this->_url . ']');
  66             return false;
  67         }
  68         return true;
  69     }
  70
  71     /**
  72      *    Creates a new web browser object for fetching
  73      *    the XML report.
  74      *    @return SimpleBrowser           New browser.
  75      *    @access protected
  76      */
  77     function &_createBrowser() {
  78         $browser = new SimpleBrowser();
  79         return $browser;
  80     }
  81
  82     /**
  83      *    Creates the XML parser.
  84      *    @param SimpleReporter $reporter    Target of test results.
  85      *    @return SimpleTestXmlListener      XML reader.
  86      *    @access protected
  87      */
  88     function &_createParser(&$reporter) {
  89         $parser = new SimpleTestXmlParser($reporter);
  90         return $parser;
  91     }
  92
  93     /**
  94      *    Accessor for the number of subtests.
  95      *    @return integer           Number of test cases.
  96      *    @access public
  97      */
  98     function getSize() {
  99         if ($this->_size === false) {
 100             $browser = &$this->_createBrowser();
 101             $xml = $browser->get($this->_dry_url);
 102             if (! $xml) {
 103                 trigger_error('Cannot read remote test URL [' . $this->_dry_url . ']');
 104                 return false;
 105             }
 106             $reporter = new SimpleReporter();
 107             $parser = &$this->_createParser($reporter);
 108             if (! $parser->parse($xml)) {
 109                 trigger_error('Cannot parse incoming XML from [' . $this->_dry_url . ']');
 110                 return false;
 111             }
 112             $this->_size = $reporter->getTestCaseCount();
 113         }
 114         return $this->_size;
 115     }
 116 }
 117 ?>