Merge "Revert "Make it possible to install extensions using Composer""

[mediawiki.git] / tests / phpunit / includes / content / ContentHandlerTest.php

<?php

/**
 * @group ContentHandler
 * @group Database
 *
 * @note Declare that we are using the database, because otherwise we'll fail in
 * the "databaseless" test run. This is because the LinkHolderArray used by the
 * parser needs database access.
 */
class ContentHandlerTest extends MediaWikiTestCase {

        protected function setUp() {
                global $wgContLang;
                parent::setUp();

                $this->setMwGlobals( array(
                        'wgExtraNamespaces' => array(
                                12312 => 'Dummy',
                                12313 => 'Dummy_talk',
                        ),
                        // The below tests assume that namespaces not mentioned here (Help, User, MediaWiki, ..)
                        // default to CONTENT_MODEL_WIKITEXT.
                        'wgNamespaceContentModels' => array(
                                12312 => 'testing',
                        ),
                        'wgContentHandlers' => array(
                                CONTENT_MODEL_WIKITEXT => 'WikitextContentHandler',
                                CONTENT_MODEL_JAVASCRIPT => 'JavaScriptContentHandler',
                                CONTENT_MODEL_CSS => 'CssContentHandler',
                                CONTENT_MODEL_TEXT => 'TextContentHandler',
                                'testing' => 'DummyContentHandlerForTesting',
                        ),
                ) );

                // Reset namespace cache
                MWNamespace::getCanonicalNamespaces( true );
                $wgContLang->resetNamespaces();
        }

        protected function tearDown() {
                global $wgContLang;

                // Reset namespace cache
                MWNamespace::getCanonicalNamespaces( true );
                $wgContLang->resetNamespaces();

                parent::tearDown();
        }

        public static function dataGetDefaultModelFor() {
                return array(
                        array( 'Help:Foo', CONTENT_MODEL_WIKITEXT ),
                        array( 'Help:Foo.js', CONTENT_MODEL_WIKITEXT ),
                        array( 'Help:Foo/bar.js', CONTENT_MODEL_WIKITEXT ),
                        array( 'User:Foo', CONTENT_MODEL_WIKITEXT ),
                        array( 'User:Foo.js', CONTENT_MODEL_WIKITEXT ),
                        array( 'User:Foo/bar.js', CONTENT_MODEL_JAVASCRIPT ),
                        array( 'User:Foo/bar.css', CONTENT_MODEL_CSS ),
                        array( 'User talk:Foo/bar.css', CONTENT_MODEL_WIKITEXT ),
                        array( 'User:Foo/bar.js.xxx', CONTENT_MODEL_WIKITEXT ),
                        array( 'User:Foo/bar.xxx', CONTENT_MODEL_WIKITEXT ),
                        array( 'MediaWiki:Foo.js', CONTENT_MODEL_JAVASCRIPT ),
                        array( 'MediaWiki:Foo.css', CONTENT_MODEL_CSS ),
                        array( 'MediaWiki:Foo.JS', CONTENT_MODEL_WIKITEXT ),
                        array( 'MediaWiki:Foo.CSS', CONTENT_MODEL_WIKITEXT ),
                        array( 'MediaWiki:Foo.css.xxx', CONTENT_MODEL_WIKITEXT ),
                );
        }

        /**
         * @dataProvider dataGetDefaultModelFor
         * @covers ContentHandler::getDefaultModelFor
         */
        public function testGetDefaultModelFor( $title, $expectedModelId ) {
                $title = Title::newFromText( $title );
                $this->assertEquals( $expectedModelId, ContentHandler::getDefaultModelFor( $title ) );
        }

        /**
         * @dataProvider dataGetDefaultModelFor
         * @covers ContentHandler::getForTitle
         */
        public function testGetForTitle( $title, $expectedContentModel ) {
                $title = Title::newFromText( $title );
                $handler = ContentHandler::getForTitle( $title );
                $this->assertEquals( $expectedContentModel, $handler->getModelID() );
        }

        public static function dataGetLocalizedName() {
                return array(
                        array( null, null ),
                        array( "xyzzy", null ),

                        // XXX: depends on content language
                        array( CONTENT_MODEL_JAVASCRIPT, '/javascript/i' ),
                );
        }

        /**
         * @dataProvider dataGetLocalizedName
         * @covers ContentHandler::getLocalizedName
         */
        public function testGetLocalizedName( $id, $expected ) {
                $name = ContentHandler::getLocalizedName( $id );

                if ( $expected ) {
                        $this->assertNotNull( $name, "no name found for content model $id" );
                        $this->assertTrue( preg_match( $expected, $name ) > 0,
                                "content model name for #$id did not match pattern $expected"
                        );
                } else {
                        $this->assertEquals( $id, $name, "localization of unknown model $id should have "
                                . "fallen back to use the model id directly."
                        );
                }
        }

        public static function dataGetPageLanguage() {
                global $wgLanguageCode;

                return array(
                        array( "Main", $wgLanguageCode ),
                        array( "Dummy:Foo", $wgLanguageCode ),
                        array( "MediaWiki:common.js", 'en' ),
                        array( "User:Foo/common.js", 'en' ),
                        array( "MediaWiki:common.css", 'en' ),
                        array( "User:Foo/common.css", 'en' ),
                        array( "User:Foo", $wgLanguageCode ),

                        array( CONTENT_MODEL_JAVASCRIPT, 'javascript' ),
                );
        }

        /**
         * @dataProvider dataGetPageLanguage
         * @covers ContentHandler::getPageLanguage
         */
        public function testGetPageLanguage( $title, $expected ) {
                if ( is_string( $title ) ) {
                        $title = Title::newFromText( $title );
                }

                $expected = wfGetLangObj( $expected );

                $handler = ContentHandler::getForTitle( $title );
                $lang = $handler->getPageLanguage( $title );

                $this->assertEquals( $expected->getCode(), $lang->getCode() );
        }

        public static function dataGetContentText_Null() {
                return array(
                        array( 'fail' ),
                        array( 'serialize' ),
                        array( 'ignore' ),
                );
        }

        /**
         * @dataProvider dataGetContentText_Null
         * @covers ContentHandler::getContentText
         */
        public function testGetContentText_Null( $contentHandlerTextFallback ) {
                $this->setMwGlobals( 'wgContentHandlerTextFallback', $contentHandlerTextFallback );

                $content = null;

                $text = ContentHandler::getContentText( $content );
                $this->assertEquals( '', $text );
        }

        public static function dataGetContentText_TextContent() {
                return array(
                        array( 'fail' ),
                        array( 'serialize' ),
                        array( 'ignore' ),
                );
        }

        /**
         * @dataProvider dataGetContentText_TextContent
         * @covers ContentHandler::getContentText
         */
        public function testGetContentText_TextContent( $contentHandlerTextFallback ) {
                $this->setMwGlobals( 'wgContentHandlerTextFallback', $contentHandlerTextFallback );

                $content = new WikitextContent( "hello world" );

                $text = ContentHandler::getContentText( $content );
                $this->assertEquals( $content->getNativeData(), $text );
        }

        /**
         * ContentHandler::getContentText should have thrown an exception for non-text Content object
         * @expectedException MWException
         * @covers ContentHandler::getContentText
         */
        public function testGetContentText_NonTextContent_fail() {
                $this->setMwGlobals( 'wgContentHandlerTextFallback', 'fail' );

                $content = new DummyContentForTesting( "hello world" );

                ContentHandler::getContentText( $content );
        }

        /**
         * @covers ContentHandler::getContentText
         */
        public function testGetContentText_NonTextContent_serialize() {
                $this->setMwGlobals( 'wgContentHandlerTextFallback', 'serialize' );

                $content = new DummyContentForTesting( "hello world" );

                $text = ContentHandler::getContentText( $content );
                $this->assertEquals( $content->serialize(), $text );
        }

        /**
         * @covers ContentHandler::getContentText
         */
        public function testGetContentText_NonTextContent_ignore() {
                $this->setMwGlobals( 'wgContentHandlerTextFallback', 'ignore' );

                $content = new DummyContentForTesting( "hello world" );

                $text = ContentHandler::getContentText( $content );
                $this->assertNull( $text );
        }

        /*
        public static function makeContent( $text, Title $title, $modelId = null, $format = null ) {}
        */

        public static function dataMakeContent() {
                return array(
                        array( 'hallo', 'Help:Test', null, null, CONTENT_MODEL_WIKITEXT, 'hallo', false ),
                        array( 'hallo', 'MediaWiki:Test.js', null, null, CONTENT_MODEL_JAVASCRIPT, 'hallo', false ),
                        array( serialize( 'hallo' ), 'Dummy:Test', null, null, "testing", 'hallo', false ),

                        array(
                                'hallo',
                                'Help:Test',
                                null,
                                CONTENT_FORMAT_WIKITEXT,
                                CONTENT_MODEL_WIKITEXT,
                                'hallo',
                                false
                        ),
                        array(
                                'hallo',
                                'MediaWiki:Test.js',
                                null,
                                CONTENT_FORMAT_JAVASCRIPT,
                                CONTENT_MODEL_JAVASCRIPT,
                                'hallo',
                                false
                        ),
                        array( serialize( 'hallo' ), 'Dummy:Test', null, "testing", "testing", 'hallo', false ),

                        array( 'hallo', 'Help:Test', CONTENT_MODEL_CSS, null, CONTENT_MODEL_CSS, 'hallo', false ),
                        array(
                                'hallo',
                                'MediaWiki:Test.js',
                                CONTENT_MODEL_CSS,
                                null,
                                CONTENT_MODEL_CSS,
                                'hallo',
                                false
                        ),
                        array(
                                serialize( 'hallo' ),
                                'Dummy:Test',
                                CONTENT_MODEL_CSS,
                                null,
                                CONTENT_MODEL_CSS,
                                serialize( 'hallo' ),
                                false
                        ),

                        array( 'hallo', 'Help:Test', CONTENT_MODEL_WIKITEXT, "testing", null, null, true ),
                        array( 'hallo', 'MediaWiki:Test.js', CONTENT_MODEL_CSS, "testing", null, null, true ),
                        array( 'hallo', 'Dummy:Test', CONTENT_MODEL_JAVASCRIPT, "testing", null, null, true ),
                );
        }

        /**
         * @dataProvider dataMakeContent
         * @covers ContentHandler::makeContent
         */
        public function testMakeContent( $data, $title, $modelId, $format,
                $expectedModelId, $expectedNativeData, $shouldFail
        ) {
                $title = Title::newFromText( $title );

                try {
                        $content = ContentHandler::makeContent( $data, $title, $modelId, $format );

                        if ( $shouldFail ) {
                                $this->fail( "ContentHandler::makeContent should have failed!" );
                        }

                        $this->assertEquals( $expectedModelId, $content->getModel(), 'bad model id' );
                        $this->assertEquals( $expectedNativeData, $content->getNativeData(), 'bads native data' );
                } catch ( MWException $ex ) {
                        if ( !$shouldFail ) {
                                $this->fail( "ContentHandler::makeContent failed unexpectedly: " . $ex->getMessage() );
                        } else {
                                // dummy, so we don't get the "test did not perform any assertions" message.
                                $this->assertTrue( true );
                        }
                }
        }

        /*
        public function testSupportsSections() {
                $this->markTestIncomplete( "not yet implemented" );
        }
        */

        /**
         * @covers ContentHandler::runLegacyHooks
         */
        public function testRunLegacyHooks() {
                Hooks::register( 'testRunLegacyHooks', __CLASS__ . '::dummyHookHandler' );

                $content = new WikitextContent( 'test text' );
                $ok = ContentHandler::runLegacyHooks(
                        'testRunLegacyHooks',
                        array( 'foo', &$content, 'bar' ),
                        false
                );

                $this->assertTrue( $ok, "runLegacyHooks should have returned true" );
                $this->assertEquals( "TEST TEXT", $content->getNativeData() );
        }

        public static function dummyHookHandler( $foo, &$text, $bar ) {
                if ( $text === null || $text === false ) {
                        return false;
                }

                $text = strtoupper( $text );

                return true;
        }
}

class DummyContentHandlerForTesting extends ContentHandler {

        public function __construct( $dataModel ) {
                parent::__construct( $dataModel, array( "testing" ) );
        }

        /**
         * @see ContentHandler::serializeContent
         *
         * @param Content $content
         * @param string $format
         *
         * @return string
         */
        public function serializeContent( Content $content, $format = null ) {
                return $content->serialize();
        }

        /**
         * @see ContentHandler::unserializeContent
         *
         * @param string $blob
         * @param string $format Unused.
         *
         * @return Content
         */
        public function unserializeContent( $blob, $format = null ) {
                $d = unserialize( $blob );

                return new DummyContentForTesting( $d );
        }

        /**
         * Creates an empty Content object of the type supported by this ContentHandler.
         *
         */
        public function makeEmptyContent() {
                return new DummyContentForTesting( '' );
        }
}

class DummyContentForTesting extends AbstractContent {

        public function __construct( $data ) {
                parent::__construct( "testing" );

                $this->data = $data;
        }

        public function serialize( $format = null ) {
                return serialize( $this->data );
        }

        /**
         * @return string A string representing the content in a way useful for
         *   building a full text search index. If no useful representation exists,
         *   this method returns an empty string.
         */
        public function getTextForSearchIndex() {
                return '';
        }

        /**
         * @return string|bool The wikitext to include when another page includes this  content,
         *  or false if the content is not includable in a wikitext page.
         */
        public function getWikitextForTransclusion() {
                return false;
        }

        /**
         * Returns a textual representation of the content suitable for use in edit
         * summaries and log messages.
         *
         * @param int $maxlength Maximum length of the summary text.
         * @return string The summary text.
         */
        public function getTextForSummary( $maxlength = 250 ) {
                return '';
        }

        /**
         * Returns native represenation of the data. Interpretation depends on the data model used,
         * as given by getDataModel().
         *
         * @return mixed the native representation of the content. Could be a string, a nested array
         *  structure, an object, a binary blob... anything, really.
         */
        public function getNativeData() {
                return $this->data;
        }

        /**
         * returns the content's nominal size in bogo-bytes.
         *
         * @return int
         */
        public function getSize() {
                return strlen( $this->data );
        }

        /**
         * Return a copy of this Content object. The following must be true for the object returned
         * if $copy = $original->copy()
         *
         * * get_class($original) === get_class($copy)
         * * $original->getModel() === $copy->getModel()
         * * $original->equals( $copy )
         *
         * If and only if the Content object is imutable, the copy() method can and should
         * return $this. That is,  $copy === $original may be true, but only for imutable content
         * objects.
         *
         * @return Content. A copy of this object.
         */
        public function copy() {
                return $this;
        }

        /**
         * Returns true if this content is countable as a "real" wiki page, provided
         * that it's also in a countable location (e.g. a current revision in the main namespace).
         *
         * @param bool $hasLinks if it is known whether this content contains links,
         * provide this information here, to avoid redundant parsing to find out.
         * @return bool
         */
        public function isCountable( $hasLinks = null ) {
                return false;
        }

        /**
         * @param Title $title
         * @param int $revId Unused.
         * @param null|ParserOptions $options
         * @param bool $generateHtml whether to generate Html (default: true). If false, the result
         *  of calling getText() on the ParserOutput object returned by this method is undefined.
         *
         * @return ParserOutput
         */
        public function getParserOutput( Title $title, $revId = null,
                ParserOptions $options = null, $generateHtml = true
        ) {
                return new ParserOutput( $this->getNativeData() );
        }

        /**
         * @see AbstractContent::fillParserOutput()
         *
         * @param Title $title Context title for parsing
         * @param int|null $revId Revision ID (for {{REVISIONID}})
         * @param ParserOptions|null $options Parser options
         * @param bool $generateHtml Whether or not to generate HTML
         * @param ParserOutput &$output The output object to fill (reference).
         */
        protected function fillParserOutput( Title $title, $revId,
                        ParserOptions $options, $generateHtml, ParserOutput &$output ) {
                $output = new ParserOutput( $this->getNativeData() );
        }
}