LogFormatterTest.php

Go to the documentation of this file.

<?php
 
class LogFormatterTest extends MediaWikiLangTestCase {
    private static $oldExtMsgFiles;
 
    protected $user;
 
    protected $title;
 
    protected $context;
 
    protected $target;
 
    protected $user_comment;
 
    public static function setUpBeforeClass() {
        parent::setUpBeforeClass();
 
        global $wgExtensionMessagesFiles;
        self::$oldExtMsgFiles = $wgExtensionMessagesFiles;
        $wgExtensionMessagesFiles['LogTests'] = __DIR__ . '/LogTests.i18n.php';
        Language::getLocalisationCache()->recache( 'en' );
    }
 
    public static function tearDownAfterClass() {
        global $wgExtensionMessagesFiles;
        $wgExtensionMessagesFiles = self::$oldExtMsgFiles;
        Language::getLocalisationCache()->recache( 'en' );
 
        parent::tearDownAfterClass();
    }
 
    protected function setUp() {
        parent::setUp();
 
        $this->setMwGlobals( [
            'wgLogTypes' => [ 'phpunit' ],
            'wgLogActionsHandlers' => [ 'phpunit/test' => LogFormatter::class,
                'phpunit/param' => LogFormatter::class ],
            'wgUser' => User::newFromName( 'Testuser' ),
        ] );
 
        $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( RequestContext::getMain()->getLanguage() );
 
        $this->user_comment = '<User comment about action>';
    }
 
    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();
 
        $formatter2 = LogFormatter::newFromEntry( $entry );
        $formatter2->setContext( $this->context );
        $formatter2->setShowUserToolLinks( true );
        $paramsWithTools = $formatter2->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:title-link:key', '<invalid>', [
                'key_ns' => NS_SPECIAL,
                'key_title' => SpecialPage::getTitleFor( 'Badtitle', '<invalid>' )->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
        );
    }
 
}