t/README

   1 =head1 NAME
   2
   3 F<t> - MediaWiki test tree
   4
   5 =head1 DESCRIPTION
   6
   7 This is the MediaWiki test tree (well, one of them), tests in this
   8 directory are self-contained programs that produce TAP output via the
   9 F<Test.php> module (/trunk/Test/Test.php) (see
  10 http://search.cpan.org/~petdance/TAP-1.00/TAP.pm#THE_TAP_FORMAT for
  11 information on the TAP format).
  12
  13 =head1 Running the tests
  14
  15 You'll need F<Test.php> to run the tests, it lives in the
  16 F<trunk/Test> directory and can be copied or linked to the F<phase3>
  17 directory.
  18
  19     ln -s ../Test/Test.php .
  20
  21 Since the tests are self-contained PHP programs you can run them
  22 (Xml.t here) as:
  23
  24     php t/inc/Xml.t
  25
  26 That'll give you the raw TAP output, but what you probably want is to
  27 use a TAP formatter such as L<prove(1)>:
  28
  29     prove t/inc/Xml.t # add -v for the verbose version
  30
  31 or to run all the tests:
  32
  33    prove -r t
  34
  35 =head1 TODO
  36
  37 =over
  38
  39 =item *
  40
  41 Rewrite the rest of the F<tests/> stuff to use L<Test.php> and move it
  42 here
  43
  44 =item *
  45
  46 Make the parsertests use TAP?
  47
  48 =item *
  49
  50 Write unit tests for the entire codebase:)
  51
  52 =back
  53
  54 =cut