tests/phpunit/includes/parser/MagicVariableTest.php

   1 <?php
   2 /**
   3  * This file is intended to test magic variables in the parser
   4  * It was inspired by Raymond & Matěj Grabovský commenting about r66200
   5  *
   6  * As of february 2011, it only tests some revisions and date related
   7  * magic variables.
   8  *
   9  * @author Antoine Musso
  10  * @copyright Copyright © 2011, Antoine Musso
  11  * @file
  12  */
  13
  14 /** */
  15 class MagicVariableTest extends MediaWikiTestCase {
  16         /** Will contains a parser object*/
  17         private $testParser = null;
  18
  19         /**
  20          * An array of magicword returned as type integer by the parser
  21          * They are usually returned as a string for i18n since we support
  22          * persan numbers for example, but some magic explicitly return
  23          * them as integer.
  24          * @see MagicVariableTest::assertMagic()
  25          */
  26         private $expectedAsInteger = array(
  27                 'revisionday',
  28                 'revisionmonth1',
  29         );
  30
  31         /** setup a basic parser object */
  32         protected function setUp() {
  33                 parent::setUp();
  34
  35                 $contLang = Language::factory( 'en' );
  36                 $this->setMwGlobals( array(
  37                         'wgLanguageCode' => 'en',
  38                         'wgContLang' => $contLang,
  39                 ) );
  40
  41                 $this->testParser = new Parser();
  42                 $this->testParser->Options( ParserOptions::newFromUserAndLang( new User, $contLang ) );
  43
  44                 # initialize parser output
  45                 $this->testParser->clearState();
  46
  47                 # Needs a title to do magic word stuff
  48                 $title = Title::newFromText( 'Tests' );
  49                 $title->mRedirect = false; # Else it needs a db connection just to check if it's a redirect (when deciding the page language)
  50
  51                 $this->testParser->setTitle( $title );
  52         }
  53
  54         /** destroy parser (TODO: is it really neded?)*/
  55         protected function tearDown() {
  56                 unset( $this->testParser );
  57
  58                 parent::tearDown();
  59         }
  60
  61         ############### TESTS #############################################
  62         # @todo FIXME:
  63         #  - those got copy pasted, we can probably make them cleaner
  64         #  - tests are lacking useful messages
  65
  66         # day
  67
  68         /**
  69          * @dataProvider MediaWikiProvide::Days
  70          * @group Database
  71          */
  72         function testCurrentdayIsUnPadded( $day ) {
  73                 $this->assertUnPadded( 'currentday', $day );
  74         }
  75
  76         /**
  77          * @dataProvider MediaWikiProvide::Days
  78          * @group Database
  79          */
  80         function testCurrentdaytwoIsZeroPadded( $day ) {
  81                 $this->assertZeroPadded( 'currentday2', $day );
  82         }
  83
  84         /**
  85          * @dataProvider MediaWikiProvide::Days
  86          * @group Database
  87          */
  88         function testLocaldayIsUnPadded( $day ) {
  89                 $this->assertUnPadded( 'localday', $day );
  90         }
  91
  92         /**
  93          * @dataProvider MediaWikiProvide::Days
  94          * @group Database
  95          */
  96         function testLocaldaytwoIsZeroPadded( $day ) {
  97                 $this->assertZeroPadded( 'localday2', $day );
  98         }
  99
 100         # month
 101
 102         /**
 103          * @dataProvider MediaWikiProvide::Months
 104          * @group Database
 105          */
 106         function testCurrentmonthIsZeroPadded( $month ) {
 107                 $this->assertZeroPadded( 'currentmonth', $month );
 108         }
 109
 110         /**
 111          * @dataProvider MediaWikiProvide::Months
 112          * @group Database
 113          */
 114         function testCurrentmonthoneIsUnPadded( $month ) {
 115                 $this->assertUnPadded( 'currentmonth1', $month );
 116         }
 117
 118         /**
 119          * @dataProvider MediaWikiProvide::Months
 120          * @group Database
 121          */
 122         function testLocalmonthIsZeroPadded( $month ) {
 123                 $this->assertZeroPadded( 'localmonth', $month );
 124         }
 125
 126         /**
 127          * @dataProvider MediaWikiProvide::Months
 128          * @group Database
 129          */
 130         function testLocalmonthoneIsUnPadded( $month ) {
 131                 $this->assertUnPadded( 'localmonth1', $month );
 132         }
 133
 134
 135         # revision day
 136
 137         /**
 138          * @dataProvider MediaWikiProvide::Days
 139          * @group Database
 140          */
 141         function testRevisiondayIsUnPadded( $day ) {
 142                 $this->assertUnPadded( 'revisionday', $day );
 143         }
 144
 145         /**
 146          * @dataProvider MediaWikiProvide::Days
 147          * @group Database
 148          */
 149         function testRevisiondaytwoIsZeroPadded( $day ) {
 150                 $this->assertZeroPadded( 'revisionday2', $day );
 151         }
 152
 153         # revision month
 154
 155         /**
 156          * @dataProvider MediaWikiProvide::Months
 157          * @group Database
 158          */
 159         function testRevisionmonthIsZeroPadded( $month ) {
 160                 $this->assertZeroPadded( 'revisionmonth', $month );
 161         }
 162
 163         /**
 164          * @dataProvider MediaWikiProvide::Months
 165          * @group Database
 166          */
 167         function testRevisionmonthoneIsUnPadded( $month ) {
 168                 $this->assertUnPadded( 'revisionmonth1', $month );
 169         }
 170
 171         /**
 172          * Rough tests for {{SERVERNAME}} magic word
 173          * Bug 31176
 174          * @group Database
 175          */
 176         function testServernameFromDifferentProtocols() {
 177                 global $wgServer;
 178                 $saved_wgServer = $wgServer;
 179
 180                 $wgServer = 'http://localhost/';
 181                 $this->assertMagic( 'localhost', 'servername' );
 182                 $wgServer = 'https://localhost/';
 183                 $this->assertMagic( 'localhost', 'servername' );
 184                 $wgServer = '//localhost/'; # bug 31176
 185                 $this->assertMagic( 'localhost', 'servername' );
 186
 187                 $wgServer = $saved_wgServer;
 188         }
 189
 190         ############### HELPERS ############################################
 191
 192         /** assertion helper expecting a magic output which is zero padded */
 193         PUBLIC function assertZeroPadded( $magic, $value ) {
 194                 $this->assertMagicPadding( $magic, $value, '%02d' );
 195         }
 196
 197         /** assertion helper expecting a magic output which is unpadded */
 198         PUBLIC function assertUnPadded( $magic, $value ) {
 199                 $this->assertMagicPadding( $magic, $value, '%d' );
 200         }
 201
 202         /**
 203          * Main assertion helper for magic variables padding
 204          * @param $magic string Magic variable name
 205          * @param $value mixed Month or day
 206          * @param $format string sprintf format for $value
 207          */
 208         private function assertMagicPadding( $magic, $value, $format ) {
 209                 # Initialize parser timestamp as year 2010 at 12h34 56s.
 210                 # month and day are given by the caller ($value). Month < 12!
 211                 if ( $value > 12 ) {
 212                         $month = $value % 12;
 213                 } else {
 214                         $month = $value;
 215                 }
 216
 217                 $this->setParserTS(
 218                         sprintf( '2010%02d%02d123456', $month, $value )
 219                 );
 220
 221                 # please keep the following commented line of code. It helps debugging.
 222                 //print "\nDEBUG (value $value):" . sprintf( '2010%02d%02d123456', $value, $value ) . "\n";
 223
 224                 # format expectation and test it
 225                 $expected = sprintf( $format, $value );
 226                 $this->assertMagic( $expected, $magic );
 227         }
 228
 229         /** helper to set the parser timestamp and revision timestamp */
 230         private function setParserTS( $ts ) {
 231                 $this->testParser->Options()->setTimestamp( $ts );
 232                 $this->testParser->mRevisionTimestamp = $ts;
 233         }
 234
 235         /**
 236          * Assertion helper to test a magic variable output
 237          */
 238         private function assertMagic( $expected, $magic ) {
 239                 if ( in_array( $magic, $this->expectedAsInteger ) ) {
 240                         $expected = (int)$expected;
 241                 }
 242
 243                 # Generate a message for the assertion
 244                 $msg = sprintf( "Magic %s should be <%s:%s>",
 245                         $magic,
 246                         $expected,
 247                         gettype( $expected )
 248                 );
 249
 250                 $this->assertSame(
 251                         $expected,
 252                         $this->testParser->getVariableValue( $magic ),
 253                         $msg
 254                 );
 255         }
 256 }