a5a04f56bd
We introduced a new type for "ParserTestMode" and then uniformly pass this around alongside the ParserTest object itself. (We started by using a string for the $mode but the "explicit changetree" mode requires more structured data. We *could* encode this in JSON just to keep the string type around, but it seems cleaner and more future proof to wrap this in a proper class type.) Removed the old TestFileReader wrapper class, which served only as a thunk to convert the new Test class into the same sort of array which the legacy parser test runner code expected. There's still some remaining ::testToArray() usage here for the TestRecorder framework, but that will be cleaned up in a future patch. Also updated the TestRecorder with stronger types: use the same <Test,TestMode> pair when invoking the TestRecorder, instead of the loosely typed array we'd used previously. Change-Id: Iec4c0c7972a655b4faccacc67bdc3ca66d4c163d
103 lines
2.6 KiB
PHP
103 lines
2.6 KiB
PHP
<?php
|
|
/**
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
* http://www.gnu.org/copyleft/gpl.html
|
|
*
|
|
* @file
|
|
* @ingroup Testing
|
|
*/
|
|
|
|
use MediaWiki\Tests\TestMode as ParserTestMode;
|
|
use Wikimedia\Parsoid\ParserTests\Test as ParserTest;
|
|
|
|
/**
|
|
* Interface to record parser test results.
|
|
*
|
|
* The TestRecorder is an class hierarchy to record the result of
|
|
* MediaWiki parser tests. One should call start() before running the
|
|
* full parser tests and end() once all the tests have been finished.
|
|
* After each test, you should use record() to keep track of your tests
|
|
* results. Finally, report() is used to generate a summary of your
|
|
* test run, one could dump it to the console for human consumption or
|
|
* register the result in a database for tracking purposes.
|
|
*
|
|
* @since 1.22
|
|
*/
|
|
class TestRecorder {
|
|
|
|
/**
|
|
* Called at beginning of the parser test run
|
|
*/
|
|
public function start() {
|
|
}
|
|
|
|
/**
|
|
* Called before starting a test
|
|
* @param ParserTest $test
|
|
* @param ParserTestMode $mode
|
|
*/
|
|
public function startTest( ParserTest $test, ParserTestMode $mode ) {
|
|
}
|
|
|
|
/**
|
|
* Called before starting an input file
|
|
* @param string $path
|
|
*/
|
|
public function startSuite( string $path ) {
|
|
}
|
|
|
|
/**
|
|
* Called after ending an input file
|
|
* @param string $path
|
|
*/
|
|
public function endSuite( string $path ) {
|
|
}
|
|
|
|
/**
|
|
* Called after each test
|
|
* @param ParserTestResult $result
|
|
*/
|
|
public function record( ParserTestResult $result ) {
|
|
}
|
|
|
|
/**
|
|
* Show a warning to the user
|
|
* @param string $message
|
|
*/
|
|
public function warning( string $message ) {
|
|
}
|
|
|
|
/**
|
|
* Mark a test skipped
|
|
* @param ParserTest $test
|
|
* @param ParserTestMode $mode
|
|
* @param string $reason
|
|
*/
|
|
public function skipped( ParserTest $test, ParserTestMode $mode, string $reason ) {
|
|
}
|
|
|
|
/**
|
|
* Called before finishing the test run
|
|
*/
|
|
public function report() {
|
|
}
|
|
|
|
/**
|
|
* Called at the end of the parser test run
|
|
*/
|
|
public function end() {
|
|
}
|
|
|
|
}
|