wiki.techinc.nl/tests/phpunit/includes/diff/DifferenceEngineTest.php
Arthur Taylor 5ab72270e5 Make DifferenceEngineTest run standalone
When running in a CI / Quibble context, this test class was
failing - it relies on other classes in the suite already having
initialised OOUI.

Explicitly enable OOUI in this test to avoid the failure mode.

Bug: T363797
Change-Id: I63c65d32b32f6e47b2b1900e819b58b9bbfe30c3
2024-04-30 09:45:39 +02:00

768 lines
22 KiB
PHP

<?php
use MediaWiki\Config\HashConfig;
use MediaWiki\Context\DerivativeContext;
use MediaWiki\Context\RequestContext;
use MediaWiki\MainConfigNames;
use MediaWiki\Output\OutputPage;
use MediaWiki\Permissions\SimpleAuthority;
use MediaWiki\Request\FauxRequest;
use MediaWiki\Revision\MutableRevisionRecord;
use MediaWiki\Revision\RevisionRecord;
use MediaWiki\Revision\SlotRecord;
use MediaWiki\Title\Title;
use MediaWiki\User\UserIdentityValue;
/**
* @covers \DifferenceEngine
*
* @todo tests for the rest of DifferenceEngine!
*
* @group Database
* @group Diff
*
* @author Katie Filbert < aude.wiki@gmail.com >
*/
class DifferenceEngineTest extends MediaWikiIntegrationTestCase {
use MockTitleTrait;
protected $context;
private static $revisions;
protected function setUp(): void {
parent::setUp();
$title = $this->getTitle();
$this->context = new RequestContext();
$this->context->setTitle( $title );
$this->overrideConfigValue( MainConfigNames::DiffEngine, 'php' );
$slotRoleRegistry = $this->getServiceContainer()->getSlotRoleRegistry();
if ( !$slotRoleRegistry->isDefinedRole( 'derivedslot' ) ) {
$slotRoleRegistry->defineRoleWithModel(
'derivedslot',
CONTENT_MODEL_WIKITEXT,
[],
true
);
}
}
public function addDBDataOnce() {
self::$revisions = $this->doEdits();
}
/**
* @return Title
*/
protected function getTitle() {
$namespace = $this->getDefaultWikitextNS();
return Title::makeTitle( $namespace, 'Kitten' );
}
/**
* @return int[] Revision ids
*/
protected function doEdits() {
$title = $this->getTitle();
$strings = [
0 => "no kittens",
1 => "one kitten",
2 => "two kittens",
3 => "three kittens",
4 => "fnord kittens",
5 => "kitten's phone number is +1 303 503 229",
6 => "six kittens",
7 => "seven kittens",
];
$revisions = [];
$sysop = $this->getTestSysop()->getAuthority();
$user = $this->getTestUser()->getAuthority();
foreach ( $strings as $i => $string ) {
$status = $this->editPage(
$title,
$string,
'edit page',
NS_MAIN,
$i == 6 ? $user : $sysop
);
$revisions[] = $status->getNewRevision()->getId();
}
// Normal user cannot see the fnord
$this->revisionDelete(
$revisions[4],
[
RevisionRecord::DELETED_TEXT => 1,
],
'Testing'
);
// Suppress kitten dox
$this->revisionDelete(
$revisions[5],
[
RevisionRecord::DELETED_TEXT => 1,
RevisionRecord::DELETED_RESTRICTED => 1,
],
'Testing'
);
return $revisions;
}
private function expandData( $data ) {
if ( is_array( $data ) ) {
foreach ( $data as &$value ) {
$value = $this->expandData( $value );
}
} elseif ( is_string( $data ) ) {
$data = preg_replace_callback(
'/rev\[([0-9]+)]/',
static function ( $m ) {
return self::$revisions[(int)$m[1]];
},
$data
);
$data = str_replace(
'rev[cur]',
self::$revisions[array_key_last( self::$revisions )],
$data
);
}
return $data;
}
private function expandTestArgs( $args ) {
foreach ( $args as &$arg ) {
$arg = $this->expandData( $arg );
}
}
/**
* @dataProvider provideMapDiffPrevNext
*/
public function testMapDiffPrevNext( $expected, $old, $new, $message ) {
$this->expandTestArgs( [ &$expected, &$old, &$new, &$message ] );
$diffEngine = new DifferenceEngine( $this->context, $old, $new, 2, true, false );
$diffMap = $diffEngine->mapDiffPrevNext( $old, $new );
$this->assertEquals( $expected, $diffMap, $message );
}
public static function provideMapDiffPrevNext() {
return [
[ [ 'rev[1]', 'rev[2]' ], 'rev[2]', 'prev', 'diff=prev' ],
[ [ 'rev[2]', 'rev[3]' ], 'rev[2]', 'next', 'diff=next' ],
[ [ 'rev[1]', 'rev[3]' ], 'rev[1]', 'rev[3]', 'diff=rev3' ]
];
}
/**
* @dataProvider provideLoadRevision
*/
public function testLoadRevisionData( $expectedOld, $expectedNew, $expectedRet, $old, $new ) {
$this->expandTestArgs( [ &$expectedOld, &$expectedNew, &$expectedRet, &$old, &$new ] );
$diffEngine = new DifferenceEngine( $this->context, $old, $new, 2, true, false );
$ret = $diffEngine->loadRevisionData();
$ret2 = $diffEngine->loadRevisionData();
$this->assertEquals( $expectedOld, $diffEngine->getOldid() );
$this->assertEquals( $expectedNew, $diffEngine->getNewid() );
$this->assertEquals( $expectedRet, $ret );
$this->assertEquals( $expectedRet, $ret2 );
}
public static function provideLoadRevision() {
return [
'diff=prev' => [ 'rev[2]', 'rev[3]', true, 'rev[3]', 'prev' ],
'diff=next' => [ 'rev[2]', 'rev[3]', true, 'rev[2]', 'next' ],
'diff=rev[3]' => [ 'rev[1]', 'rev[3]', true, 'rev[1]', 'rev[3]' ],
'diff=0' => [ 'rev[1]', 'rev[cur]', true, 'rev[1]', 0 ],
'diff=prev&oldid=<first>' => [ false, 'rev[0]', true, 'rev[0]', 'prev' ],
'invalid' => [ 123456789, 'rev[1]', false, 123456789, 'rev[1]' ],
];
}
public function testGetOldid() {
$revs = self::$revisions;
$diffEngine = new DifferenceEngine( $this->context, $revs[1], $revs[2], 2, true, false );
$this->assertEquals( $revs[1], $diffEngine->getOldid(), 'diff get old id' );
}
public function testGetNewid() {
$revs = self::$revisions;
$diffEngine = new DifferenceEngine( $this->context, $revs[1], $revs[2], 2, true, false );
$this->assertEquals( $revs[2], $diffEngine->getNewid(), 'diff get new id' );
}
/**
* @dataProvider provideGenerateContentDiffBody
*/
public function testGenerateContentDiffBody(
array $oldContentArgs, array $newContentArgs, $expectedDiff
) {
$this->mergeMwGlobalArrayValue( 'wgContentHandlers', [
'testing-nontext' => DummyNonTextContentHandler::class,
] );
$oldContent = ContentHandler::makeContent( ...$oldContentArgs );
$newContent = ContentHandler::makeContent( ...$newContentArgs );
$differenceEngine = new DifferenceEngine();
$diff = $differenceEngine->generateContentDiffBody( $oldContent, $newContent );
$this->assertSame( $expectedDiff, $this->getPlainDiff( $diff ) );
}
public static function provideGenerateContentDiffBody() {
$content1 = [ 'xxx', null, CONTENT_MODEL_TEXT ];
$content2 = [ 'yyy', null, CONTENT_MODEL_TEXT ];
return [
'self-diff' => [ $content1, $content1, '' ],
'text diff' => [ $content1, $content2, '-xxx+yyy' ],
];
}
public function testGenerateTextDiffBody() {
$oldText = "aaa\nbbb\nccc";
$newText = "aaa\nxxx\nccc";
$expectedDiff = " aaa aaa\n-bbb+xxx\n ccc ccc";
$differenceEngine = new DifferenceEngine();
$diff = $differenceEngine->generateTextDiffBody( $oldText, $newText );
$this->assertSame( $expectedDiff, $this->getPlainDiff( $diff ) );
}
public function testSetContent() {
$oldContent = ContentHandler::makeContent( 'xxx', null, CONTENT_MODEL_TEXT );
$newContent = ContentHandler::makeContent( 'yyy', null, CONTENT_MODEL_TEXT );
$differenceEngine = new DifferenceEngine();
$differenceEngine->setContent( $oldContent, $newContent );
$diff = $differenceEngine->getDiffBody();
$this->assertSame( "Line 1:\nLine 1:\n-xxx+yyy", $this->getPlainDiff( $diff ) );
}
public function testSetRevisions() {
$rev1 = $this->getRevisionRecord( [ SlotRecord::MAIN => 'xxx' ] );
$rev2 = $this->getRevisionRecord( [ SlotRecord::MAIN => 'yyy' ] );
$differenceEngine = new DifferenceEngine();
$differenceEngine->setRevisions( $rev1, $rev2 );
$this->assertSame( $rev1, $differenceEngine->getOldRevision() );
$this->assertSame( $rev2, $differenceEngine->getNewRevision() );
$this->assertSame( true, $differenceEngine->loadRevisionData() );
$this->assertSame( true, $differenceEngine->loadText() );
$differenceEngine->setRevisions( null, $rev2 );
$this->assertSame( null, $differenceEngine->getOldRevision() );
}
/**
* @dataProvider provideGetDiffBody
*/
public function testGetDiffBody(
?array $oldSlots, ?array $newSlots, $slotDiffOptions, $expectedDiff
) {
$oldRevision = $this->getRevisionRecord( $oldSlots );
$newRevision = $this->getRevisionRecord( $newSlots );
if ( $expectedDiff instanceof Exception ) {
$this->expectException( get_class( $expectedDiff ) );
$this->expectExceptionMessage( $expectedDiff->getMessage() );
}
$differenceEngine = new DifferenceEngine();
$differenceEngine->setRevisions( $oldRevision, $newRevision );
if ( $slotDiffOptions !== null ) {
$differenceEngine->setSlotDiffOptions( $slotDiffOptions );
}
if ( $expectedDiff instanceof Exception ) {
return;
}
$diff = $differenceEngine->getDiffBody();
$this->assertSame( $expectedDiff, $this->getPlainDiff( $diff ) );
}
public static function provideGetDiffBody() {
$main1 = [ SlotRecord::MAIN => 'xxx' ];
$main2 = [ SlotRecord::MAIN => 'yyy' ];
$slot1 = [ 'slot' => 'aaa' ];
$slot2 = [ 'slot' => 'bbb' ];
$slot3 = [ 'derivedslot' => [ 'text' => 'aaa', 'derived' => true ] ];
$slot4 = [ 'derivedslot' => [ 'text' => 'bbb', 'derived' => true ] ];
$slot5 = [ 'slot' => [ 'model' => 'testing' ] ];
return [
'revision vs. null' => [
null,
$main1 + $slot1,
null,
'',
],
'revision vs. itself' => [
$main1 + $slot1,
$main1 + $slot1,
null,
'',
],
'different text in one slot' => [
$main1 + $slot1,
$main1 + $slot2,
null,
"slotLine 1:\nLine 1:\n-aaa+bbb",
],
'different text in two slots' => [
$main1 + $slot1,
$main2 + $slot2,
null,
"Line 1:\nLine 1:\n-xxx+yyy\nslotLine 1:\nLine 1:\n-aaa+bbb",
],
'new slot' => [
$main1,
$main1 + $slot1,
null,
"slotLine 1:\nLine 1:\n- +aaa",
],
'ignored difference in derived slot' => [
$main1 + $slot3,
$main1 + $slot4,
null,
'',
],
'incompatible slot' => [
$main1 + $slot5,
$main2 + $slot1,
null,
"Line 1:\nLine 1:\n-xxx+yyy\nslotCannot compare content models \"testing\" and \"plain text\"",
],
'invalid diff-type' => [
$main1,
$main2,
[ 'diff-type' => 'invalid' ],
"Line 1:\nLine 1:\n-xxx+yyy",
]
];
}
public function testRecursion() {
// Set up a ContentHandler which will return a wrapped DifferenceEngine as
// SlotDiffRenderer, then pass it a content which uses the same ContentHandler.
// This tests the anti-recursion logic in DifferenceEngine::generateContentDiffBody.
$customDifferenceEngine = $this->getMockBuilder( DifferenceEngine::class )
->enableProxyingToOriginalMethods()
->getMock();
$customContentHandler = $this->getMockBuilder( ContentHandler::class )
->setConstructorArgs( [ 'foo', [] ] )
->onlyMethods( [ 'createDifferenceEngine' ] )
->getMockForAbstractClass();
$customContentHandler->method( 'createDifferenceEngine' )
->willReturn( $customDifferenceEngine );
/** @var ContentHandler $customContentHandler */
$customContent = $this->getMockBuilder( Content::class )
->onlyMethods( [ 'getContentHandler' ] )
->getMockForAbstractClass();
$customContent->method( 'getContentHandler' )
->willReturn( $customContentHandler );
/** @var Content $customContent */
$customContent2 = clone $customContent;
$slotDiffRenderer = $customContentHandler->getSlotDiffRenderer( RequestContext::getMain() );
$this->expectException( Exception::class );
$this->expectExceptionMessage(
': could not maintain backwards compatibility. Please use a SlotDiffRenderer.'
);
$slotDiffRenderer->getDiff( $customContent, $customContent2 );
}
/**
* @dataProvider provideMarkPatrolledLink
*/
public function testMarkPatrolledLink( $group, $config, $expectedResult ) {
$this->setUserLang( 'qqx' );
$user = $this->getTestUser( $group )->getUser();
$this->context->setUser( $user );
if ( $config ) {
$this->context->setConfig( new HashConfig( $config ) );
}
$page = $this->getNonexistingTestPage( 'Page1' );
$this->assertStatusGood( $this->editPage( $page, 'Edit1' ), 'edited a page' );
$rev1 = $page->getRevisionRecord();
$this->assertStatusGood( $this->editPage( $page, 'Edit2' ), 'edited a page' );
$rev2 = $page->getRevisionRecord();
$diffEngine = new DifferenceEngine( $this->context );
$diffEngine->setRevisions( $rev1, $rev2 );
$html = $diffEngine->markPatrolledLink();
$this->assertStringContainsString( $expectedResult, $html );
}
public static function provideMarkPatrolledLink() {
yield 'PatrollingEnabledUserAllowed' => [
'sysop',
[ MainConfigNames::UseRCPatrol => true, MainConfigNames::LanguageCode => 'qxx' ],
'Mark as patrolled'
];
yield 'PatrollingEnabledUserNotAllowed' => [
null,
[ MainConfigNames::UseRCPatrol => true, MainConfigNames::LanguageCode => 'qxx' ],
''
];
yield 'PatrollingDisabledUserAllowed' => [
'sysop',
null,
''
];
yield 'PatrollingDisabledUserNotAllowed' => [
null,
null,
''
];
}
/**
* Convert a HTML diff to a human-readable format and hopefully make the test less fragile.
* @param string $diff
* @return string
*/
private function getPlainDiff( $diff ) {
$replacements = [
html_entity_decode( '&nbsp;' ) => ' ',
html_entity_decode( '&minus;' ) => '-',
];
// Preserve markers when stripping tags
$diff = str_replace( '<td class="diff-marker"></td>', ' ', $diff );
$diff = str_replace( '<td colspan="2"></td>', ' ', $diff );
$diff = preg_replace( '/data-marker="([^"]*)">/', '>$1', $diff );
return str_replace( array_keys( $replacements ), array_values( $replacements ),
trim( strip_tags( $diff ), "\n" ) );
}
/**
* @param string[]|array[]|null $slots Array mapping slot role to content.
* If the content is a string, a normal text slot will be created. If the
* content is an associative array, it can have the following keys:
* - derived: If present and true, the slot is a derived slot
* - text: The serialized content
* - model: The content model ID
* @return MutableRevisionRecord|null
*/
private function getRevisionRecord( $slots ) {
if ( $slots === null ) {
return null;
}
$contentHandlerFactory = $this->getServiceContainer()->getContentHandlerFactory();
$title = $this->makeMockTitle( __CLASS__ );
$revision = new MutableRevisionRecord( $title );
foreach ( $slots as $role => $info ) {
if ( is_string( $info ) ) {
$info = [
'text' => $info,
];
}
$info += [ 'text' => '', 'model' => CONTENT_MODEL_TEXT ];
if ( !$contentHandlerFactory->isDefinedModel( $info['model'] ) ) {
$contentHandlerFactory->defineContentHandler(
$info['model'], DummyContentHandlerForTesting::class );
}
$content = ContentHandler::makeContent( $info['text'], null, $info['model'] );
if ( $info['derived'] ?? false ) {
$slotRecord = SlotRecord::newDerived( $role, $content );
} else {
$slotRecord = SlotRecord::newUnsaved( $role, $content );
}
$revision->setSlot( $slotRecord );
}
return $revision;
}
/**
* @dataProvider provideRevisionHeader
*/
public function testRevisionHeader( $deletedFlag, $allowedAction ) {
$revs = self::$revisions;
if ( $deletedFlag === 'none' ) {
$oldRevId = $revs[1];
} elseif ( $deletedFlag === 'deleted' ) {
$oldRevId = $revs[4];
} elseif ( $deletedFlag === 'suppressed' ) {
$oldRevId = $revs[5];
}
$context = new DerivativeContext( $this->context );
$context->setLanguage( 'qqx' );
$permissionSet = [];
if ( $allowedAction !== 'none' ) {
if ( $allowedAction === 'edit' ) {
$permissionSet[] = 'edit';
}
if ( $deletedFlag === 'suppressed' ) {
$permissionSet[] = 'suppressrevision';
} else {
$permissionSet[] = 'deletedtext';
}
}
$context->setAuthority(
new SimpleAuthority( $this->getTestUser()->getUser(), $permissionSet )
);
$diffEngine = new DifferenceEngine( $context, $oldRevId, $revs[2], 2, true, true );
$this->assertTrue( $diffEngine->loadRevisionData() );
$revisionHeaderHtml = $diffEngine->getRevisionHeader( $diffEngine->getOldRevision(), 'complete' );
// Always show the timestamp
$this->assertStringContainsString( '(revisionasof:', $revisionHeaderHtml );
if ( $allowedAction === 'none' ) {
$this->assertStringNotContainsString( 'oldid=' . $oldRevId, $revisionHeaderHtml );
} else {
$this->assertStringContainsString( 'oldid=' . $oldRevId, $revisionHeaderHtml );
}
if ( $allowedAction === 'edit' ) {
$this->assertStringContainsString( '(editold)', $revisionHeaderHtml );
} else {
$this->assertStringNotContainsString( '(editold)', $revisionHeaderHtml );
}
if ( $allowedAction === 'view' ) {
$this->assertStringContainsString( '(viewsourceold)', $revisionHeaderHtml );
} else {
$this->assertStringNotContainsString( '(viewsourceold)', $revisionHeaderHtml );
}
if ( $deletedFlag === 'none' ) {
$this->assertStringNotContainsString( 'history-deleted', $revisionHeaderHtml );
} else {
$this->assertStringContainsString( 'history-deleted', $revisionHeaderHtml );
}
if ( $deletedFlag === 'suppressed' ) {
$this->assertStringContainsString( 'mw-history-suppressed', $revisionHeaderHtml );
} else {
$this->assertStringNotContainsString( 'mw-history-suppressed', $revisionHeaderHtml );
}
}
public static function provideRevisionHeader() {
return [
[ 'none', 'view' ],
[ 'none', 'edit' ],
[ 'deleted', 'none' ],
[ 'deleted', 'view' ],
[ 'deleted', 'edit' ],
[ 'suppressed', 'none' ],
[ 'suppressed', 'view' ],
[ 'suppressed', 'edit' ],
];
}
/**
* @dataProvider provideShowDiffPage
* @param array $reqParams
* @param array $userRights
* @param array $expected
*/
public function testShowDiffPage( $reqParams, $userRights, $expected ) {
$this->expandTestArgs( [ &$reqParams, &$expected ] );
$context = new DerivativeContext( $this->context );
$authority = new SimpleAuthority(
new UserIdentityValue( 1, 'User' ),
$userRights
);
$context->setAuthority( $authority );
$request = new FauxRequest( $reqParams );
$context->setRequest( $request );
$context->setLanguage( 'qqx' );
$out = new OutputPage( $context );
$out->enableOOUI();
$context->setOutput( $out );
$engine = new DifferenceEngine(
$context,
$request->getIntOrNull( 'oldid' ),
$request->getVal( 'diff' ),
0,
false,
$request->getInt( 'unhide' ) === 1
);
if ( isset( $expected['exception'] ) ) {
$this->expectException( $expected['exception'] );
}
$engine->showDiffPage( $request->getBool( 'diffonly' ) );
if ( isset( $expected['html'] ) ) {
$this->assertMatchesRegularExpression(
'{' . $expected['html'] . '}s',
$out->getHTML(),
'OutputPage::getHTML'
);
}
}
public static function provideShowDiffPage() {
$cases = [
'missing oldid' => [
'params' => [
'oldid' => '1000000',
'diff' => 'prev',
],
'expected' => [
'html' => '\(difference-missing-revision: 1000000, 1\)',
]
],
'missing prev' => [
'params' => [
'oldid' => 'rev[0]',
'diff' => 'prev'
],
'expected' => [
'html' =>
'\(diff-empty\).*' .
'<div class="mw-content-ltr mw-parser-output" lang="en" dir="ltr"><p>no kittens'
],
],
'normal diff=prev' => [
'params' => [
'oldid' => 'rev[1]',
'diff' => 'prev'
],
'expected' => [
'html' =>
'\(viewsourceold\).*' .
'<del class="diffchange diffchange-inline">no kittens</del>.*' .
'<ins class="diffchange diffchange-inline">one kitten</ins>.*' .
'<div class="mw-content-ltr mw-parser-output" lang="en" dir="ltr"><p>one kitten',
]
],
'normal diff=number' => [
'params' => [
'oldid' => 'rev[0]',
'diff' => 'rev[1]'
],
'expected' => [
'html' =>
'\(viewsourceold\).*' .
'<del class="diffchange diffchange-inline">no kittens</del>.*' .
'<ins class="diffchange diffchange-inline">one kitten</ins>.*' .
'<div class="mw-content-ltr mw-parser-output" lang="en" dir="ltr"><p>one kitten',
]
],
'user cannot read' => [
'params' => [
'oldid' => 'rev[1]',
'diff' => 'prev',
],
'userRights' => [],
'expected' => [
'exception' => PermissionsError::class,
]
],
'user can rollback' => [
'params' => [
'oldid' => 'rev[6]',
'diff' => 'rev[7]',
],
'userRights' => [ 'read', 'edit', 'rollback' ],
'expected' => [
'html' =>
'\(editold\).*' .
'\(rollbacklinkcount: 1\)',
]
],
'diffonly' => [
'params' => [
'oldid' => 'rev[1]',
'diff' => 'prev',
'diffonly' => '1',
],
'expected' => [
'html' =>
'<del class="diffchange diffchange-inline">no kittens</del>.*' .
'<ins class="diffchange diffchange-inline">one kitten</ins>.*' .
'</table>$',
]
],
'deleted LHS' => [
'params' => [
'oldid' => 'rev[4]',
'diff' => 'rev[1]'
],
'expected' => [
'html' => '<div id="mw-diff-otitle1">.*' .
'<span class="history-deleted">.*' .
'<div id="mw-diff-ntitle1">.*' .
'\(rev-deleted-no-diff\)',
]
],
'deleted RHS' => [
'params' => [
'oldid' => 'rev[3]',
'diff' => 'rev[4]'
],
'expected' => [
'html' =>
'<div id="mw-diff-otitle1">.*' .
'<div id="mw-diff-ntitle1">.*' .
'<span class="history-deleted">.*' .
'\(rev-deleted-no-diff\)',
]
],
'deleted LHS can unhide' => [
'params' => [
'oldid' => 'rev[4]',
'diff' => 'rev[1]'
],
'userRights' => [ 'read', 'deletedtext' ],
'expected' => [
'html' =>
'<div id="mw-diff-ntitle1">.*' .
'\(rev-deleted-unhide-diff:.*' .
'&amp;unhide=1.*',
]
],
'deleted RHS with unhide' => [
'params' => [
'oldid' => 'rev[3]',
'diff' => 'rev[4]',
'unhide' => '1'
],
'userRights' => [ 'read', 'deletedtext' ],
'expected' => [
'html' =>
'\(rev-deleted-diff-view\).*' .
'<del class="diffchange diffchange-inline">three </del>.*' .
'<ins class="diffchange diffchange-inline">fnord </ins>.*' .
'<div class="mw-content-ltr mw-parser-output" lang="en" dir="ltr"><p>fnord kittens',
]
],
];
foreach ( $cases as $name => $case ) {
yield $name => [
$case['params'],
$case['userRights'] ?? [ 'read' ],
$case['expected']
];
}
}
}