wiki.techinc.nl/tests/phpunit/unit/includes/Storage/EditResultTest.php

<?php

namespace MediaWiki\Tests\Storage;

use MediaWiki\Json\FormatJson;
use MediaWiki\Storage\EditResult;
use MediaWikiUnitTestCase;

/**
 * @covers \MediaWiki\Storage\EditResult
 */
class EditResultTest extends MediaWikiUnitTestCase {

	public static function provideIsRevertEditResults() {
		return [
			'a new page' => [
				new EditResult(
					true,
					false,
					null,
					null,
					null,
					false,
					false,
					[]
				),
				false
			],
			'a regular edit, not a revert' => [
				new EditResult(
					false,
					false,
					null,
					null,
					null,
					false,
					false,
					[]
				),
				false
			],
			'a revert' => [
				new EditResult(
					false,
					1,
					EditResult::REVERT_ROLLBACK,
					2,
					2,
					true,
					false,
					[ 'mw-rollback' ]
				),
				true
			]
		];
	}

	/**
	 * @covers \MediaWiki\Storage\EditResult::isRevert()
	 * @dataProvider provideIsRevertEditResults
	 */
	public function testIsRevert( EditResult $er, bool $isRevert ) {
		$this->assertSame( $isRevert, $er->isRevert(), 'isRevert()' );
	}

	public static function provideGetRevertMethodEditResults() {
		return [
			'an undo' => [
				new EditResult(
					false,
					false,
					EditResult::REVERT_UNDO,
					1,
					1,
					false,
					false,
					[ 'mw-undo' ]
				),
				EditResult::REVERT_UNDO,
				[ 'mw-undo' ]
			],
			'a rollback' => [
				new EditResult(
					false,
					false,
					EditResult::REVERT_ROLLBACK,
					1,
					1,
					false,
					false,
					[ 'mw-rollback' ]
				),
				EditResult::REVERT_ROLLBACK,
				[ 'mw-rollback' ]
			],
			'not a revert' => [
				new EditResult(
					false,
					false,
					null,
					null,
					null,
					false,
					false,
					[]
				),
				null,
				[]
			],
			'manual revert without an explicit revert mode' => [
				new EditResult(
					false,
					false,
					EditResult::REVERT_MANUAL,
					1,
					1,
					false,
					false,
					[]
				),
				EditResult::REVERT_MANUAL,
				[]
			]
		];
	}

	/**
	 * @covers \MediaWiki\Storage\EditResult::getRevertMethod()
	 * @covers \MediaWiki\Storage\EditResult::getRevertTags()
	 * @dataProvider provideGetRevertMethodEditResults
	 *
	 * @param EditResult $er
	 * @param int|null $revertMethod
	 * @param string[] $tags
	 */
	public function testGetRevertMethodAndTags( EditResult $er, ?int $revertMethod, array $tags ) {
		$this->assertSame( $revertMethod, $er->getRevertMethod(), 'getRevertMethod()' );
		$this->assertArrayEquals( $tags, $er->getRevertTags(), 'getRevertTags()' );
	}

	public static function provideGetUndidRevIdEditResults() {
		return [
			// an undo, should return the oldest undid revision ID
			'an undo' => [
				new EditResult(
					false,
					false,
					EditResult::REVERT_UNDO,
					123,
					125,
					false,
					false,
					[ 'mw-undo' ]
				),
				123
			],
			// a revert, but not an undo, should return 0
			'a rollback' => [
				new EditResult(
					false,
					100,
					EditResult::REVERT_ROLLBACK,
					123,
					123,
					true,
					false,
					[ 'mw-rollback' ]
				),
				0
			],
			'not a revert' => [
				new EditResult(
					false,
					false,
					null,
					null,
					null,
					false,
					false,
					[]
				),
				0
			]
		];
	}

	/**
	 * @covers \MediaWiki\Storage\EditResult::getUndidRevId()
	 * @dataProvider provideGetUndidRevIdEditResults
	 * @param EditResult $er
	 * @param int|null $undidRevId
	 */
	public function testGetUndidRevId( EditResult $er, ?int $undidRevId ) {
		$this->assertSame( $undidRevId, $er->getUndidRevId(), 'getUndidRevId()' );
	}

	public static function provideSerialization() {
		yield 'page creation' => [
			new EditResult(
				true,
				false,
				null,
				null,
				null,
				false,
				false,
				[]
			)
		];
		yield 'rollback' => [
			new EditResult(
				false,
				100,
				EditResult::REVERT_ROLLBACK,
				120,
				150,
				true,
				false,
				[ 'mw-rollback' ]
			)
		];
	}

	/**
	 * @covers \MediaWiki\Storage\EditResult::jsonSerialize()
	 * @covers \MediaWiki\Storage\EditResult::newFromArray
	 * @dataProvider provideSerialization
	 */
	public function testSerialization( EditResult $editResult ) {
		$serialized = FormatJson::encode( $editResult );

		$deserializedArray = FormatJson::decode( $serialized, true );
		$this->assertSame(
			'1',
			$deserializedArray['version'],
			'"version" key is present and set correctly'
		);

		$deserialized = EditResult::newFromArray( $deserializedArray );

		$this->assertSame( $editResult->isNew(), $deserialized->isNew(), 'isNew()' );
		$this->assertSame(
			$editResult->getOriginalRevisionId(),
			$deserialized->getOriginalRevisionId(),
			'getOriginalRevisionId()'
		);
		$this->assertSame(
			$editResult->getRevertMethod(),
			$deserialized->getRevertMethod(),
			'getRevertMethod()'
		);
		$this->assertSame(
			$editResult->getOldestRevertedRevisionId(),
			$deserialized->getOldestRevertedRevisionId(),
			'getOldestRevertedRevisionId()'
		);
		$this->assertSame(
			$editResult->getNewestRevertedRevisionId(),
			$deserialized->getNewestRevertedRevisionId(),
			'getNewestRevertedRevisionId()'
		);
		$this->assertSame(
			$editResult->isExactRevert(),
			$deserialized->isExactRevert(),
			'isExactRevert()'
		);
		$this->assertSame(
			$editResult->isNullEdit(),
			$deserialized->isNullEdit(),
			'isNullEdit()'
		);
		$this->assertArrayEquals(
			$editResult->getRevertTags(),
			$deserialized->getRevertTags(),
			false,
			false,
			'getRevertTags()'
		);
	}
}