tests/phpunit/includes/registration/VersionCheckerTest.php

   1 <?php
   2
   3 /**
   4  * @covers VersionChecker
   5  */
   6 class VersionCheckerTest extends PHPUnit\Framework\TestCase {
   7
   8         use MediaWikiCoversValidator;
   9
  10         /**
  11          * @dataProvider provideCheck
  12          */
  13         public function testCheck( $coreVersion, $constraint, $expected ) {
  14                 $checker = new VersionChecker( $coreVersion );
  15                 $this->assertEquals( $expected, !(bool)$checker->checkArray( [
  16                         'FakeExtension' => [
  17                                 'MediaWiki' => $constraint,
  18                         ],
  19                 ] )
  20                 );
  21         }
  22
  23         public static function provideCheck() {
  24                 return [
  25                         // [ $wgVersion, constraint, expected ]
  26                         [ '1.25alpha', '>= 1.26', false ],
  27                         [ '1.25.0', '>= 1.26', false ],
  28                         [ '1.26alpha', '>= 1.26', true ],
  29                         [ '1.26alpha', '>= 1.26.0', true ],
  30                         [ '1.26alpha', '>= 1.26.0-stable', false ],
  31                         [ '1.26.0', '>= 1.26.0-stable', true ],
  32                         [ '1.26.1', '>= 1.26.0-stable', true ],
  33                         [ '1.27.1', '>= 1.26.0-stable', true ],
  34                         [ '1.26alpha', '>= 1.26.1', false ],
  35                         [ '1.26alpha', '>= 1.26alpha', true ],
  36                         [ '1.26alpha', '>= 1.25', true ],
  37                         [ '1.26.0-alpha.14', '>= 1.26.0-alpha.15', false ],
  38                         [ '1.26.0-alpha.14', '>= 1.26.0-alpha.10', true ],
  39                         [ '1.26.1', '>= 1.26.2, <=1.26.0', false ],
  40                         [ '1.26.1', '^1.26.2', false ],
  41                         // Accept anything for un-parsable version strings
  42                         [ '1.26mwf14', '== 1.25alpha', true ],
  43                         [ 'totallyinvalid', '== 1.0', true ],
  44                 ];
  45         }
  46
  47         /**
  48          * @dataProvider provideType
  49          */
  50         public function testType( $given, $expected ) {
  51                 $checker = new VersionChecker( '1.0.0' );
  52                 $checker
  53                         ->setLoadedExtensionsAndSkins( [
  54                                 'FakeDependency' => [
  55                                         'version' => '1.0.0',
  56                                 ],
  57                                 'NoVersionGiven' => [],
  58                         ] );
  59                 $this->assertEquals( $expected, $checker->checkArray( [
  60                         'FakeExtension' => $given,
  61                 ] )
  62                 );
  63         }
  64
  65         public static function provideType() {
  66                 return [
  67                         // valid type
  68                         [
  69                                 [
  70                                         'extensions' => [
  71                                                 'FakeDependency' => '1.0.0'
  72                                         ]
  73                                 ],
  74                                 []
  75                         ],
  76                         [
  77                                 [
  78                                         'MediaWiki' => '1.0.0'
  79                                 ],
  80                                 []
  81                         ],
  82                         [
  83                                 [
  84                                         'extensions' => [
  85                                                 'NoVersionGiven' => '*'
  86                                         ]
  87                                 ],
  88                                 [],
  89                         ],
  90                         [
  91                                 [
  92                                         'extensions' => [
  93                                                 'NoVersionGiven' => '1.0',
  94                                         ]
  95                                 ],
  96                                 [ 'NoVersionGiven does not expose its version, but FakeExtension requires: 1.0.' ],
  97                         ],
  98                         [
  99                                 [
 100                                         'extensions' => [
 101                                                 'Missing' => '*',
 102                                         ]
 103                                 ],
 104                                 [ 'FakeExtension requires Missing to be installed.' ],
 105                         ],
 106                         [
 107                                 [
 108                                         'extensions' => [
 109                                                 'FakeDependency' => '2.0.0',
 110                                         ]
 111                                 ],
 112                                 // phpcs:ignore Generic.Files.LineLength.TooLong
 113                                 [ 'FakeExtension is not compatible with the current installed version of FakeDependency (1.0.0), it requires: 2.0.0.' ],
 114                         ]
 115                 ];
 116         }
 117
 118         /**
 119          * Check, if a non-parsable version constraint does not throw an exception or
 120          * returns any error message.
 121          */
 122         public function testInvalidConstraint() {
 123                 $checker = new VersionChecker( '1.0.0' );
 124                 $checker
 125                         ->setLoadedExtensionsAndSkins( [
 126                                 'FakeDependency' => [
 127                                         'version' => 'not really valid',
 128                                 ],
 129                         ] );
 130                 $this->assertEquals( [ "FakeDependency does not have a valid version string." ],
 131                         $checker->checkArray( [
 132                                 'FakeExtension' => [
 133                                         'extensions' => [
 134                                                 'FakeDependency' => '1.24.3',
 135                                         ],
 136                                 ],
 137                         ] )
 138                 );
 139
 140                 $checker = new VersionChecker( '1.0.0' );
 141                 $checker
 142                         ->setLoadedExtensionsAndSkins( [
 143                                 'FakeDependency' => [
 144                                         'version' => '1.24.3',
 145                                 ],
 146                         ] );
 147
 148                 $this->setExpectedException( UnexpectedValueException::class );
 149                 $checker->checkArray( [
 150                         'FakeExtension' => [
 151                                 'FakeDependency' => 'not really valid',
 152                         ]
 153                 ] );
 154         }
 155 }