LogFormatterTest.php

Go to the documentation of this file.

<?php

class LogFormatterTest extends MediaWikiLangTestCase {

    protected $user;

    protected $title;

    protected $context;

    protected $target;

    protected $user_comment;

    protected function setUp() {
        parent::setUp();

        global $wgLang;

        $this->setMwGlobals( [
            'wgLogTypes' => [ 'phpunit' ],
            'wgLogActionsHandlers' => [ 'phpunit/test' => 'LogFormatter',
                'phpunit/param' => 'LogFormatter' ],
            'wgUser' => User::newFromName( 'Testuser' ),
            'wgExtensionMessagesFiles' => [ 'LogTests' => __DIR__ . '/LogTests.i18n.php' ],
        ] );

        Language::getLocalisationCache()->recache( $wgLang->getCode() );

        $this->user = User::newFromName( 'Testuser' );
        $this->title = Title::newFromText( 'SomeTitle' );
        $this->target = Title::newFromText( 'TestTarget' );

        $this->context = new RequestContext();
        $this->context->setUser( $this->user );
        $this->context->setTitle( $this->title );
        $this->context->setLanguage( $wgLang );

        $this->user_comment = '<User comment about action>';
    }

    protected function tearDown() {
        parent::tearDown();

        global $wgLang;
        Language::getLocalisationCache()->recache( $wgLang->getCode() );
    }

    public function newLogEntry( $action, $params ) {
        $logEntry = new ManualLogEntry( 'phpunit', $action );
        $logEntry->setPerformer( $this->user );
        $logEntry->setTarget( $this->title );
        $logEntry->setComment( 'A very good reason' );

        $logEntry->setParameters( $params );

        return $logEntry;
    }

    public function testNormalLogParams() {
        $entry = $this->newLogEntry( 'test', [] );
        $formatter = LogFormatter::newFromEntry( $entry );
        $formatter->setContext( $this->context );

        $formatter->setShowUserToolLinks( false );
        $paramsWithoutTools = $formatter->getMessageParametersForTesting();
        unset( $formatter->parsedParameters );

        $formatter->setShowUserToolLinks( true );
        $paramsWithTools = $formatter->getMessageParametersForTesting();

        $userLink = Linker::userLink(
            $this->user->getId(),
            $this->user->getName()
        );

        $userTools = Linker::userToolLinksRedContribs(
            $this->user->getId(),
            $this->user->getName(),
            $this->user->getEditCount()
        );

        $titleLink = Linker::link( $this->title, null, [], [] );

        // $paramsWithoutTools and $paramsWithTools should be only different
        // in index 0
        $this->assertEquals( $paramsWithoutTools[1], $paramsWithTools[1] );
        $this->assertEquals( $paramsWithoutTools[2], $paramsWithTools[2] );

        $this->assertEquals( $userLink, $paramsWithoutTools[0]['raw'] );
        $this->assertEquals( $userLink . $userTools, $paramsWithTools[0]['raw'] );

        $this->assertEquals( $this->user->getName(), $paramsWithoutTools[1] );

        $this->assertEquals( $titleLink, $paramsWithoutTools[2]['raw'] );
    }

    public function testLogParamsTypeRaw() {
        $params = [ '4:raw:raw' => Linker::link( $this->title, null, [], [] ) ];
        $expected = Linker::link( $this->title, null, [], [] );

        $entry = $this->newLogEntry( 'param', $params );
        $formatter = LogFormatter::newFromEntry( $entry );
        $formatter->setContext( $this->context );

        $logParam = $formatter->getActionText();

        $this->assertEquals( $expected, $logParam );
    }

    public function testLogParamsTypeMsg() {
        $params = [ '4:msg:msg' => 'log-description-phpunit' ];
        $expected = wfMessage( 'log-description-phpunit' )->text();

        $entry = $this->newLogEntry( 'param', $params );
        $formatter = LogFormatter::newFromEntry( $entry );
        $formatter->setContext( $this->context );

        $logParam = $formatter->getActionText();

        $this->assertEquals( $expected, $logParam );
    }

    public function testLogParamsTypeMsgContent() {
        $params = [ '4:msg-content:msgContent' => 'log-description-phpunit' ];
        $expected = wfMessage( 'log-description-phpunit' )->inContentLanguage()->text();

        $entry = $this->newLogEntry( 'param', $params );
        $formatter = LogFormatter::newFromEntry( $entry );
        $formatter->setContext( $this->context );

        $logParam = $formatter->getActionText();

        $this->assertEquals( $expected, $logParam );
    }

    public function testLogParamsTypeNumber() {
        global $wgLang;

        $params = [ '4:number:number' => 123456789 ];
        $expected = $wgLang->formatNum( 123456789 );

        $entry = $this->newLogEntry( 'param', $params );
        $formatter = LogFormatter::newFromEntry( $entry );
        $formatter->setContext( $this->context );

        $logParam = $formatter->getActionText();

        $this->assertEquals( $expected, $logParam );
    }

    public function testLogParamsTypeUserLink() {
        $params = [ '4:user-link:userLink' => $this->user->getName() ];
        $expected = Linker::userLink(
            $this->user->getId(),
            $this->user->getName()
        );

        $entry = $this->newLogEntry( 'param', $params );
        $formatter = LogFormatter::newFromEntry( $entry );
        $formatter->setContext( $this->context );

        $logParam = $formatter->getActionText();

        $this->assertEquals( $expected, $logParam );
    }

    public function testLogParamsTypeTitleLink() {
        $params = [ '4:title-link:titleLink' => $this->title->getText() ];
        $expected = Linker::link( $this->title, null, [], [] );

        $entry = $this->newLogEntry( 'param', $params );
        $formatter = LogFormatter::newFromEntry( $entry );
        $formatter->setContext( $this->context );

        $logParam = $formatter->getActionText();

        $this->assertEquals( $expected, $logParam );
    }

    public function testLogParamsTypePlain() {
        $params = [ '4:plain:plain' => 'Some plain text' ];
        $expected = 'Some plain text';

        $entry = $this->newLogEntry( 'param', $params );
        $formatter = LogFormatter::newFromEntry( $entry );
        $formatter->setContext( $this->context );

        $logParam = $formatter->getActionText();

        $this->assertEquals( $expected, $logParam );
    }

    public function testLogComment() {
        $entry = $this->newLogEntry( 'test', [] );
        $formatter = LogFormatter::newFromEntry( $entry );
        $formatter->setContext( $this->context );

        $comment = ltrim( Linker::commentBlock( $entry->getComment() ) );

        $this->assertEquals( $comment, $formatter->getComment() );
    }

    public function testApiParamFormatting( $key, $value, $expected ) {
        $entry = $this->newLogEntry( 'param', [ $key => $value ] );
        $formatter = LogFormatter::newFromEntry( $entry );
        $formatter->setContext( $this->context );

        ApiResult::setIndexedTagName( $expected, 'param' );
        ApiResult::setArrayType( $expected, 'assoc' );

        $this->assertEquals( $expected, $formatter->formatParametersForApi() );
    }

    public static function provideApiParamFormatting() {
        return [
            [ 0, 'value', [ 'value' ] ],
            [ 'named', 'value', [ 'named' => 'value' ] ],
            [ '::key', 'value', [ 'key' => 'value' ] ],
            [ '4::key', 'value', [ 'key' => 'value' ] ],
            [ '4:raw:key', 'value', [ 'key' => 'value' ] ],
            [ '4:plain:key', 'value', [ 'key' => 'value' ] ],
            [ '4:bool:key', '1', [ 'key' => true ] ],
            [ '4:bool:key', '0', [ 'key' => false ] ],
            [ '4:number:key', '123', [ 'key' => 123 ] ],
            [ '4:number:key', '123.5', [ 'key' => 123.5 ] ],
            [ '4:array:key', [], [ 'key' => [ ApiResult::META_TYPE => 'array' ] ] ],
            [ '4:assoc:key', [], [ 'key' => [ ApiResult::META_TYPE => 'assoc' ] ] ],
            [ '4:kvp:key', [], [ 'key' => [ ApiResult::META_TYPE => 'kvp' ] ] ],
            [ '4:timestamp:key', '20150102030405', [ 'key' => '2015-01-02T03:04:05Z' ] ],
            [ '4:msg:key', 'parentheses', [
                'key_key' => 'parentheses',
                'key_text' => wfMessage( 'parentheses' )->text(),
            ] ],
            [ '4:msg-content:key', 'parentheses', [
                'key_key' => 'parentheses',
                'key_text' => wfMessage( 'parentheses' )->inContentLanguage()->text(),
            ] ],
            [ '4:title:key', 'project:foo', [
                'key_ns' => NS_PROJECT,
                'key_title' => Title::newFromText( 'project:foo' )->getFullText(),
            ] ],
            [ '4:title-link:key', 'project:foo', [
                'key_ns' => NS_PROJECT,
                'key_title' => Title::newFromText( 'project:foo' )->getFullText(),
            ] ],
            [ '4:user:key', 'foo', [ 'key' => 'Foo' ] ],
            [ '4:user-link:key', 'foo', [ 'key' => 'Foo' ] ],
        ];
    }

    public function testIrcMsgForLogTypeBlock() {
        $sep = $this->context->msg( 'colon-separator' )->text();

        # block/block
        $this->assertIRCComment(
            $this->context->msg( 'blocklogentry', 'SomeTitle', 'duration', '(flags)' )->plain()
            . $sep . $this->user_comment,
            'block', 'block',
            [
                '5::duration' => 'duration',
                '6::flags' => 'flags',
            ],
            $this->user_comment
        );
        # block/block - legacy
        $this->assertIRCComment(
            $this->context->msg( 'blocklogentry', 'SomeTitle', 'duration', '(flags)' )->plain()
            . $sep . $this->user_comment,
            'block', 'block',
            [
                'duration',
                'flags',
            ],
            $this->user_comment,
            '',
            true
        );
        # block/unblock
        $this->assertIRCComment(
            $this->context->msg( 'unblocklogentry', 'SomeTitle' )->plain() . $sep . $this->user_comment,
            'block', 'unblock',
            [],
            $this->user_comment
        );
        # block/reblock
        $this->assertIRCComment(
            $this->context->msg( 'reblock-logentry', 'SomeTitle', 'duration', '(flags)' )->plain()
            . $sep . $this->user_comment,
            'block', 'reblock',
            [
                '5::duration' => 'duration',
                '6::flags' => 'flags',
            ],
            $this->user_comment
        );
    }

    public function testIrcMsgForLogTypeDelete() {
        $sep = $this->context->msg( 'colon-separator' )->text();

        # delete/delete
        $this->assertIRCComment(
            $this->context->msg( 'deletedarticle', 'SomeTitle' )->plain() . $sep . $this->user_comment,
            'delete', 'delete',
            [],
            $this->user_comment
        );

        # delete/restore
        $this->assertIRCComment(
            $this->context->msg( 'undeletedarticle', 'SomeTitle' )->plain() . $sep . $this->user_comment,
            'delete', 'restore',
            [],
            $this->user_comment
        );
    }

    public function testIrcMsgForLogTypeNewusers() {
        $this->assertIRCComment(
            'New user account',
            'newusers', 'newusers',
            []
        );
        $this->assertIRCComment(
            'New user account',
            'newusers', 'create',
            []
        );
        $this->assertIRCComment(
            'created new account SomeTitle',
            'newusers', 'create2',
            []
        );
        $this->assertIRCComment(
            'Account created automatically',
            'newusers', 'autocreate',
            []
        );
    }

    public function testIrcMsgForLogTypeMove() {
        $move_params = [
            '4::target' => $this->target->getPrefixedText(),
            '5::noredir' => 0,
        ];
        $sep = $this->context->msg( 'colon-separator' )->text();

        # move/move
        $this->assertIRCComment(
            $this->context->msg( '1movedto2', 'SomeTitle', 'TestTarget' )
                ->plain() . $sep . $this->user_comment,
            'move', 'move',
            $move_params,
            $this->user_comment
        );

        # move/move_redir
        $this->assertIRCComment(
            $this->context->msg( '1movedto2_redir', 'SomeTitle', 'TestTarget' )
                ->plain() . $sep . $this->user_comment,
            'move', 'move_redir',
            $move_params,
            $this->user_comment
        );
    }

    public function testIrcMsgForLogTypePatrol() {
        # patrol/patrol
        $this->assertIRCComment(
            $this->context->msg( 'patrol-log-line', 'revision 777', '[[SomeTitle]]', '' )->plain(),
            'patrol', 'patrol',
            [
                '4::curid' => '777',
                '5::previd' => '666',
                '6::auto' => 0,
            ]
        );
    }

    public function testIrcMsgForLogTypeProtect() {
        $protectParams = [
            '4::description' => '[edit=sysop] (indefinite) ‎[move=sysop] (indefinite)'
        ];
        $sep = $this->context->msg( 'colon-separator' )->text();

        # protect/protect
        $this->assertIRCComment(
            $this->context->msg( 'protectedarticle', 'SomeTitle ' . $protectParams['4::description'] )
                ->plain() . $sep . $this->user_comment,
            'protect', 'protect',
            $protectParams,
            $this->user_comment
        );

        # protect/unprotect
        $this->assertIRCComment(
            $this->context->msg( 'unprotectedarticle', 'SomeTitle' )->plain() . $sep . $this->user_comment,
            'protect', 'unprotect',
            [],
            $this->user_comment
        );

        # protect/modify
        $this->assertIRCComment(
            $this->context->msg(
                'modifiedarticleprotection',
                'SomeTitle ' . $protectParams['4::description']
            )->plain() . $sep . $this->user_comment,
            'protect', 'modify',
            $protectParams,
            $this->user_comment
        );

        # protect/move_prot
        $this->assertIRCComment(
            $this->context->msg( 'movedarticleprotection', 'SomeTitle', 'OldTitle' )
                ->plain() . $sep . $this->user_comment,
            'protect', 'move_prot',
            [
                '4::oldtitle' => 'OldTitle'
            ],
            $this->user_comment
        );
    }

    public function testIrcMsgForLogTypeUpload() {
        $sep = $this->context->msg( 'colon-separator' )->text();

        # upload/upload
        $this->assertIRCComment(
            $this->context->msg( 'uploadedimage', 'SomeTitle' )->plain() . $sep . $this->user_comment,
            'upload', 'upload',
            [],
            $this->user_comment
        );

        # upload/overwrite
        $this->assertIRCComment(
            $this->context->msg( 'overwroteimage', 'SomeTitle' )->plain() . $sep . $this->user_comment,
            'upload', 'overwrite',
            [],
            $this->user_comment
        );
    }

    public function testIrcMsgForLogTypeMerge() {
        $sep = $this->context->msg( 'colon-separator' )->text();

        # merge/merge
        $this->assertIRCComment(
            $this->context->msg( 'pagemerge-logentry', 'SomeTitle', 'Dest', 'timestamp' )->plain()
            . $sep . $this->user_comment,
            'merge', 'merge',
            [
                '4::dest' => 'Dest',
                '5::mergepoint' => 'timestamp',
            ],
            $this->user_comment
        );
    }

    public function testIrcMsgForLogTypeImport() {
        $sep = $this->context->msg( 'colon-separator' )->text();

        # import/upload
        $msg = $this->context->msg( 'import-logentry-upload', 'SomeTitle' )->plain() .
            $sep .
            $this->user_comment;
        $this->assertIRCComment(
            $msg,
            'import', 'upload',
            [],
            $this->user_comment
        );

        # import/interwiki
        $msg = $this->context->msg( 'import-logentry-interwiki', 'SomeTitle' )->plain() .
            $sep .
            $this->user_comment;
        $this->assertIRCComment(
            $msg,
            'import', 'interwiki',
            [],
            $this->user_comment
        );
    }

    protected function assertIRCComment( $expected, $type, $action, $params,
        $comment = null, $msg = '', $legacy = false
    ) {
        $logEntry = new ManualLogEntry( $type, $action );
        $logEntry->setPerformer( $this->user );
        $logEntry->setTarget( $this->title );
        if ( $comment !== null ) {
            $logEntry->setComment( $comment );
        }
        $logEntry->setParameters( $params );
        $logEntry->setLegacy( $legacy );

        $formatter = LogFormatter::newFromEntry( $logEntry );
        $formatter->setContext( $this->context );

        // Apply the same transformation as done in IRCColourfulRCFeedFormatter::getLine for rc_comment
        $ircRcComment = IRCColourfulRCFeedFormatter::cleanupForIRC( $formatter->getIRCActionComment() );

        $this->assertEquals(
            $expected,
            $ircRcComment,
            $msg
        );
    }

}