MWNamespaceTest.php

Go to the documentation of this file.

<?php
class MWNamespaceTest extends MediaWikiTestCase {
    protected function setUp() {
        parent::setUp();
 
        $this->setMwGlobals( [
            'wgContentNamespaces' => [ NS_MAIN ],
            'wgNamespacesWithSubpages' => [
                NS_TALK => true,
                NS_USER => true,
                NS_USER_TALK => true,
            ],
            'wgCapitalLinks' => true,
            'wgCapitalLinkOverrides' => [],
            'wgNonincludableNamespaces' => [],
        ] );
    }
 
# ### START OF TESTS #########################################################
 
    public function testIsMovable() {
        $this->assertFalse( MWNamespace::isMovable( NS_SPECIAL ) );
        # @todo FIXME: Write more tests!!
    }
 
    public function testIsSubject() {
        // Special namespaces
        $this->assertIsSubject( NS_MEDIA );
        $this->assertIsSubject( NS_SPECIAL );
 
        // Subject pages
        $this->assertIsSubject( NS_MAIN );
        $this->assertIsSubject( NS_USER );
        $this->assertIsSubject( 100 ); # user defined
 
        // Talk pages
        $this->assertIsNotSubject( NS_TALK );
        $this->assertIsNotSubject( NS_USER_TALK );
        $this->assertIsNotSubject( 101 ); # user defined
    }
 
    public function testIsTalk() {
        // Special namespaces
        $this->assertIsNotTalk( NS_MEDIA );
        $this->assertIsNotTalk( NS_SPECIAL );
 
        // Subject pages
        $this->assertIsNotTalk( NS_MAIN );
        $this->assertIsNotTalk( NS_USER );
        $this->assertIsNotTalk( 100 ); # user defined
 
        // Talk pages
        $this->assertIsTalk( NS_TALK );
        $this->assertIsTalk( NS_USER_TALK );
        $this->assertIsTalk( 101 ); # user defined
    }
 
    public function testGetSubject() {
        // Special namespaces are their own subjects
        $this->assertEquals( NS_MEDIA, MWNamespace::getSubject( NS_MEDIA ) );
        $this->assertEquals( NS_SPECIAL, MWNamespace::getSubject( NS_SPECIAL ) );
 
        $this->assertEquals( NS_MAIN, MWNamespace::getSubject( NS_TALK ) );
        $this->assertEquals( NS_USER, MWNamespace::getSubject( NS_USER_TALK ) );
    }
 
    public function testGetTalk() {
        $this->assertEquals( NS_TALK, MWNamespace::getTalk( NS_MAIN ) );
        $this->assertEquals( NS_TALK, MWNamespace::getTalk( NS_TALK ) );
        $this->assertEquals( NS_USER_TALK, MWNamespace::getTalk( NS_USER ) );
        $this->assertEquals( NS_USER_TALK, MWNamespace::getTalk( NS_USER_TALK ) );
    }
 
    public function testGetTalkExceptionsForNsMedia() {
        $this->assertNull( MWNamespace::getTalk( NS_MEDIA ) );
    }
 
    public function testGetTalkExceptionsForNsSpecial() {
        $this->assertNull( MWNamespace::getTalk( NS_SPECIAL ) );
    }
 
    public function testGetAssociated() {
        $this->assertEquals( NS_TALK, MWNamespace::getAssociated( NS_MAIN ) );
        $this->assertEquals( NS_MAIN, MWNamespace::getAssociated( NS_TALK ) );
    }
 
    # ## Exceptions with getAssociated()
    # ## NS_MEDIA and NS_SPECIAL do not have talk pages. MediaWiki raises
    # ## an exception for them.
 
    public function testGetAssociatedExceptionsForNsMedia() {
        $this->assertNull( MWNamespace::getAssociated( NS_MEDIA ) );
    }
 
    public function testGetAssociatedExceptionsForNsSpecial() {
        $this->assertNull( MWNamespace::getAssociated( NS_SPECIAL ) );
    }
 
    /*
    public function testExists() {
        // Remove the following lines when you implement this test.
        $this->markTestIncomplete(
            'This test has not been implemented yet. Rely on $wgCanonicalNamespaces.'
        );
    }
    */
 
    public function testEquals() {
        $this->assertTrue( MWNamespace::equals( NS_MAIN, NS_MAIN ) );
        $this->assertTrue( MWNamespace::equals( NS_MAIN, 0 ) ); // In case we make NS_MAIN 'MAIN'
        $this->assertTrue( MWNamespace::equals( NS_USER, NS_USER ) );
        $this->assertTrue( MWNamespace::equals( NS_USER, 2 ) );
        $this->assertTrue( MWNamespace::equals( NS_USER_TALK, NS_USER_TALK ) );
        $this->assertTrue( MWNamespace::equals( NS_SPECIAL, NS_SPECIAL ) );
        $this->assertFalse( MWNamespace::equals( NS_MAIN, NS_TALK ) );
        $this->assertFalse( MWNamespace::equals( NS_USER, NS_USER_TALK ) );
        $this->assertFalse( MWNamespace::equals( NS_PROJECT, NS_TEMPLATE ) );
    }
 
    public function testSubjectEquals() {
        $this->assertSameSubject( NS_MAIN, NS_MAIN );
        $this->assertSameSubject( NS_MAIN, 0 ); // In case we make NS_MAIN 'MAIN'
        $this->assertSameSubject( NS_USER, NS_USER );
        $this->assertSameSubject( NS_USER, 2 );
        $this->assertSameSubject( NS_USER_TALK, NS_USER_TALK );
        $this->assertSameSubject( NS_SPECIAL, NS_SPECIAL );
        $this->assertSameSubject( NS_MAIN, NS_TALK );
        $this->assertSameSubject( NS_USER, NS_USER_TALK );
 
        $this->assertDifferentSubject( NS_PROJECT, NS_TEMPLATE );
        $this->assertDifferentSubject( NS_SPECIAL, NS_MAIN );
    }
 
    public function testSpecialAndMediaAreDifferentSubjects() {
        $this->assertDifferentSubject(
            NS_MEDIA, NS_SPECIAL,
            "NS_MEDIA and NS_SPECIAL are different subject namespaces"
        );
        $this->assertDifferentSubject(
            NS_SPECIAL, NS_MEDIA,
            "NS_SPECIAL and NS_MEDIA are different subject namespaces"
        );
    }
 
    /*
    public function testGetCanonicalNamespaces() {
        // Remove the following lines when you implement this test.
        $this->markTestIncomplete(
            'This test has not been implemented yet. Rely on $wgCanonicalNamespaces.'
        );
    }
    */
    /*
        public function testGetCanonicalName() {
            // Remove the following lines when you implement this test.
            $this->markTestIncomplete(
                'This test has not been implemented yet. Rely on $wgCanonicalNamespaces.'
            );
        }
    */
    /*
    public function testGetCanonicalIndex() {
        // Remove the following lines when you implement this test.
        $this->markTestIncomplete(
            'This test has not been implemented yet. Rely on $wgCanonicalNamespaces.'
        );
    }
    */
 
    /*
    public function testGetValidNamespaces() {
        // Remove the following lines when you implement this test.
        $this->markTestIncomplete(
            'This test has not been implemented yet. Rely on $wgCanonicalNamespaces.'
        );
    }
    */
 
    public function provideHasTalkNamespace() {
        return [
            [ NS_MEDIA, false ],
            [ NS_SPECIAL, false ],
 
            [ NS_MAIN, true ],
            [ NS_TALK, true ],
            [ NS_USER, true ],
            [ NS_USER_TALK, true ],
 
            [ 100, true ],
            [ 101, true ],
        ];
    }
 
    public function testHasTalkNamespace( $index, $expected ) {
        $actual = MWNamespace::hasTalkNamespace( $index );
        $this->assertSame( $actual, $expected, "NS $index" );
    }
 
    public function testCanTalk( $index, $expected ) {
        $actual = MWNamespace::canTalk( $index );
        $this->assertSame( $actual, $expected, "NS $index" );
    }
 
    public function testIsContent() {
        // NS_MAIN is a content namespace per DefaultSettings.php
        // and per function definition.
 
        $this->assertIsContent( NS_MAIN );
 
        // Other namespaces which are not expected to be content
 
        $this->assertIsNotContent( NS_MEDIA );
        $this->assertIsNotContent( NS_SPECIAL );
        $this->assertIsNotContent( NS_TALK );
        $this->assertIsNotContent( NS_USER );
        $this->assertIsNotContent( NS_CATEGORY );
        $this->assertIsNotContent( 100 );
    }
 
    public function testIsContentAdvanced() {
        global $wgContentNamespaces;
 
        // Test that user defined namespace #252 is not content
        $this->assertIsNotContent( 252 );
 
        // Bless namespace # 252 as a content namespace
        $wgContentNamespaces[] = 252;
 
        $this->assertIsContent( 252 );
 
        // Makes sure NS_MAIN was not impacted
        $this->assertIsContent( NS_MAIN );
    }
 
    public function testIsWatchable() {
        // Specials namespaces are not watchable
        $this->assertIsNotWatchable( NS_MEDIA );
        $this->assertIsNotWatchable( NS_SPECIAL );
 
        // Core defined namespaces are watchables
        $this->assertIsWatchable( NS_MAIN );
        $this->assertIsWatchable( NS_TALK );
 
        // Additional, user defined namespaces are watchables
        $this->assertIsWatchable( 100 );
        $this->assertIsWatchable( 101 );
    }
 
    public function testHasSubpages() {
        global $wgNamespacesWithSubpages;
 
        // Special namespaces:
        $this->assertHasNotSubpages( NS_MEDIA );
        $this->assertHasNotSubpages( NS_SPECIAL );
 
        // Namespaces without subpages
        $this->assertHasNotSubpages( NS_MAIN );
 
        $wgNamespacesWithSubpages[NS_MAIN] = true;
        $this->assertHasSubpages( NS_MAIN );
 
        $wgNamespacesWithSubpages[NS_MAIN] = false;
        $this->assertHasNotSubpages( NS_MAIN );
 
        // Some namespaces with subpages
        $this->assertHasSubpages( NS_TALK );
        $this->assertHasSubpages( NS_USER );
        $this->assertHasSubpages( NS_USER_TALK );
    }
 
    public function testGetContentNamespaces() {
        global $wgContentNamespaces;
 
        $this->assertEquals(
            [ NS_MAIN ],
            MWNamespace::getContentNamespaces(),
            '$wgContentNamespaces is an array with only NS_MAIN by default'
        );
 
        # test !is_array( $wgcontentNamespaces )
        $wgContentNamespaces = '';
        $this->assertEquals( [ NS_MAIN ], MWNamespace::getContentNamespaces() );
 
        $wgContentNamespaces = false;
        $this->assertEquals( [ NS_MAIN ], MWNamespace::getContentNamespaces() );
 
        $wgContentNamespaces = null;
        $this->assertEquals( [ NS_MAIN ], MWNamespace::getContentNamespaces() );
 
        $wgContentNamespaces = 5;
        $this->assertEquals( [ NS_MAIN ], MWNamespace::getContentNamespaces() );
 
        # test $wgContentNamespaces === []
        $wgContentNamespaces = [];
        $this->assertEquals( [ NS_MAIN ], MWNamespace::getContentNamespaces() );
 
        # test !in_array( NS_MAIN, $wgContentNamespaces )
        $wgContentNamespaces = [ NS_USER, NS_CATEGORY ];
        $this->assertEquals(
            [ NS_MAIN, NS_USER, NS_CATEGORY ],
            MWNamespace::getContentNamespaces(),
            'NS_MAIN is forced in $wgContentNamespaces even if unwanted'
        );
 
        # test other cases, return $wgcontentNamespaces as is
        $wgContentNamespaces = [ NS_MAIN ];
        $this->assertEquals(
            [ NS_MAIN ],
            MWNamespace::getContentNamespaces()
        );
 
        $wgContentNamespaces = [ NS_MAIN, NS_USER, NS_CATEGORY ];
        $this->assertEquals(
            [ NS_MAIN, NS_USER, NS_CATEGORY ],
            MWNamespace::getContentNamespaces()
        );
    }
 
    public function testGetSubjectNamespaces() {
        $subjectsNS = MWNamespace::getSubjectNamespaces();
        $this->assertContains( NS_MAIN, $subjectsNS,
            "Talk namespaces should have NS_MAIN" );
        $this->assertNotContains( NS_TALK, $subjectsNS,
            "Talk namespaces should have NS_TALK" );
 
        $this->assertNotContains( NS_MEDIA, $subjectsNS,
            "Talk namespaces should not have NS_MEDIA" );
        $this->assertNotContains( NS_SPECIAL, $subjectsNS,
            "Talk namespaces should not have NS_SPECIAL" );
    }
 
    public function testGetTalkNamespaces() {
        $talkNS = MWNamespace::getTalkNamespaces();
        $this->assertContains( NS_TALK, $talkNS,
            "Subject namespaces should have NS_TALK" );
        $this->assertNotContains( NS_MAIN, $talkNS,
            "Subject namespaces should not have NS_MAIN" );
 
        $this->assertNotContains( NS_MEDIA, $talkNS,
            "Subject namespaces should not have NS_MEDIA" );
        $this->assertNotContains( NS_SPECIAL, $talkNS,
            "Subject namespaces should not have NS_SPECIAL" );
    }
 
    public function testIsCapitalizedHardcodedAssertions() {
        // NS_MEDIA and NS_FILE are treated the same
        $this->assertEquals(
            MWNamespace::isCapitalized( NS_MEDIA ),
            MWNamespace::isCapitalized( NS_FILE ),
            'NS_MEDIA and NS_FILE have same capitalization rendering'
        );
 
        // Boths are capitalized by default
        $this->assertIsCapitalized( NS_MEDIA );
        $this->assertIsCapitalized( NS_FILE );
 
        // Always capitalized namespaces
        // @see MWNamespace::$alwaysCapitalizedNamespaces
        $this->assertIsCapitalized( NS_SPECIAL );
        $this->assertIsCapitalized( NS_USER );
        $this->assertIsCapitalized( NS_MEDIAWIKI );
    }
 
    public function testIsCapitalizedWithWgCapitalLinks() {
        global $wgCapitalLinks;
 
        $this->assertIsCapitalized( NS_PROJECT );
        $this->assertIsCapitalized( NS_PROJECT_TALK );
 
        $wgCapitalLinks = false;
 
        // hardcoded namespaces (see above function) are still capitalized:
        $this->assertIsCapitalized( NS_SPECIAL );
        $this->assertIsCapitalized( NS_USER );
        $this->assertIsCapitalized( NS_MEDIAWIKI );
 
        // setting is correctly applied
        $this->assertIsNotCapitalized( NS_PROJECT );
        $this->assertIsNotCapitalized( NS_PROJECT_TALK );
    }
 
    public function testIsCapitalizedWithWgCapitalLinkOverrides() {
        global $wgCapitalLinkOverrides;
 
        // Test default settings
        $this->assertIsCapitalized( NS_PROJECT );
        $this->assertIsCapitalized( NS_PROJECT_TALK );
 
        // hardcoded namespaces (see above function) are capitalized:
        $this->assertIsCapitalized( NS_SPECIAL );
        $this->assertIsCapitalized( NS_USER );
        $this->assertIsCapitalized( NS_MEDIAWIKI );
 
        // Hardcoded namespaces remains capitalized
        $wgCapitalLinkOverrides[NS_SPECIAL] = false;
        $wgCapitalLinkOverrides[NS_USER] = false;
        $wgCapitalLinkOverrides[NS_MEDIAWIKI] = false;
 
        $this->assertIsCapitalized( NS_SPECIAL );
        $this->assertIsCapitalized( NS_USER );
        $this->assertIsCapitalized( NS_MEDIAWIKI );
 
        $wgCapitalLinkOverrides[NS_PROJECT] = false;
        $this->assertIsNotCapitalized( NS_PROJECT );
 
        $wgCapitalLinkOverrides[NS_PROJECT] = true;
        $this->assertIsCapitalized( NS_PROJECT );
 
        unset( $wgCapitalLinkOverrides[NS_PROJECT] );
        $this->assertIsCapitalized( NS_PROJECT );
    }
 
    public function testHasGenderDistinction() {
        // Namespaces with gender distinctions
        $this->assertTrue( MWNamespace::hasGenderDistinction( NS_USER ) );
        $this->assertTrue( MWNamespace::hasGenderDistinction( NS_USER_TALK ) );
 
        // Other ones, "genderless"
        $this->assertFalse( MWNamespace::hasGenderDistinction( NS_MEDIA ) );
        $this->assertFalse( MWNamespace::hasGenderDistinction( NS_SPECIAL ) );
        $this->assertFalse( MWNamespace::hasGenderDistinction( NS_MAIN ) );
        $this->assertFalse( MWNamespace::hasGenderDistinction( NS_TALK ) );
    }
 
    public function testIsNonincludable() {
        global $wgNonincludableNamespaces;
 
        $wgNonincludableNamespaces = [ NS_USER ];
 
        $this->assertTrue( MWNamespace::isNonincludable( NS_USER ) );
        $this->assertFalse( MWNamespace::isNonincludable( NS_TEMPLATE ) );
    }
 
    # ###### HELPERS ###########################################################
    function __call( $method, $args ) {
        // Call the real method if it exists
        if ( method_exists( $this, $method ) ) {
            return $this->$method( $args );
        }
 
        if ( preg_match(
            '/^assert(Has|Is|Can)(Not|)(Subject|Talk|Watchable|Content|Subpages|Capitalized)$/',
            $method,
            $m
        ) ) {
            # Interprets arguments:
            $ns = $args[0];
            $msg = isset( $args[1] ) ? $args[1] : " dummy message";
 
            # Forge the namespace constant name:
            if ( $ns === 0 ) {
                $ns_name = "NS_MAIN";
            } else {
                $ns_name = "NS_" . strtoupper( MWNamespace::getCanonicalName( $ns ) );
            }
            # ... and the MWNamespace method name
            $nsMethod = strtolower( $m[1] ) . $m[3];
 
            $expect = ( $m[2] === '' );
            $expect_name = $expect ? 'TRUE' : 'FALSE';
 
            return $this->assertEquals( $expect,
                MWNamespace::$nsMethod( $ns, $msg ),
                "MWNamespace::$nsMethod( $ns_name ) should returns $expect_name"
            );
        }
 
        throw new Exception( __METHOD__ . " could not find a method named $method\n" );
    }
 
    function assertSameSubject( $ns1, $ns2, $msg = '' ) {
        $this->assertTrue( MWNamespace::subjectEquals( $ns1, $ns2, $msg ) );
    }
 
    function assertDifferentSubject( $ns1, $ns2, $msg = '' ) {
        $this->assertFalse( MWNamespace::subjectEquals( $ns1, $ns2, $msg ) );
    }
}