mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/Math
synced 2024-12-24 05:13:10 +00:00
7038c68f13
Changes to the use statements done automatically via script Addition of missing use statement done manually Change-Id: I4cf7903b9700e6366bdf349f99ffd4a04da0c087
365 lines
11 KiB
PHP
365 lines
11 KiB
PHP
<?php
|
|
|
|
use MediaWiki\Extension\Math\InvalidTeXException;
|
|
use MediaWiki\Extension\Math\MathRestbaseException;
|
|
use MediaWiki\Extension\Math\MathRestbaseInterface;
|
|
use MediaWiki\Extension\Math\Tests\MathMockHttpTrait;
|
|
use Wikimedia\Http\MultiHttpClient;
|
|
|
|
/**
|
|
* Test the interface to access Restbase paths
|
|
* /media/math/check/{type}
|
|
* /media/math/render/{format}/{hash}
|
|
*
|
|
* @covers \MediaWiki\Extension\Math\MathRestbaseInterface
|
|
*
|
|
* @group Math
|
|
*
|
|
* @license GPL-2.0-or-later
|
|
*/
|
|
class MathRestbaseInterfaceTest extends MediaWikiIntegrationTestCase {
|
|
use MathMockHttpTrait;
|
|
|
|
public function testSuccess() {
|
|
$this->setupGoodMathRestBaseMockHttp();
|
|
|
|
$input = '\\sin x^2';
|
|
$rbi = new MathRestbaseInterface( $input );
|
|
$this->assertTrue( $rbi->getSuccess(), "Assuming that $input is valid input." );
|
|
$this->assertEquals( '\\sin x^{2}', $rbi->getCheckedTex() );
|
|
$this->assertStringContainsString( '<mi>sin</mi>', $rbi->getMathML() );
|
|
$this->assertStringContainsString( '/svg/RESOURCE_LOCATION', $rbi->getFullSvgUrl() );
|
|
}
|
|
|
|
public function testBatchEvaluate() {
|
|
$body = [
|
|
'success' => true,
|
|
'checked' => 'CHECKED',
|
|
'identifiers' => []
|
|
];
|
|
|
|
$response = [
|
|
'code' => 200,
|
|
'headers' => [],
|
|
'body' => json_encode( $body )
|
|
];
|
|
|
|
$responses = [
|
|
[ // for https://wikimedia.org/api/rest_v1/media/math/check/tex with input1
|
|
'headers' => [ 'x-resource-location' => 'deadbeef1' ],
|
|
'body' => json_encode( [ 'checked' => 'CHECKED1' ] + $body )
|
|
] + $response,
|
|
|
|
[ // for https://wikimedia.org/api/rest_v1/media/math/check/tex with input2
|
|
'headers' => [ 'x-resource-location' => 'deadbeef2' ],
|
|
'body' => json_encode( [ 'checked' => 'CHECKED2' ] + $body )
|
|
] + $response,
|
|
|
|
[ // for https://wikimedia.org/api/rest_v1/media/math/render/mml/deadbeef1
|
|
'body' => 'MML1'
|
|
] + $response,
|
|
|
|
[ // for https://wikimedia.org/api/rest_v1/media/math/render/mml/deadbeef2
|
|
'body' => 'MML2'
|
|
] + $response,
|
|
];
|
|
|
|
$httpClient = $this->createNoOpMock( MultiHttpClient::class, [ 'runMulti' ] );
|
|
$httpClient->method( 'runMulti' )->willReturnCallback(
|
|
static function ( array $requests ) use ( &$responses ) {
|
|
foreach ( $requests as &$req ) {
|
|
$resp = array_shift( $responses );
|
|
$req['response'] = $resp;
|
|
}
|
|
return $requests;
|
|
}
|
|
);
|
|
|
|
$this->installMockHttp( $httpClient );
|
|
|
|
// NOTE: Using fake response, the input is ignored.
|
|
$rbi1 = new MathRestbaseInterface( 'input1' );
|
|
$rbi2 = new MathRestbaseInterface( 'input2' );
|
|
|
|
MathRestbaseInterface::batchEvaluate( [ $rbi1, $rbi2 ] );
|
|
|
|
$this->assertTrue( $rbi1->getSuccess() );
|
|
$this->assertEquals( 'CHECKED1', $rbi1->getCheckedTex() );
|
|
$this->assertEquals( 'MML1', $rbi1->getMathML() );
|
|
|
|
$this->assertTrue( $rbi2->getSuccess() );
|
|
$this->assertEquals( 'CHECKED2', $rbi2->getCheckedTex() );
|
|
$this->assertEquals( 'MML2', $rbi2->getMathML() );
|
|
}
|
|
|
|
public function testFail() {
|
|
$this->setupBadMathRestBaseMockHttp();
|
|
|
|
$input = '\\sin\\newcommand';
|
|
$rbi = new MathRestbaseInterface( $input );
|
|
$this->assertFalse( $rbi->getSuccess(), "Assuming that $input is invalid input." );
|
|
$this->assertNull( $rbi->getCheckedTex() );
|
|
$this->assertEquals( 'Illegal TeX function', $rbi->getError()->error->message );
|
|
}
|
|
|
|
public function testChem() {
|
|
$this->setupGoodChemRestBaseMockHttp();
|
|
|
|
$input = '\ce{H2O}';
|
|
$rbi = new MathRestbaseInterface( $input, 'chem' );
|
|
$this->assertTrue( $rbi->checkTeX(), "Assuming that $input is valid input." );
|
|
$this->assertTrue( $rbi->getSuccess(), "Assuming that $input is valid input." );
|
|
$this->assertEquals( '{\ce {H2O}}', $rbi->getCheckedTex() );
|
|
$this->assertStringContainsString( '<msubsup>', $rbi->getMathML() );
|
|
$this->assertStringContainsString( '<mtext>H</mtext>', $rbi->getMathML() );
|
|
}
|
|
|
|
public function testException() {
|
|
$this->setupBadMathRestBaseMockHttp();
|
|
|
|
$input = '\\sin\\newcommand';
|
|
$rbi = new MathRestbaseInterface( $input );
|
|
$this->expectException( InvalidTeXException::class );
|
|
$this->expectExceptionMessage( 'TeX input is invalid.' );
|
|
$rbi->getMathML();
|
|
}
|
|
|
|
public function testExceptionSvg() {
|
|
$this->setupBadMathRestBaseMockHttp();
|
|
|
|
$input = '\\sin\\newcommand';
|
|
$rbi = new MathRestbaseInterface( $input );
|
|
$this->expectException( InvalidTeXException::class );
|
|
$this->expectExceptionMessage( 'TeX input is invalid.' );
|
|
$rbi->getFullSvgUrl();
|
|
}
|
|
|
|
/**
|
|
* Incorporate the "details" in the error message, if the check requests passes, but the
|
|
* mml/svg/complete endpoints returns an error
|
|
*/
|
|
public function testLateError() {
|
|
// phpcs:ignore Generic.Files.LineLength.TooLong
|
|
$input = '{"type":"https://mediawiki.org/wiki/HyperSwitch/errors/bad_request","title":"Bad Request","method":"POST","detail":["TeX parse error: Missing close brace"],"uri":"/complete"}';
|
|
$this->expectException( MathRestbaseException::class );
|
|
$this->expectExceptionMessage( 'Cannot get mml. TeX parse error: Missing close brace' );
|
|
MathRestbaseInterface::throwContentError( 'mml', $input );
|
|
}
|
|
|
|
/**
|
|
* Incorporate the "details" in the error message, if the check requests passes, but the
|
|
* mml/svg/complete endpoints returns an error
|
|
*/
|
|
public function testLateErrorString() {
|
|
// phpcs:ignore Generic.Files.LineLength.TooLong
|
|
$input = '{"type":"https://mediawiki.org/wiki/HyperSwitch/errors/bad_request","title":"Bad Request","method":"POST","detail": "TeX parse error: Missing close brace","uri":"/complete"}';
|
|
$this->expectException( MathRestbaseException::class );
|
|
$this->expectExceptionMessage( 'Cannot get mml. TeX parse error: Missing close brace' );
|
|
MathRestbaseInterface::throwContentError( 'mml', $input );
|
|
}
|
|
|
|
public function testLateErrorNoDetail() {
|
|
$input = '';
|
|
$this->expectException( MathRestbaseException::class );
|
|
$this->expectExceptionMessage( 'Cannot get mml. Server problem.' );
|
|
MathRestbaseInterface::throwContentError( 'mml', $input );
|
|
}
|
|
|
|
public function testUrlUsedByCheckTeX() {
|
|
$path = 'media/math/check/tex';
|
|
$config = [
|
|
'MathFullRestbaseURL' => 'https://myWiki.test/',
|
|
'MathInternalRestbaseURL' => 'http://restbase.test.internal/api/myWiki/'
|
|
];
|
|
|
|
$expected = [
|
|
'url' => "http://restbase.test.internal/api/myWiki/v1/$path",
|
|
'method' => 'POST',
|
|
'body' => [ 'type' => 'tex', 'q' => '\sin\newcommand' ]
|
|
];
|
|
|
|
$response = [
|
|
'headers' => [
|
|
'x-resource-location' => 'deadbeef'
|
|
],
|
|
'body' => json_encode( [
|
|
'success' => true,
|
|
'checked' => 'who cares',
|
|
'identifiers' => [],
|
|
] )
|
|
];
|
|
|
|
$this->expectMathRestBaseMockHttpRequest( [ $expected ], [ $response ] );
|
|
|
|
$this->overrideConfigValues( $config );
|
|
|
|
$input = '\\sin\\newcommand';
|
|
$rbi = new MathRestbaseInterface( $input );
|
|
|
|
$rbi->checkTeX();
|
|
}
|
|
|
|
public function testUrlUsedByGetML() {
|
|
$path1 = 'media/math/check/tex';
|
|
$path2 = 'media/math/render/mml/deadbeef';
|
|
|
|
$config = [
|
|
'MathFullRestbaseURL' => 'https://myWiki.test/',
|
|
'MathInternalRestbaseURL' => 'http://restbase.test.internal/api/myWiki/'
|
|
];
|
|
|
|
$expectedList = [
|
|
[
|
|
'url' => "http://restbase.test.internal/api/myWiki/v1/$path1",
|
|
'method' => 'POST'
|
|
],
|
|
[
|
|
'url' => "http://restbase.test.internal/api/myWiki/v1/$path2",
|
|
'method' => 'GET'
|
|
],
|
|
];
|
|
|
|
$response1 = [
|
|
'headers' => [
|
|
'x-resource-location' => 'deadbeef'
|
|
],
|
|
'body' => json_encode( [
|
|
'success' => true,
|
|
'checked' => 'who cares',
|
|
'identifiers' => [],
|
|
] )
|
|
];
|
|
$response2 = [
|
|
'body' => 'who cares'
|
|
];
|
|
|
|
$this->expectMathRestBaseMockHttpRequest( $expectedList, [ $response1, $response2 ] );
|
|
|
|
$this->overrideConfigValues( $config );
|
|
|
|
$input = '\\sin\\newcommand';
|
|
$rbi = new MathRestbaseInterface( $input );
|
|
|
|
$rbi->getMathML();
|
|
}
|
|
|
|
public static function dataProviderForTestGetUrl() {
|
|
$path = 'media/math/render/svg/2uejd9dj3jd';
|
|
$config = [
|
|
'MathFullRestbaseURL' => 'https://myWiki.test/',
|
|
'MathInternalRestbaseURL' => 'http://restbase.test.internal/api/myWiki/'
|
|
];
|
|
|
|
yield 'External restbase URL case' => [
|
|
$path,
|
|
false,
|
|
$config,
|
|
'https://myWiki.test/v1/media/math/render/svg/2uejd9dj3jd'
|
|
];
|
|
|
|
yield 'Internal restbase URL case' => [
|
|
$path,
|
|
true,
|
|
$config,
|
|
'http://restbase.test.internal/api/myWiki/v1/media/math/render/svg/2uejd9dj3jd'
|
|
];
|
|
}
|
|
|
|
/**
|
|
* @dataProvider dataProviderForTestGetUrl
|
|
* @param string $path
|
|
* @param bool $internal
|
|
* @param array $config
|
|
* @param string $expected
|
|
*/
|
|
public function testGetUrl( $path, $internal, $config, $expected ) {
|
|
$this->overrideConfigValues( $config );
|
|
$input = '\\sin\\newcommand';
|
|
$rbi = new MathRestbaseInterface( $input );
|
|
$actual = $rbi->getUrl( $path, $internal );
|
|
$this->assertSame( $expected, $actual );
|
|
}
|
|
|
|
public function testGetType() {
|
|
$tex = '\testing tex';
|
|
$type = 'test';
|
|
$interface = new MathRestbaseInterface( $tex, $type );
|
|
|
|
$this->assertEquals( $type, $interface->getType() );
|
|
}
|
|
|
|
public function testGetTex() {
|
|
$tex = '\tesing tex';
|
|
$interface = new MathRestbaseInterface( $tex );
|
|
|
|
$this->assertEquals( $tex, $interface->getTex() );
|
|
}
|
|
|
|
public function testEvaluateRestbaseCheckResponse() {
|
|
$response = [
|
|
'code' => 200,
|
|
'headers' => [
|
|
'x-resource-location' => 'deadbeef'
|
|
],
|
|
'body' => json_encode( [
|
|
'success' => true,
|
|
'checked' => 'who cares',
|
|
'identifiers' => [ 'identifier1', 'identifier2' ],
|
|
'warnings' => [ 'Warning 1', 'Warning 2' ]
|
|
] )
|
|
];
|
|
|
|
$rbi = new MathRestbaseInterface();
|
|
$result = $rbi->evaluateRestbaseCheckResponse( $response );
|
|
|
|
$this->assertTrue( $result );
|
|
$this->assertTrue( $rbi->getSuccess() );
|
|
$this->assertSame( 'who cares', $rbi->getCheckedTex() );
|
|
$this->assertSame( [ 'identifier1', 'identifier2' ], $rbi->getIdentifiers() );
|
|
$this->assertSame( [ 'Warning 1', 'Warning 2' ], $rbi->getWarnings() );
|
|
$this->assertNull( $rbi->getError() );
|
|
}
|
|
|
|
public function testEvaluateRestbaseCheckResponseWithErrorMessage() {
|
|
$errorResponse = [
|
|
'code' => 400,
|
|
'body' => json_encode( [
|
|
'detail' => [
|
|
'success' => false,
|
|
'message' => 'Invalid input'
|
|
]
|
|
] )
|
|
];
|
|
|
|
$rbi = new MathRestbaseInterface();
|
|
$result = $rbi->evaluateRestbaseCheckResponse( $errorResponse );
|
|
|
|
$this->assertFalse( $result );
|
|
$this->assertFalse( $rbi->getSuccess() );
|
|
$this->assertNull( $rbi->getCheckedTex() );
|
|
$this->assertNull( $rbi->getIdentifiers() );
|
|
$this->assertSame( [], $rbi->getWarnings() );
|
|
$this->assertNotNull( $rbi->getError() );
|
|
}
|
|
|
|
public function testEvaluateRestbaseCheckResponseWithFailure() {
|
|
$errorResponseWithoutDetail = [
|
|
'code' => 400,
|
|
'body' => json_encode( [
|
|
'message' => 'Invalid input'
|
|
] )
|
|
];
|
|
|
|
$rbi = new MathRestbaseInterface();
|
|
$result = $rbi->evaluateRestbaseCheckResponse( $errorResponseWithoutDetail );
|
|
|
|
$this->assertFalse( $result );
|
|
$this->assertFalse( $rbi->getSuccess() );
|
|
$this->assertNull( $rbi->getCheckedTex() );
|
|
$this->assertNull( $rbi->getIdentifiers() );
|
|
$this->assertSame( [], $rbi->getWarnings() );
|
|
$this->assertNotNull( $rbi->getError() );
|
|
$this->assertSame( 'Math extension cannot connect to Restbase.', $rbi->getError()->error->message );
|
|
}
|
|
}
|