mediawiki-extensions-Math/tests/phpunit/MathCoverageTest.php
Thiemo Kreuz b189280467 Make all @covers tags absolute, and fix some
Some mentioned a "__constructor", which should be "__construct".

The leading backslash is not strictly needed by all tools. But some
need it. I learned it's best practice to always have it.

Change-Id: I22fe3a3b4828c02ab5a457aba9af5af1c72567ea
2019-11-26 11:01:23 +01:00

60 lines
2.1 KiB
PHP

<?php
/**
* PHPUnit tests to test the wide range of all typical use cases for formulae at Wikipedia.
* To generate the page https://www.mediawiki.org/wiki/Extension:Math/CoverageTest is used to
* generate the test data.
* The testData is generated by the maintenance script Math/maintenance/MathGenerateTests.php.
* To update the test data locally with vagrant the following procedure is recommended:
*
* 1. copy the source from https://www.mediawiki.org/wiki/Extension:Math/CoverageTest
* to a new page e.g.
* MathTest at your local vagrant instance
* 2. run <code>php MathGenerateTests.php MathTest</code>
* in the maitenance folder of the Math extension.
* 3. Test local e.g. via
* <code>sudo php /vagrant/mediawiki/tests/phpunit/phpunit.php
* /vagrant/mediawiki/extensions/Math/tests/MathCoverageTest.php</code>
* (If you don't use sudo you might have problems with the permissions set at vagrant.)
*
* @covers \MathRenderer
*
* @group Math
*
* @license GPL-2.0-or-later
*/
class MathCoverageTest extends MediaWikiTestCase {
/**
* Loops over all test cases provided by the provider function.
* Compares each the rendering result of each input with the expected output.
* @dataProvider provideCoverage
*/
public function testCoverage( $input, $options, $output ) {
// TODO: Make rendering mode configurable
// TODO: Provide test-ids
// TODO: Link to the wikipage that contains the reference rendering
$this->assertEquals(
$this->normalize( $output ),
$this->normalize( MathRenderer::renderMath( $input, $options, 'png' ) ),
"Failed to render ${input}"
);
}
/**
* Gets the test-data from the file ParserTest.json
* @return array where $input is the test input string
* and $output is the rendered html5-output string
*/
public function provideCoverage() {
$testcases = json_decode( file_get_contents( __DIR__ . '/../ParserTest.json' ), true );
// uncomment for fast testing
// $testcases = array_slice($testcases,0,3);
return $testcases;
}
private function normalize( $input ) {
return preg_replace( '#src="(.*?)/(([a-f]|\d)*)"#', 'src="\2"', $input );
}
}