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
|
<?php
namespace MediaWiki\Tests\Parser;
use MediaWiki\Logger\ConsoleLogger;
use MediaWiki\Maintenance\Maintenance;
use Wikimedia\Tests\SerializationTestUtils;
define( 'MW_AUTOLOAD_TEST_CLASSES', true );
define( 'MW_PHPUNIT_TEST', true );
require_once __DIR__ . '/../../../../maintenance/Maintenance.php';
// phpcs:disable MediaWiki.Files.ClassMatchesFilename.WrongCase
class ValidateParserCacheSerializationTestData extends Maintenance {
public function __construct() {
parent::__construct();
$this->addArg(
'path',
'Path of serialization files.',
false
);
$this->addOption( 'create', 'Create missing serialization' );
$this->addOption( 'update', 'Update mismatching serialization files' );
$this->addOption( 'version', 'Specify version for which to check serialization. '
. 'Also determines which files may be created or updated if '
. 'the respective options are set.'
. 'Unserialization is always checked against all versions. ', false, true );
}
public function execute() {
$testClasses = [ CacheTimeTest::class, ParserOutputTest::class ];
foreach ( $testClasses as $testClass ) {
$this->validateSerialization( $testClass,
array_map( static function ( $testCase ) {
return $testCase['instance'];
}, $testClass::getTestInstancesAndAssertions() ) );
}
}
/**
* Ensures that objects will serialize into the form expected for the given version.
* If the respective options are set in the constructor, this will create missing files or
* update mismatching files.
*
* @param string $testClassName
* @param array $testInstances
*/
public function validateSerialization( string $testClassName, array $testInstances ) {
$className = $testClassName::getClassToTest();
$supportedFormats = $testClassName::getSupportedSerializationFormats();
$ok = true;
foreach ( $supportedFormats as $serializationFormat ) {
$serializationUtils = new SerializationTestUtils(
$this->getArg( 1 ) ?: $testClassName::getSerializedDataPath(),
$testInstances,
$serializationFormat['ext'],
$serializationFormat['serializer'],
$serializationFormat['deserializer']
);
$serializationUtils->setLogger( new ConsoleLogger( 'validator' ) );
foreach ( $serializationUtils->getSerializedInstances() as $testCaseName => $currentSerialized ) {
$expected = $serializationUtils
->getStoredSerializedInstance( $className, $testCaseName, $this->getOption( 'version' ) );
$ok = $this->validateSerializationData( $currentSerialized, $expected ) && $ok;
}
}
if ( !$ok ) {
$this->output( "\n\n" );
$this->fatalError( "Serialization data mismatch! "
. "If this was expected, rerun the script with the --update option "
. "to update the expected serialization. WARNING: make sure "
. "a forward compatible version of the code is live before deploying a "
. "serialization change!\n"
);
}
}
private function validateSerializationData( array $data, \stdClass $fileInfo ): bool {
if ( !$fileInfo->data ) {
if ( $this->hasOption( 'create' ) ) {
$this->output( 'Creating file: ' . $fileInfo->path . "\n" );
file_put_contents( $fileInfo->path, $data );
} else {
$this->fatalError( "File not found: {$fileInfo->path}. "
. "Rerun the script with the --create option set to create it."
);
}
} else {
if ( $data !== $fileInfo->data ) {
if ( $this->hasOption( 'update' ) ) {
$this->output( 'Data mismatch, updating file: ' . $fileInfo->currentVersionPath . "\n" );
file_put_contents( $fileInfo->currentVersionPath, $data );
} else {
$this->output( 'Serialization MISMATCH: ' . $fileInfo->path . "\n" );
return false;
}
} else {
$this->output( "Serialization OK: " . $fileInfo->path . "\n" );
}
}
return true;
}
}
return ValidateParserCacheSerializationTestData::class;
|
