tests/unit/readme.html

   1 <html>
   2 <head>
   3 <title>PhpWiki unit tests</title>
   4 </head>
   5 <body>
   6
   7 <h1>Introduction</h1>
   8
   9 This directory contains unit tests for PhpWiki.  You must have <a
  10 href="http://pear.php.net/package/PHPUnit">PEAR's PHPUnit package</a>.
  11 These tests are unrelated to maketest.pl in the directory above this
  12 one, which do not use PHPUnit.
  13
  14 <h1>Prerequisites</h1>
  15 <h2>PHP</h2>
  16
  17 You might want to run these from the php <a
  18 href="http://us3.php.net/features.commandline">command-line
  19 interface</a>.  It was experimental as of PHP 4.2.0 (php-cli), default as of PHP
  20 4.3.0.
  21
  22 You also need the 'pear' executable to install or update the required pear libraries.
  23
  24 <h2>PHPUnit</h2>
  25
  26 You can use pear to see if PHPUnit is installed:
  27
  28 <pre>
  29 /export/scratch/apache/2.0.46/php/bin) % ./pear list
  30 Installed packages:
  31 ===================
  32 Package        Version State
  33 Archive_Tar    0.9     stable
  34 Console_Getopt 1.0     stable
  35 DB             1.3     stable
  36 HTTP           1.2     stable
  37 HTTP_Upload    0.8.1   stable
  38 Mail           1.0.1   stable
  39 Net_SMTP       1.0     stable
  40 Net_Socket     1.0.1   stable
  41 PEAR           1.1     stable
  42 PHPUnit        1.0.0   stable
  43 XML_Parser     1.0.1   stable
  44 XML_RPC        1.0.4   stable
  45 </pre>
  46
  47 If it is not installed, you can use 'pear' to install it:
  48
  49 <pre>
  50 /export/scratch/apache/2.0.46/php/bin) % ./pear install PHPUnit
  51 </pre>
  52
  53 <h1>Running these unit tests</h1>
  54
  55 You must be in the phpwiki/tests/unit subdirectory.  Then use the php
  56 command-line executable to run the tests.  For example:
  57
  58 <pre>
  59 phpwiki/tests/unit % ./test.php
  60 Run tests ..
  61 ran 8 tests, 0 failures.
  62 </pre>
  63
  64 Or for only some tests, give the test names on the commandline:
  65
  66 <pre>
  67 phpwiki/tests/unit % php -Cq test.php SetupWiki DumpHtml
  68 Run tests .. Array
  69 (
  70     [0] => SetupWiki
  71     [1] => DumpHtml
  72 )
  73 Purge the testbox .. ran 4 tests, 0 failures.
  74 </pre>
  75
  76 Or run it from the browser like this:
  77
  78 <pre>
  79 http://localhost/phpwiki/test/unit/test.php?tests=SetupWiki,DumpHtml
  80 </pre>
  81
  82 </body>
  83 </html>