aboutsummaryrefslogtreecommitdiffstats
path: root/tests/phpunit/unit/includes/libs/Message/ScalarParamTest.php
blob: d0a72052d789043ade2422cd8adc48d728f97fbc (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
<?php

namespace Wikimedia\Tests\Message;

use InvalidArgumentException;
use MediaWiki\Json\JsonCodec;
use MediaWikiUnitTestCase;
use stdClass;
use Wikimedia\Message\MessageValue;
use Wikimedia\Message\ParamType;
use Wikimedia\Message\ScalarParam;

/**
 * @covers \Wikimedia\Message\ScalarParam
 */
class ScalarParamTest extends MediaWikiUnitTestCase {
	use MessageSerializationTestTrait;

	public static function getClassToTest(): string {
		return ScalarParam::class;
	}

	public static function provideConstruct() {
		return [
			'num' => [
				[ ParamType::NUM, 1, ],
				'<num>1</num>',
			],
			'plain' => [
				[ ParamType::PLAINTEXT, 'foo & bar', ],
				'<plaintext>foo &amp; bar</plaintext>',
			],
			'text' => [
				[ ParamType::TEXT, new MessageValue( 'key' ), ],
				'<text><message key="key"></message></text>',
			],
			'T377912' => [
				[ ParamType::PLAINTEXT, T377912TestCase::class ],
				'<plaintext>' . T377912TestCase::class . '</plaintext>',
			]
		];
	}

	/** @dataProvider provideConstruct */
	public function testSerialize( $args, $_ ) {
		[ $type, $value ] = $args;
		$codec = new JsonCodec;
		$obj = new ScalarParam( $type, $value );

		$serialized = $codec->serialize( $obj );
		$newObj = $codec->deserialize( $serialized );

		// XXX: would be nice to have a proper ::equals() method.
		$this->assertEquals( $obj->dump(), $newObj->dump() );
	}

	/** @dataProvider provideConstruct */
	public function testConstruct( $args, $expected ) {
		[ $type, $value ] = $args;
		$mp = new ScalarParam( $type, $value );
		$this->assertSame( $type, $mp->getType() );
		$this->assertSame( $value, $mp->getValue() );
		$this->assertSame( $expected, $mp->dump() );
	}

	public function testConstruct_badType() {
		$this->expectException( InvalidArgumentException::class );
		$this->expectExceptionMessage(
			'ParamType::LIST cannot be used with ScalarParam; use ListParam instead'
		);
		new ScalarParam( ParamType::LIST, [] );
	}

	public function testConstruct_badTypeConst() {
		$this->expectException( InvalidArgumentException::class );
		$this->expectExceptionMessage( '$type must be one of the ParamType constants' );
		new ScalarParam( 'invalid', '' );
	}

	public function testConstruct_badValueNULL() {
		$this->assertDeprecation(
			static function () {
				new ScalarParam( ParamType::TEXT, null );
			},
			'Using null as a message parameter was deprecated in MediaWiki 1.43'
		);
	}

	public function assertDeprecation( callable $callback, string $message ) {
		$errorTriggered = false;

		set_error_handler( function ( $errno, $errstr ) use ( $message, &$errorTriggered ) {
			if ( $errno === E_DEPRECATED || $errno === E_USER_DEPRECATED ) {
				$this->assertStringContainsString( $message, $errstr );
				$errorTriggered = true;
				return true;
			}
			return false;
		} );

		try {
			$callback();
		} finally {
			restore_error_handler();
		}

		$this->assertTrue( $errorTriggered, 'Expected deprecation warning was not triggered.' );
	}

	public function testConstruct_badValueClass() {
		$this->expectException( InvalidArgumentException::class );
		$this->expectExceptionMessage(
			'Scalar parameter must be a string, number, Stringable, or MessageSpecifier; got stdClass'
		);
		new ScalarParam( ParamType::TEXT, new stdClass );
	}

}