ApiModuleManagerTest.php

Go to the documentation of this file.

<?php

class ApiModuleManagerTest extends MediaWikiTestCase {

    private function getModuleManager() {
        $request = new FauxRequest();
        $main = new ApiMain( $request );
        return new ApiModuleManager( $main );
    }

    public function newApiLogin( $main, $action ) {
        return new ApiLogin( $main, $action );
    }

    public function addModuleProvider() {
        return array(
            'plain class' => array(
                'login',
                'action',
                'ApiLogin',
                null,
            ),

            'with factory' => array(
                'login',
                'action',
                'ApiLogin',
                array( $this, 'newApiLogin' ),
            ),

            'with closure' => array(
                'logout',
                'action',
                'ApiLogout',
                function ( ApiMain $main, $action ) {
                    return new ApiLogout( $main, $action );
                },
            ),
        );
    }

    public function testAddModule( $name, $group, $class, $factory = null ) {
        $moduleManager = $this->getModuleManager();
        $moduleManager->addModule( $name, $group, $class, $factory );

        $this->assertTrue( $moduleManager->isDefined( $name, $group ), 'isDefined' );
        $this->assertNotNull( $moduleManager->getModule( $name, $group, true ), 'getModule' );
    }

    public function addModulesProvider() {
        return array(
            'empty' => array(
                array(),
                'action',
            ),

            'simple' => array(
                array(
                    'login' => 'ApiLogin',
                    'logout' => 'ApiLogout',
                ),
                'action',
            ),

            'with factories' => array(
                array(
                    'login' => array(
                        'class' => 'ApiLogin',
                        'factory' => array( $this, 'newApiLogin' ),
                    ),
                    'logout' => array(
                        'class' => 'ApiLogout',
                        'factory' => function ( ApiMain $main, $action ) {
                            return new ApiLogout( $main, $action );
                        },
                    ),
                ),
                'action',
            ),
        );
    }

    public function testAddModules( array $modules, $group ) {
        $moduleManager = $this->getModuleManager();
        $moduleManager->addModules( $modules, $group );

        foreach ( array_keys( $modules ) as $name ) {
            $this->assertTrue( $moduleManager->isDefined( $name, $group ), 'isDefined' );
            $this->assertNotNull( $moduleManager->getModule( $name, $group, true ), 'getModule' );
        }

        $this->assertTrue( true ); // Don't mark the test as risky if $modules is empty
    }

    public function getModuleProvider() {
        $modules = array(
            'feedrecentchanges' => 'ApiFeedRecentChanges',
            'feedcontributions' => array( 'class' => 'ApiFeedContributions' ),
            'login' => array(
                'class' => 'ApiLogin',
                'factory' => array( $this, 'newApiLogin' ),
            ),
            'logout' => array(
                'class' => 'ApiLogout',
                'factory' => function ( ApiMain $main, $action ) {
                    return new ApiLogout( $main, $action );
                },
            ),
        );

        return array(
            'legacy entry' => array(
                $modules,
                'feedrecentchanges',
                'ApiFeedRecentChanges',
            ),

            'just a class' => array(
                $modules,
                'feedcontributions',
                'ApiFeedContributions',
            ),

            'with factory' => array(
                $modules,
                'login',
                'ApiLogin',
            ),

            'with closure' => array(
                $modules,
                'logout',
                'ApiLogout',
            ),
        );
    }

    public function testGetModule( $modules, $name, $expectedClass ) {
        $moduleManager = $this->getModuleManager();
        $moduleManager->addModules( $modules, 'test' );

        // should return the right module
        $module1 = $moduleManager->getModule( $name, null, false );
        $this->assertInstanceOf( $expectedClass, $module1 );

        // should pass group check (with caching disabled)
        $module2 = $moduleManager->getModule( $name, 'test', true );
        $this->assertNotNull( $module2 );

        // should use cached instance
        $module3 = $moduleManager->getModule( $name, null, false );
        $this->assertSame( $module1, $module3 );

        // should not use cached instance if caching is disabled
        $module4 = $moduleManager->getModule( $name, null, true );
        $this->assertNotSame( $module1, $module4 );
    }

    public function testGetModule_null() {
        $modules = array(
            'login' => 'ApiLogin',
            'logout' => 'ApiLogout',
        );

        $moduleManager = $this->getModuleManager();
        $moduleManager->addModules( $modules, 'test' );

        $this->assertNull( $moduleManager->getModule( 'quux' ), 'unknown name' );
        $this->assertNull( $moduleManager->getModule( 'login', 'bla' ), 'wrong group' );
    }

    public function testGetNames() {
        $fooModules = array(
            'login' => 'ApiLogin',
            'logout' => 'ApiLogout',
        );

        $barModules = array(
            'feedcontributions' => array( 'class' => 'ApiFeedContributions' ),
            'feedrecentchanges' => array( 'class' => 'ApiFeedRecentChanges' ),
        );

        $moduleManager = $this->getModuleManager();
        $moduleManager->addModules( $fooModules, 'foo' );
        $moduleManager->addModules( $barModules, 'bar' );

        $fooNames = $moduleManager->getNames( 'foo' );
        $this->assertArrayEquals( array_keys( $fooModules ), $fooNames );

        $allNames = $moduleManager->getNames();
        $allModules = array_merge( $fooModules, $barModules );
        $this->assertArrayEquals( array_keys( $allModules ), $allNames );
    }

    public function testGetNamesWithClasses() {
        $fooModules = array(
            'login' => 'ApiLogin',
            'logout' => 'ApiLogout',
        );

        $barModules = array(
            'feedcontributions' => array( 'class' => 'ApiFeedContributions' ),
            'feedrecentchanges' => array( 'class' => 'ApiFeedRecentChanges' ),
        );

        $moduleManager = $this->getModuleManager();
        $moduleManager->addModules( $fooModules, 'foo' );
        $moduleManager->addModules( $barModules, 'bar' );

        $fooNamesWithClasses = $moduleManager->getNamesWithClasses( 'foo' );
        $this->assertArrayEquals( $fooModules, $fooNamesWithClasses );

        $allNamesWithClasses = $moduleManager->getNamesWithClasses();
        $allModules = array_merge( $fooModules, array(
            'feedcontributions' => 'ApiFeedContributions',
            'feedrecentchanges' => 'ApiFeedRecentChanges',
        ) );
        $this->assertArrayEquals( $allModules, $allNamesWithClasses );
    }

    public function testGetModuleGroup() {
        $fooModules = array(
            'login' => 'ApiLogin',
            'logout' => 'ApiLogout',
        );

        $barModules = array(
            'feedcontributions' => array( 'class' => 'ApiFeedContributions' ),
            'feedrecentchanges' => array( 'class' => 'ApiFeedRecentChanges' ),
        );

        $moduleManager = $this->getModuleManager();
        $moduleManager->addModules( $fooModules, 'foo' );
        $moduleManager->addModules( $barModules, 'bar' );

        $this->assertEquals( 'foo', $moduleManager->getModuleGroup( 'login' ) );
        $this->assertEquals( 'bar', $moduleManager->getModuleGroup( 'feedrecentchanges' ) );
        $this->assertNull( $moduleManager->getModuleGroup( 'quux' ) );
    }

    public function testGetGroups() {
        $fooModules = array(
            'login' => 'ApiLogin',
            'logout' => 'ApiLogout',
        );

        $barModules = array(
            'feedcontributions' => array( 'class' => 'ApiFeedContributions' ),
            'feedrecentchanges' => array( 'class' => 'ApiFeedRecentChanges' ),
        );

        $moduleManager = $this->getModuleManager();
        $moduleManager->addModules( $fooModules, 'foo' );
        $moduleManager->addModules( $barModules, 'bar' );

        $groups = $moduleManager->getGroups();
        $this->assertArrayEquals( array( 'foo', 'bar' ), $groups );
    }

    public function testGetClassName() {
        $fooModules = array(
            'login' => 'ApiLogin',
            'logout' => 'ApiLogout',
        );

        $barModules = array(
            'feedcontributions' => array( 'class' => 'ApiFeedContributions' ),
            'feedrecentchanges' => array( 'class' => 'ApiFeedRecentChanges' ),
        );

        $moduleManager = $this->getModuleManager();
        $moduleManager->addModules( $fooModules, 'foo' );
        $moduleManager->addModules( $barModules, 'bar' );

        $this->assertEquals( 'ApiLogin', $moduleManager->getClassName( 'login' ) );
        $this->assertEquals( 'ApiLogout', $moduleManager->getClassName( 'logout' ) );
        $this->assertEquals( 'ApiFeedContributions', $moduleManager->getClassName( 'feedcontributions' ) );
        $this->assertEquals( 'ApiFeedRecentChanges', $moduleManager->getClassName( 'feedrecentchanges' ) );
        $this->assertFalse( $moduleManager->getClassName( 'nonexistentmodule' ) );
    }


}