mediawiki-extensions-Math/tests/phpunit/unit/TexVC/ApiTest.php

230 lines
7 KiB
PHP
Raw Normal View History

<?php
namespace MediaWiki\Extension\Math\Tests\TexVC;
use MediaWiki\Extension\Math\TexVC\SyntaxError;
use MediaWiki\Extension\Math\TexVC\TexVC;
use MediaWikiUnitTestCase;
/**
* @covers \MediaWiki\Extension\Math\TexVC\TexVC
* @covers \MediaWiki\Extension\Math\TexVC\Parser
* @covers \MediaWiki\Extension\Math\TexVC\TexUtil
* @covers \MediaWiki\Extension\Math\TexVC\ParserUtil
*/
class ApiTest extends MediaWikiUnitTestCase {
private $testCases;
private $texVC;
protected function setUp(): void {
parent::setUp();
$this->testCases = [
(object)[
'in' => '\\newcommand{\\text{do evil things}}',
'status' => 'F',
'details' => '\\newcommand'
],
(object)[
'in' => '\\sin\\left(\\frac12x\\right)',
'output' => '\\sin \\left({\\frac {1}{2}}x\\right)'
],
(object)[
'in' => '\\reals',
'output' => '\mathbb {R} ',
'ams_required' => true
],
(object)[
'in' => '\\lbrack',
'output' => '\\lbrack '
],
(object)[
'in' => '\\figureEightIntegral',
'status' => 'F',
'details' => '\\figureEightIntegral'
],
(object)[
'in' => '\diamondsuit '
],
(object)[
'in' => '\\sinh x'
],
(object)[
'in' => '\\begin{foo}\\end{foo}',
'status' => 'F',
'details' => '\\begin{foo}'
],
(object)[
'in' => '\\hasOwnProperty',
'status' => 'F',
'details' => '\\hasOwnProperty'
],
(object)[
'in' => '\\hline',
'status' => 'S'
],
(object)[
'in' => '\\begin{array}{c}\\hline a \\\\ \\hline\\hline b \\end{array}',
'output' => '{\\begin{array}{c}\\hline a\\\\\\hline \\hline b\\end{array}}'
],
(object)[
'in' => '\\Diamond ',
'ams_required' => true
],
(object)[
'in' => '{\\begin{matrix}a\\ b\\end{matrix}}',
'ams_required' => true
],
(object)[
'in' => '{\\cancel {x}}',
'cancel_required' => true
],
(object)[
'in' => '\\color {red}',
'color_required' => true
],
(object)[
'in' => '\\euro',
'output' => '\\mbox{\\euro} ',
'euro_required' => true
],
(object)[
'in' => '\\coppa',
'output' => '\\mbox{\\coppa} ',
'teubner_required' => true
],
(object)[
'in' => '{\\color [rgb]{1,0,0}{\\mbox{This text is red.}}}',
'color_required' => true
],
(object)[
'in' => '{\\color[rgb]{1.5,0,0}{\\mbox{This text is bright red.}}}',
'status' => 'S'
],
(object)[
'in' => '{\\color [RGB]{51,0,0}{\\mbox{This text is dim red.}}}',
'output' => '{\\color [rgb]{0.2,0,0}{\\mbox{This text is dim red.}}}',
'color_required' => true
],
(object)[
'in' => '{\\color[RGB]{256,0,0}{\\mbox{This text is bright red.}}}',
'status' => 'S'
],
(object)[
'in' => '\\ce{ H2O }',
'mhchem_required' => true,
'status' => 'C'
],
(object)[
'in' => '\\ce{[Zn(OH)4]^2-}',
'mhchem_required' => true,
'status' => 'C'
],
];
$this->texVC = new TexVC();
}
public function testDefinedCases() {
foreach ( $this->testCases as $case ) {
$result = $this->texVC->check( $case->in );
$resultStatus = array_key_exists( 'status', $result ) ? $result['status'] : '';
$caseStatus = property_exists( $case, 'status' ) ? ( (object)$case )->status : '+';
$this->assertEquals( $caseStatus, $resultStatus, 'Status incorrect' );
if ( $resultStatus === '+' ) {
$this->assertEquals( $case->output ?? $case->in, $result['output'] ?? '', 'Output incorrect' );
foreach ( array_keys( $result ) as $f ) {
if ( preg_match( '/_required/', $f ) ) {
$this->assertEquals( property_exists( $case, $f ), $result[$f],
'A required field does not match in result ' . $f );
}
$this->assertCount( 0, $result['warnings'], 'No warnings expected here.' );
}
}
if ( $resultStatus === 'F' ) {
$this->assertEquals( $case->details, $result['details'] ?? '', 'Details incorrect' );
$this->assertCount( 0, $result['warnings'], 'No warnings expected here.' );
}
}
}
public function testSuccess1() {
$message = 'should return success (1)';
$result = $this->texVC->check( '\\sin(x)+{}{}\\cos(x)^2 newcommand' );
$this->assertEquals( '+', $result['status'], $message );
$this->assertEquals( '\\sin(x)+{}{}\\cos(x)^{2}newcommand', $result['output'], $message );
}
public function testSuccess2() {
$message = 'should return success (2)';
$result = $this->texVC->check( 'y=x+2' );
$this->assertEquals( '+', $result['status'], $message );
$this->assertEquals( 'y=x+2', $result['output'], $message );
}
public function testReport1() {
$message = 'should report undefined functions (1)';
$result = $this->texVC->check( '\\foo' );
$this->assertEquals( 'F', $result['status'], $message );
$this->assertEquals( '\\foo', $result['details'], $message );
}
public function testReport2() {
$message = 'should report undefined functions (2)';
$result = $this->texVC->check( '\\write18' );
$this->assertEquals( 'F', $result['status'], $message );
$this->assertEquals( '\\write', $result['details'], $message );
}
public function testUndefined() {
$message = 'should report undefined parser errors';
$result = $this->texVC->check( '^' );
$this->assertEquals( 'S', $result['status'], $message );
}
public function testDebugException() {
// should throw an exception in debug mode
$this->expectException( SyntaxError::class );
$this->texVC->check( '^', [ 'debug' => true ] );
}
public function testParsedInput() {
$message = 'should accept parsed input';
$parsed = $this->texVC->parse( 'y=x+2' );
$result = $this->texVC->check( $parsed );
$this->assertEquals( '+', $result['status'], $message );
$this->assertEquals( 'y=x+2', $result['output'], $message );
}
public function testRetryParsing() {
$message = 'should retry parsing if oldmhchem is not set';
$result = $this->texVC->check( '\\ce {A\\;+\\;B\\;->\\;C}', [ 'usemhchem' => true ] );
$this->assertEquals( '+', $result['status'], $message );
$this->assertEquals( 'mhchem-deprecation', $result['warnings'][0]['type'], $message );
$this->assertEquals( 'S', $result['warnings'][0]['details']['status'], $message );
}
public function testDeprecationWarning() {
// This test is not complete yet
$message = 'should show a deprecation warning for \\and';
$result = $this->texVC->check( '\\and' );
$this->assertEquals( '+', $result['status'], $message );
$this->assertEquals( 'texvc-deprecation', $result['warnings'][0]['type'], $message );
$this->assertEquals( 'S', $result['warnings'][0]['details']['status'], $message );
}
public function testDeprecationWarning2() {
$message = 'should not show a deprecation warning for \\land';
$result = $this->texVC->check( '\\land' );
$this->assertEquals( '+', $result['status'], $message );
$this->assertCount( 0, $result['warnings'], $message );
}
public function testNoRetry() {
$message = 'should not retry parsing if oldmhchem is set';
$result = $this->texVC->check( '\\ce {A\\;+\\;B\\;->\\notvalidcommand}',
[ 'usemhchem' => true, 'oldmhchem' => true ] );
$this->assertEquals( 'F', $result['status'], $message );
}
}