5357695270
composer: * mediawiki/mediawiki-codesniffer: 36.0.0 → 37.0.0 The following sniffs now pass and were enabled: * Generic.ControlStructures.InlineControlStructure * MediaWiki.PHPUnit.AssertCount.NotUsed npm: * svgo: 2.3.0 → 2.3.1 * https://npmjs.com/advisories/1754 (CVE-2021-33587) Change-Id: I2a9bbee2fecbf7259876d335f565ece4b3622426
93 lines
2.7 KiB
PHP
93 lines
2.7 KiB
PHP
<?php
|
|
|
|
namespace MediaWiki\Tests\Maintenance;
|
|
|
|
use Maintenance;
|
|
use MediaWikiIntegrationTestCase;
|
|
use Wikimedia\TestingAccessWrapper;
|
|
|
|
abstract class MaintenanceBaseTestCase extends MediaWikiIntegrationTestCase {
|
|
|
|
/**
|
|
* The main Maintenance instance that is used for testing, wrapped and mockable.
|
|
*
|
|
* @var Maintenance
|
|
*/
|
|
protected $maintenance;
|
|
|
|
protected function setUp(): void {
|
|
parent::setUp();
|
|
|
|
$this->maintenance = $this->createMaintenance();
|
|
}
|
|
|
|
/**
|
|
* Do a little stream cleanup to prevent output in case the child class
|
|
* hasn't tested the capture buffer.
|
|
*/
|
|
protected function tearDown(): void {
|
|
if ( $this->maintenance ) {
|
|
$this->maintenance->cleanupChanneled();
|
|
}
|
|
|
|
// This is smelly, but maintenance scripts usually produce output, so
|
|
// we anticipate and ignore with a regex that will catch everything.
|
|
//
|
|
// If you call $this->expectOutputRegex in your subclass, this guard
|
|
// won't be triggered, and your specific pattern will be respected.
|
|
if ( !$this->hasExpectationOnOutput() ) {
|
|
$this->expectOutputRegex( '/.*/' );
|
|
}
|
|
|
|
parent::tearDown();
|
|
}
|
|
|
|
/**
|
|
* Subclasses must implement this in order to use the $this->maintenance
|
|
* variable. Normally, it will be set like:
|
|
* return PopulateDatabaseMaintenance::class;
|
|
*
|
|
* If you need to change the way your maintenance class is constructed,
|
|
* override createMaintenance.
|
|
*
|
|
* @return string Class name
|
|
*/
|
|
abstract protected function getMaintenanceClass();
|
|
|
|
/**
|
|
* Called by setUp to initialize $this->maintenance.
|
|
*
|
|
* @return Maintenance The Maintenance instance to test.
|
|
*/
|
|
protected function createMaintenance() {
|
|
$className = $this->getMaintenanceClass();
|
|
$obj = new $className();
|
|
|
|
// We use TestingAccessWrapper in order to access protected internals
|
|
// such as `output()`.
|
|
return TestingAccessWrapper::newFromObject( $obj );
|
|
}
|
|
|
|
/**
|
|
* Asserts the output before and after simulating shutdown
|
|
*
|
|
* This function simulates shutdown of self::maintenance.
|
|
*
|
|
* @param string $preShutdownOutput Expected output before simulating shutdown
|
|
* @param bool $expectNLAppending Whether or not shutdown simulation is expected
|
|
* to add a newline to the output. If false, $preShutdownOutput is the
|
|
* expected output after shutdown simulation. Otherwise,
|
|
* $preShutdownOutput with an appended newline is the expected output
|
|
* after shutdown simulation.
|
|
*/
|
|
protected function assertOutputPrePostShutdown( $preShutdownOutput, $expectNLAppending ) {
|
|
$this->assertEquals( $preShutdownOutput, $this->getActualOutput(),
|
|
"Output before shutdown simulation" );
|
|
|
|
$this->maintenance->cleanupChanneled();
|
|
|
|
$postShutdownOutput = $preShutdownOutput . ( $expectNLAppending ? "\n" : "" );
|
|
$this->expectOutputString( $postShutdownOutput );
|
|
}
|
|
|
|
}
|