wiki.techinc.nl/tests/phpunit/unit/includes/dao/WikiAwareEntityTraitTest.php
thiemowmde 52ddf3e8ce Remove all @package comments
I don't think these do anything with the documentation generators
we currently use. Especially not in tests. How are tests part of a
"package" when the code is not?

Note how most of these are simply identical to the namespace. They
are most probably auto-generated by some IDEs but don't actually
mean anything.

Change-Id: I771b5f2041a8e3b077865c79cbebddbe028543d1
2024-05-10 13:53:15 +02:00

116 lines
3 KiB
PHP

<?php
namespace MediaWiki\Tests\Unit\DAO;
use MediaWiki\DAO\WikiAwareEntity;
use MediaWiki\DAO\WikiAwareEntityTrait;
use MediaWikiUnitTestCase;
use Wikimedia\Assert\ParameterAssertionException;
use Wikimedia\Assert\PreconditionException;
use Wikimedia\TestingAccessWrapper;
/**
* @covers \MediaWiki\DAO\WikiAwareEntityTrait
*/
class WikiAwareEntityTraitTest extends MediaWikiUnitTestCase {
/**
* @param string|false $wikiId
* @return WikiAwareEntity
*/
public function getEntityInstance( $wikiId ) {
$entity = new class( $wikiId ) implements WikiAwareEntity {
use WikiAwareEntityTrait;
/** @var string|false */
private $wikiId;
/**
* @param string|false $wikiId
*/
public function __construct( $wikiId ) {
$this->wikiId = $wikiId;
}
public function getWikiId() {
return $this->wikiId;
}
};
return $entity;
}
public static function provideMatchingWikis() {
yield 'acme' => [
'entityWiki' => 'acmewiki',
'assertWiki' => 'acmewiki',
];
yield 'local' => [
'entityWiki' => WikiAwareEntity::LOCAL,
'assertWiki' => WikiAwareEntity::LOCAL,
];
}
public static function provideMismatchingWikis() {
yield 'acme-noacme' => [
'entityWiki' => 'acmewiki',
'assertWiki' => 'noacmewiki',
];
yield 'local-acme' => [
'entityWiki' => WikiAwareEntity::LOCAL,
'assertWiki' => 'acmewiki',
];
yield 'acme-local' => [
'entityWiki' => 'amewiki',
'assertWiki' => WikiAwareEntity::LOCAL,
];
}
/**
* @dataProvider provideMatchingWikis
*/
public function testAssertWiki( $entityWiki, $assertWiki ) {
$this->getEntityInstance( $entityWiki )->assertWiki( $assertWiki );
$this->addToAssertionCount( 1 );
}
/**
* @dataProvider provideMatchingWikis
*/
public function testDeprecateInvalidCrossWiki( $entityWiki, $assertWiki ) {
TestingAccessWrapper::newFromObject( $this->getEntityInstance( $entityWiki ) )
->deprecateInvalidCrossWiki( $assertWiki, '1.99' );
$this->addToAssertionCount( 1 );
}
/**
* @dataProvider provideMismatchingWikis
*/
public function testAssertWikiMismatch( $entityWiki, $assertWiki ) {
$this->expectException( PreconditionException::class );
$this->getEntityInstance( $entityWiki )->assertWiki( $assertWiki );
}
/**
* @dataProvider provideMismatchingWikis
*/
public function testDeprecateInvalidCrossWikiMismatch( $entityWiki, $assertWiki ) {
$this->expectDeprecationAndContinue( '/Deprecated cross-wiki access/' );
TestingAccessWrapper::newFromObject( $this->getEntityInstance( $entityWiki ) )
->deprecateInvalidCrossWiki( $assertWiki, '1.99' );
}
public static function provideAssertWikiIdParamInvalid() {
yield 'true' => [ true ];
yield 'null' => [ null ];
yield 'int' => [ 1 ];
}
/**
* @dataProvider provideAssertWikiIdParamInvalid
*/
public function testAssertWikiIdParamInvalid( $param ) {
$entity = TestingAccessWrapper::newFromObject( $this->getEntityInstance( 'acme' ) );
$this->expectException( ParameterAssertionException::class );
$entity->assertWikiIdParam( $param );
}
}