summaryrefslogtreecommitdiff
path: root/www/wiki/skins/chameleon/docs/testing.md
blob: 87c4180a530e0568f8f800959713a48aa5681c9f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
## Testing

This skin provides unit tests that can be run by a [continuous integration
platform][travis] or manually by executing the `mw-phpunit-runner.php` script or
[`phpunit`][mw-testing] together with the PHPUnit configuration file found in
the root directory of the skin.
```sh
php tests/mw-phpunit-runner.php [options]
```

Useful optional parameters:
```
--coverage-html ../../../report
--debug
```

To test against an external HTML validation service
(http://validator.w3.org/check) set the `USE_EXTERNAL_HTML_VALIDATOR` setting to
`true` in `phpunit.xml.dist`. Please be careful with their resources and use
this setting sparingly. If you do this, you may also want to set
`printerClass="Skins\Chameleon\Tests\Util\ColoringTextUIResultPrinter"` as an
additional attribute in the `phpunit` element to colorize then tests that
connect to the external service.

[travis]: https://travis-ci.org/cmln/chameleon
[mw-testing]: https://www.mediawiki.org/wiki/Manual:PHP_unit_testing