Per wikitech-l discussion: Move tests from maintenance/tests/ to tests/. They're...
[lhc/web/wiklou.git] / tests / phpunit / README
1 == MediaWiki PHPUnit Tests ==
2
3 Some quickie unit tests done with the PHPUnit testing framework. To run the
4 test suite, run 'make test' in this (maintenance/tests/phpunit) directory.
5
6 === WARNING ===
7
8 The current versions of some of these tests are DESTRUCTIVE AND WILL ALTER
9 YOUR WIKI'S CONTENTS. DO NOT RUN ON A PRODUCTION SYSTEM OR ONE WHERE YOU
10 NEED TO RETAIN YOUR DATA.
11
12 === Installation ===
13
14 PHPUnit is no longer maintained by PEAR. To get the current version of
15 PHPUnit, first uninstall any old version of PHPUnit or PHPUnit2 from PEAR,
16 then install the current version from phpunit.de like this:
17
18 pear channel-discover pear.phpunit.de
19 pear install phpunit/PHPUnit
20
21 You also may wish to install this via your normal package mechanism:
22
23 aptitude install phpunit
24 - or -
25 yum install phpunit
26
27 === Notes ===
28
29 * Label currently broken tests in the group Broken and they will not be run
30 by phpunit. You can add them to the group by putting the following comment at
31 the top of the file:
32 /**
33 * @group Broken
34 */
35 * Need to fix some broken tests