tests/phpunit/includes/content/ContentHandlerTest.php

   1 <?php
   2
   3 /**
   4  * @group ContentHandler
   5  * @group Database
   6  *
   7  * @note Declare that we are using the database, because otherwise we'll fail in the "databaseless" test run.
   8  * This is because the LinkHolderArray used by the parser needs database access.
   9  *
  10  */
  11 class ContentHandlerTest extends MediaWikiTestCase {
  12
  13         public function setup() {
  14                 global $wgContLang;
  15                 parent::setup();
  16
  17                 $this->setMwGlobals( array(
  18                         'wgExtraNamespaces' => array(
  19                                 12312 => 'Dummy',
  20                                 12313 => 'Dummy_talk',
  21                         ),
  22                         // The below tests assume that namespaces not mentioned here (Help, User, MediaWiki, ..)
  23                         // default to CONTENT_MODEL_WIKITEXT.
  24                         'wgNamespaceContentModels' => array(
  25                                 12312 => 'testing',
  26                         ),
  27                         'wgContentHandlers' => array(
  28                                 CONTENT_MODEL_WIKITEXT => 'WikitextContentHandler',
  29                                 CONTENT_MODEL_JAVASCRIPT => 'JavaScriptContentHandler',
  30                                 CONTENT_MODEL_CSS => 'CssContentHandler',
  31                                 CONTENT_MODEL_TEXT => 'TextContentHandler',
  32                                 'testing' => 'DummyContentHandlerForTesting',
  33                         ),
  34                 ) );
  35
  36                 // Reset namespace cache
  37                 MWNamespace::getCanonicalNamespaces( true );
  38                 $wgContLang->resetNamespaces();
  39         }
  40
  41         public function tearDown() {
  42                 global $wgContLang;
  43
  44                 // Reset namespace cache
  45                 MWNamespace::getCanonicalNamespaces( true );
  46                 $wgContLang->resetNamespaces();
  47
  48                 parent::tearDown();
  49         }
  50
  51         public static function dataGetDefaultModelFor() {
  52                 return array(
  53                         array( 'Help:Foo', CONTENT_MODEL_WIKITEXT ),
  54                         array( 'Help:Foo.js', CONTENT_MODEL_WIKITEXT ),
  55                         array( 'Help:Foo/bar.js', CONTENT_MODEL_WIKITEXT ),
  56                         array( 'User:Foo', CONTENT_MODEL_WIKITEXT ),
  57                         array( 'User:Foo.js', CONTENT_MODEL_WIKITEXT ),
  58                         array( 'User:Foo/bar.js', CONTENT_MODEL_JAVASCRIPT ),
  59                         array( 'User:Foo/bar.css', CONTENT_MODEL_CSS ),
  60                         array( 'User talk:Foo/bar.css', CONTENT_MODEL_WIKITEXT ),
  61                         array( 'User:Foo/bar.js.xxx', CONTENT_MODEL_WIKITEXT ),
  62                         array( 'User:Foo/bar.xxx', CONTENT_MODEL_WIKITEXT ),
  63                         array( 'MediaWiki:Foo.js', CONTENT_MODEL_JAVASCRIPT ),
  64                         array( 'MediaWiki:Foo.css', CONTENT_MODEL_CSS ),
  65                         array( 'MediaWiki:Foo.JS', CONTENT_MODEL_WIKITEXT ),
  66                         array( 'MediaWiki:Foo.CSS', CONTENT_MODEL_WIKITEXT ),
  67                         array( 'MediaWiki:Foo.css.xxx', CONTENT_MODEL_WIKITEXT ),
  68                 );
  69         }
  70
  71         /**
  72          * @dataProvider dataGetDefaultModelFor
  73          */
  74         public function testGetDefaultModelFor( $title, $expectedModelId ) {
  75                 $title = Title::newFromText( $title );
  76                 $this->assertEquals( $expectedModelId, ContentHandler::getDefaultModelFor( $title ) );
  77         }
  78
  79         /**
  80          * @dataProvider dataGetDefaultModelFor
  81          */
  82         public function testGetForTitle( $title, $expectedContentModel ) {
  83                 $title = Title::newFromText( $title );
  84                 $handler = ContentHandler::getForTitle( $title );
  85                 $this->assertEquals( $expectedContentModel, $handler->getModelID() );
  86         }
  87
  88         public static function dataGetLocalizedName() {
  89                 return array(
  90                         array( null, null ),
  91                         array( "xyzzy", null ),
  92
  93                         // XXX: depends on content language
  94                         array( CONTENT_MODEL_JAVASCRIPT, '/javascript/i' ),
  95                 );
  96         }
  97
  98         /**
  99          * @dataProvider dataGetLocalizedName
 100          */
 101         public function testGetLocalizedName( $id, $expected ) {
 102                 $name = ContentHandler::getLocalizedName( $id );
 103
 104                 if ( $expected ) {
 105                         $this->assertNotNull( $name, "no name found for content model $id" );
 106                         $this->assertTrue( preg_match( $expected, $name ) > 0 ,
 107                                 "content model name for #$id did not match pattern $expected"
 108                         );
 109                 } else {
 110                         $this->assertEquals( $id, $name, "localization of unknown model $id should have "
 111                                 . "fallen back to use the model id directly."
 112                         );
 113                 }
 114         }
 115
 116         public static function dataGetPageLanguage() {
 117                 global $wgLanguageCode;
 118
 119                 return array(
 120                         array( "Main", $wgLanguageCode ),
 121                         array( "Dummy:Foo", $wgLanguageCode ),
 122                         array( "MediaWiki:common.js", 'en' ),
 123                         array( "User:Foo/common.js", 'en' ),
 124                         array( "MediaWiki:common.css", 'en' ),
 125                         array( "User:Foo/common.css", 'en' ),
 126                         array( "User:Foo", $wgLanguageCode ),
 127
 128                         array( CONTENT_MODEL_JAVASCRIPT, 'javascript' ),
 129                 );
 130         }
 131
 132         /**
 133          * @dataProvider dataGetPageLanguage
 134          */
 135         public function testGetPageLanguage( $title, $expected ) {
 136                 if ( is_string( $title ) ) {
 137                         $title = Title::newFromText( $title );
 138                 }
 139
 140                 $expected = wfGetLangObj( $expected );
 141
 142                 $handler = ContentHandler::getForTitle( $title );
 143                 $lang = $handler->getPageLanguage( $title );
 144
 145                 $this->assertEquals( $expected->getCode(), $lang->getCode() );
 146         }
 147
 148         public function testGetContentText_Null( ) {
 149                 global $wgContentHandlerTextFallback;
 150
 151                 $content = null;
 152
 153                 $wgContentHandlerTextFallback = 'fail';
 154                 $text = ContentHandler::getContentText( $content );
 155                 $this->assertEquals( '', $text );
 156
 157                 $wgContentHandlerTextFallback = 'serialize';
 158                 $text = ContentHandler::getContentText( $content );
 159                 $this->assertEquals( '', $text );
 160
 161                 $wgContentHandlerTextFallback = 'ignore';
 162                 $text = ContentHandler::getContentText( $content );
 163                 $this->assertEquals( '', $text );
 164         }
 165
 166         public function testGetContentText_TextContent( ) {
 167                 global $wgContentHandlerTextFallback;
 168
 169                 $content = new WikitextContent( "hello world" );
 170
 171                 $wgContentHandlerTextFallback = 'fail';
 172                 $text = ContentHandler::getContentText( $content );
 173                 $this->assertEquals( $content->getNativeData(), $text );
 174
 175                 $wgContentHandlerTextFallback = 'serialize';
 176                 $text = ContentHandler::getContentText( $content );
 177                 $this->assertEquals( $content->serialize(), $text );
 178
 179                 $wgContentHandlerTextFallback = 'ignore';
 180                 $text = ContentHandler::getContentText( $content );
 181                 $this->assertEquals( $content->getNativeData(), $text );
 182         }
 183
 184         public function testGetContentText_NonTextContent( ) {
 185                 global $wgContentHandlerTextFallback;
 186
 187                 $content = new DummyContentForTesting( "hello world" );
 188
 189                 $wgContentHandlerTextFallback = 'fail';
 190
 191                 try {
 192                         $text = ContentHandler::getContentText( $content );
 193
 194                         $this->fail( "ContentHandler::getContentText should have thrown an exception for non-text Content object" );
 195                 } catch ( MWException $ex ) {
 196                         // as expected
 197                 }
 198
 199                 $wgContentHandlerTextFallback = 'serialize';
 200                 $text = ContentHandler::getContentText( $content );
 201                 $this->assertEquals( $content->serialize(), $text );
 202
 203                 $wgContentHandlerTextFallback = 'ignore';
 204                 $text = ContentHandler::getContentText( $content );
 205                 $this->assertNull( $text );
 206         }
 207
 208         /*
 209         public static function makeContent( $text, Title $title, $modelId = null, $format = null ) {}
 210         */
 211
 212         public static function dataMakeContent() {
 213                 return array(
 214                         array( 'hallo', 'Help:Test', null, null, CONTENT_MODEL_WIKITEXT, 'hallo', false ),
 215                         array( 'hallo', 'MediaWiki:Test.js', null, null, CONTENT_MODEL_JAVASCRIPT, 'hallo', false ),
 216                         array( serialize('hallo'), 'Dummy:Test', null, null, "testing", 'hallo', false ),
 217
 218                         array( 'hallo', 'Help:Test', null, CONTENT_FORMAT_WIKITEXT, CONTENT_MODEL_WIKITEXT, 'hallo', false ),
 219                         array( 'hallo', 'MediaWiki:Test.js', null, CONTENT_FORMAT_JAVASCRIPT, CONTENT_MODEL_JAVASCRIPT, 'hallo', false ),
 220                         array( serialize('hallo'), 'Dummy:Test', null, "testing", "testing", 'hallo', false ),
 221
 222                         array( 'hallo', 'Help:Test', CONTENT_MODEL_CSS, null, CONTENT_MODEL_CSS, 'hallo', false ),
 223                         array( 'hallo', 'MediaWiki:Test.js', CONTENT_MODEL_CSS, null, CONTENT_MODEL_CSS, 'hallo', false ),
 224                         array( serialize('hallo'), 'Dummy:Test', CONTENT_MODEL_CSS, null, CONTENT_MODEL_CSS, serialize('hallo'), false ),
 225
 226                         array( 'hallo', 'Help:Test', CONTENT_MODEL_WIKITEXT, "testing", null, null, true ),
 227                         array( 'hallo', 'MediaWiki:Test.js', CONTENT_MODEL_CSS, "testing", null, null, true ),
 228                         array( 'hallo', 'Dummy:Test', CONTENT_MODEL_JAVASCRIPT, "testing", null, null, true ),
 229                 );
 230         }
 231
 232         /**
 233          * @dataProvider dataMakeContent
 234          */
 235         public function testMakeContent( $data, $title, $modelId, $format, $expectedModelId, $expectedNativeData, $shouldFail ) {
 236                 global $wgExtraNamespaces, $wgNamespaceContentModels, $wgContentHandlers;
 237
 238                 $title = Title::newFromText( $title );
 239
 240                 try {
 241                         $content = ContentHandler::makeContent( $data, $title, $modelId, $format );
 242
 243                         if ( $shouldFail ) {
 244                                 $this->fail( "ContentHandler::makeContent should have failed!" );
 245                         }
 246
 247                         $this->assertEquals( $expectedModelId, $content->getModel(), 'bad model id' );
 248                         $this->assertEquals( $expectedNativeData, $content->getNativeData(), 'bads native data' );
 249                 } catch ( MWException $ex ) {
 250                         if ( !$shouldFail ) $this->fail( "ContentHandler::makeContent failed unexpectedly: " . $ex->getMessage() );
 251                         else $this->assertTrue( true ); // dummy, so we don't get the "test did not perform any assertions" message.
 252                 }
 253
 254         }
 255
 256         /*
 257         public function testSupportsSections() {
 258                 $this->markTestIncomplete( "not yet implemented" );
 259         }
 260         */
 261
 262         public function testRunLegacyHooks() {
 263                 Hooks::register( 'testRunLegacyHooks', __CLASS__ . '::dummyHookHandler' );
 264
 265                 $content = new WikitextContent( 'test text' );
 266                 $ok = ContentHandler::runLegacyHooks( 'testRunLegacyHooks', array( 'foo', &$content, 'bar' ), false );
 267
 268                 $this->assertTrue( $ok, "runLegacyHooks should have returned true" );
 269                 $this->assertEquals( "TEST TEXT", $content->getNativeData() );
 270         }
 271
 272         public static function dummyHookHandler( $foo, &$text, $bar ) {
 273                 if ( $text === null || $text === false ) {
 274                         return false;
 275                 }
 276
 277                 $text = strtoupper( $text );
 278
 279                 return true;
 280         }
 281 }
 282
 283 class DummyContentHandlerForTesting extends ContentHandler {
 284
 285         public function __construct( $dataModel ) {
 286                 parent::__construct( $dataModel, array( "testing" ) );
 287         }
 288
 289         /**
 290          * Serializes Content object of the type supported by this ContentHandler.
 291          *
 292          * @param Content $content the Content object to serialize
 293          * @param null $format the desired serialization format
 294          * @return String serialized form of the content
 295          */
 296         public function serializeContent( Content $content, $format = null ) {
 297            return $content->serialize();
 298         }
 299
 300         /**
 301          * Unserializes a Content object of the type supported by this ContentHandler.
 302          *
 303          * @param $blob String serialized form of the content
 304          * @param null $format the format used for serialization
 305          * @return Content the Content object created by deserializing $blob
 306          */
 307         public function unserializeContent( $blob, $format = null ) {
 308                 $d = unserialize( $blob );
 309                 return new DummyContentForTesting( $d );
 310         }
 311
 312         /**
 313          * Creates an empty Content object of the type supported by this ContentHandler.
 314          *
 315          */
 316         public function makeEmptyContent() {
 317                 return new DummyContentForTesting( '' );
 318         }
 319 }
 320
 321 class DummyContentForTesting extends AbstractContent {
 322
 323         public function __construct( $data ) {
 324                 parent::__construct( "testing" );
 325
 326                 $this->data = $data;
 327         }
 328
 329         public function serialize( $format = null ) {
 330                 return serialize( $this->data );
 331         }
 332
 333         /**
 334          * @return String a string representing the content in a way useful for building a full text search index.
 335          *         If no useful representation exists, this method returns an empty string.
 336          */
 337         public function getTextForSearchIndex() {
 338                 return '';
 339         }
 340
 341         /**
 342          * @return String the wikitext to include when another page includes this  content, or false if the content is not
 343          *  includable in a wikitext page.
 344          */
 345         public function getWikitextForTransclusion() {
 346                 return false;
 347         }
 348
 349         /**
 350          * Returns a textual representation of the content suitable for use in edit summaries and log messages.
 351          *
 352          * @param int $maxlength Maximum length of the summary text.
 353          * @return string The summary text.
 354          */
 355         public function getTextForSummary( $maxlength = 250 ) {
 356                 return '';
 357         }
 358
 359         /**
 360          * Returns native represenation of the data. Interpretation depends on the data model used,
 361          * as given by getDataModel().
 362          *
 363          * @return mixed the native representation of the content. Could be a string, a nested array
 364          *  structure, an object, a binary blob... anything, really.
 365          */
 366         public function getNativeData()
 367         {
 368                 return $this->data;
 369         }
 370
 371         /**
 372          * returns the content's nominal size in bogo-bytes.
 373          *
 374          * @return int
 375          */
 376         public function getSize() {
 377                 return strlen( $this->data );
 378         }
 379
 380         /**
 381          * Return a copy of this Content object. The following must be true for the object returned
 382          * if $copy = $original->copy()
 383          *
 384          * * get_class($original) === get_class($copy)
 385          * * $original->getModel() === $copy->getModel()
 386          * * $original->equals( $copy )
 387          *
 388          * If and only if the Content object is imutable, the copy() method can and should
 389          * return $this. That is,  $copy === $original may be true, but only for imutable content
 390          * objects.
 391          *
 392          * @return Content. A copy of this object.
 393          */
 394         public function copy() {
 395                 return $this;
 396         }
 397
 398         /**
 399          * Returns true if this content is countable as a "real" wiki page, provided
 400          * that it's also in a countable location (e.g. a current revision in the main namespace).
 401          *
 402          * @param boolean $hasLinks if it is known whether this content contains links, provide this information here,
 403          *  to avoid redundant parsing to find out.
 404          * @return boolean
 405          */
 406         public function isCountable( $hasLinks = null ) {
 407                 return false;
 408         }
 409
 410         /**
 411          * @param Title $title
 412          * @param null $revId
 413          * @param null|ParserOptions $options
 414          * @param boolean $generateHtml whether to generate Html (default: true). If false,
 415          *  the result of calling getText() on the ParserOutput object returned by
 416          *   this method is undefined.
 417          *
 418          * @return ParserOutput
 419          */
 420         public function getParserOutput( Title $title, $revId = null, ParserOptions $options = NULL, $generateHtml = true ) {
 421                 return new ParserOutput( $this->getNativeData() );
 422         }
 423 }