wiki.techinc.nl/tests/phpunit/includes/SampleTest.php
Tim Starling 8212527dfe Fix hang of ApiMainTest
If I try to run ApiMainTest with GlobalPreferences enabled, it takes
forever (or at least some number of minutes) to run. This is because
when @depends is used to transfer data from one test to another via
the return value, PHPUnit runs Enumerator::enumerate() on the data. When
it contains a reference to the active TestCase, PHPUnit ends up
iterating through its internal data structures, which takes a long time.

My conclusion is that @depends with a return value should be considered
harmful. Stop doing it in ApiMainTest. Stop recommending it in
SampleTest.

Change-Id: I63e94f2886a4ee4b3fd0ea6b19cd2fb67ba912de
2020-12-16 15:39:19 +11:00

84 lines
2.6 KiB
PHP

<?php
/**
* @coversNothing Just a sample
*/
class SampleTest extends MediaWikiLangTestCase {
/**
* Anything that needs to happen before your tests should go here.
*/
protected function setUp() : void {
// Be sure to call the parent setup and teardown functions.
// This makes sure that all the various cleanup and restorations
// happen as they should (including the restoration for setMwGlobals).
parent::setUp();
// This sets the globals and will restore them automatically
// after each test.
$this->setContentLang( 'en' );
$this->setMwGlobals( [
'wgCapitalLinks' => true,
] );
}
/**
* Anything cleanup you need to do should go here.
*/
protected function tearDown() : void {
parent::tearDown();
}
/**
* Name tests so that PHPUnit can turn them into sentences when
* they run. You are encouraged to use the naming described at:
* https://phpunit.de/manual/6.5/en/other-uses-for-tests.html
*/
public function testTitleObjectStringConversion() {
$title = Title::newFromText( "text" );
$this->assertInstanceOf( Title::class, $title, "Title creation" );
$this->assertEquals( "Text", $title, "Automatic string conversion" );
$title = Title::newFromText( "text", NS_MEDIA );
$this->assertEquals( "Media:Text", $title, "Title creation with namespace" );
}
/**
* If you want to run the same test with a variety of data, use a data provider.
* See https://phpunit.de/manual/6.5/en/writing-tests-for-phpunit.html
*/
public static function provideTitles() {
return [
[ 'Text', NS_MEDIA, 'Media:Text' ],
[ 'Text', null, 'Text' ],
[ 'text', null, 'Text' ],
[ 'Text', NS_USER, 'User:Text' ],
[ 'Photo.jpg', NS_FILE, 'File:Photo.jpg' ]
];
}
/**
* phpcs:disable Generic.Files.LineLength
* @dataProvider provideTitles
* See https://phpunit.de/manual/6.5/en/appendixes.annotations.html#appendixes.annotations.dataProvider
* phpcs:enable
*/
public function testCreateBasicListOfTitles( $titleName, $ns, $text ) {
$title = Title::newFromText( $titleName, $ns );
$this->assertEquals( $text, "$title", "see if '$titleName' matches '$text'" );
}
/**
* Instead of putting a bunch of tests in a single test method,
* you should put only one or two tests in each test method. This
* way, the test method names can remain descriptive.
*/
/**
* See https://phpunit.de/manual/6.5/en/writing-tests-for-phpunit.html#writing-tests-for-phpunit.exceptions
*/
public function testTitleObjectFromObject() {
$this->expectException( InvalidArgumentException::class );
Title::newFromText( Title::newFromText( "test" ) );
}
}