Merge "Change .tocnumber to use grey text for section numbers in Table of Contents...
[lhc/web/wiklou.git] / tests / phpunit / includes / logging / LogFormatterTest.php
index 515990e..a21a3ff 100644 (file)
@@ -1,4 +1,5 @@
 <?php
+
 /**
  * @group Database
  */
@@ -19,28 +20,41 @@ class LogFormatterTest extends MediaWikiLangTestCase {
         */
        protected $context;
 
+       /**
+        * @var Title
+        */
+       protected $target;
+
+       /**
+        * @var string
+        */
+       protected $user_comment;
+
        protected function setUp() {
                parent::setUp();
 
                global $wgLang;
 
-               $this->setMwGlobals( array(
-                       'wgLogTypes' => array( 'phpunit' ),
-                       'wgLogActionsHandlers' => array( 'phpunit/test' => 'LogFormatter',
-                               'phpunit/param' => 'LogFormatter' ),
+               $this->setMwGlobals( [
+                       'wgLogTypes' => [ 'phpunit' ],
+                       'wgLogActionsHandlers' => [ 'phpunit/test' => 'LogFormatter',
+                               'phpunit/param' => 'LogFormatter' ],
                        'wgUser' => User::newFromName( 'Testuser' ),
-                       'wgExtensionMessagesFiles' => array( 'LogTests' => __DIR__ . '/LogTests.i18n.php' ),
-               ) );
+                       'wgExtensionMessagesFiles' => [ 'LogTests' => __DIR__ . '/LogTests.i18n.php' ],
+               ] );
 
                Language::getLocalisationCache()->recache( $wgLang->getCode() );
 
                $this->user = User::newFromName( 'Testuser' );
-               $this->title = Title::newMainPage();
+               $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() {
@@ -65,7 +79,7 @@ class LogFormatterTest extends MediaWikiLangTestCase {
         * @covers LogFormatter::newFromEntry
         */
        public function testNormalLogParams() {
-               $entry = $this->newLogEntry( 'test', array() );
+               $entry = $this->newLogEntry( 'test', [] );
                $formatter = LogFormatter::newFromEntry( $entry );
                $formatter->setContext( $this->context );
 
@@ -87,7 +101,7 @@ class LogFormatterTest extends MediaWikiLangTestCase {
                        $this->user->getEditCount()
                );
 
-               $titleLink = Linker::link( $this->title, null, array(), array() );
+               $titleLink = Linker::link( $this->title, null, [], [] );
 
                // $paramsWithoutTools and $paramsWithTools should be only different
                // in index 0
@@ -107,8 +121,8 @@ class LogFormatterTest extends MediaWikiLangTestCase {
         * @covers LogFormatter::getActionText
         */
        public function testLogParamsTypeRaw() {
-               $params = array( '4:raw:raw' => Linker::link( $this->title, null, array(), array() ) );
-               $expected = Linker::link( $this->title, null, array(), array() );
+               $params = [ '4:raw:raw' => Linker::link( $this->title, null, [], [] ) ];
+               $expected = Linker::link( $this->title, null, [], [] );
 
                $entry = $this->newLogEntry( 'param', $params );
                $formatter = LogFormatter::newFromEntry( $entry );
@@ -124,7 +138,7 @@ class LogFormatterTest extends MediaWikiLangTestCase {
         * @covers LogFormatter::getActionText
         */
        public function testLogParamsTypeMsg() {
-               $params = array( '4:msg:msg' => 'log-description-phpunit' );
+               $params = [ '4:msg:msg' => 'log-description-phpunit' ];
                $expected = wfMessage( 'log-description-phpunit' )->text();
 
                $entry = $this->newLogEntry( 'param', $params );
@@ -141,7 +155,7 @@ class LogFormatterTest extends MediaWikiLangTestCase {
         * @covers LogFormatter::getActionText
         */
        public function testLogParamsTypeMsgContent() {
-               $params = array( '4:msg-content:msgContent' => 'log-description-phpunit' );
+               $params = [ '4:msg-content:msgContent' => 'log-description-phpunit' ];
                $expected = wfMessage( 'log-description-phpunit' )->inContentLanguage()->text();
 
                $entry = $this->newLogEntry( 'param', $params );
@@ -160,7 +174,7 @@ class LogFormatterTest extends MediaWikiLangTestCase {
        public function testLogParamsTypeNumber() {
                global $wgLang;
 
-               $params = array( '4:number:number' => 123456789 );
+               $params = [ '4:number:number' => 123456789 ];
                $expected = $wgLang->formatNum( 123456789 );
 
                $entry = $this->newLogEntry( 'param', $params );
@@ -177,7 +191,7 @@ class LogFormatterTest extends MediaWikiLangTestCase {
         * @covers LogFormatter::getActionText
         */
        public function testLogParamsTypeUserLink() {
-               $params = array( '4:user-link:userLink' => $this->user->getName() );
+               $params = [ '4:user-link:userLink' => $this->user->getName() ];
                $expected = Linker::userLink(
                        $this->user->getId(),
                        $this->user->getName()
@@ -197,8 +211,8 @@ class LogFormatterTest extends MediaWikiLangTestCase {
         * @covers LogFormatter::getActionText
         */
        public function testLogParamsTypeTitleLink() {
-               $params = array( '4:title-link:titleLink' => $this->title->getText() );
-               $expected = Linker::link( $this->title, null, array(), array() );
+               $params = [ '4:title-link:titleLink' => $this->title->getText() ];
+               $expected = Linker::link( $this->title, null, [], [] );
 
                $entry = $this->newLogEntry( 'param', $params );
                $formatter = LogFormatter::newFromEntry( $entry );
@@ -214,7 +228,7 @@ class LogFormatterTest extends MediaWikiLangTestCase {
         * @covers LogFormatter::getActionText
         */
        public function testLogParamsTypePlain() {
-               $params = array( '4:plain:plain' => 'Some plain text' );
+               $params = [ '4:plain:plain' => 'Some plain text' ];
                $expected = 'Some plain text';
 
                $entry = $this->newLogEntry( 'param', $params );
@@ -231,7 +245,7 @@ class LogFormatterTest extends MediaWikiLangTestCase {
         * @covers LogFormatter::getComment
         */
        public function testLogComment() {
-               $entry = $this->newLogEntry( 'test', array() );
+               $entry = $this->newLogEntry( 'test', [] );
                $formatter = LogFormatter::newFromEntry( $entry );
                $formatter->setContext( $this->context );
 
@@ -246,7 +260,7 @@ class LogFormatterTest extends MediaWikiLangTestCase {
         * @covers LogFormatter::formatParameterValueForApi
         */
        public function testApiParamFormatting( $key, $value, $expected ) {
-               $entry = $this->newLogEntry( 'param', array( $key => $value ) );
+               $entry = $this->newLogEntry( 'param', [ $key => $value ] );
                $formatter = LogFormatter::newFromEntry( $entry );
                $formatter->setContext( $this->context );
 
@@ -257,39 +271,384 @@ class LogFormatterTest extends MediaWikiLangTestCase {
        }
 
        public static function provideApiParamFormatting() {
-               return array(
-                       array( 0, 'value', array( 'value' ) ),
-                       array( 'named', 'value', array( 'named' => 'value' ) ),
-                       array( '::key', 'value', array( 'key' => 'value' ) ),
-                       array( '4::key', 'value', array( 'key' => 'value' ) ),
-                       array( '4:raw:key', 'value', array( 'key' => 'value' ) ),
-                       array( '4:plain:key', 'value', array( 'key' => 'value' ) ),
-                       array( '4:bool:key', '1', array( 'key' => true ) ),
-                       array( '4:bool:key', '0', array( 'key' => false ) ),
-                       array( '4:number:key', '123', array( 'key' => 123 ) ),
-                       array( '4:number:key', '123.5', array( 'key' => 123.5 ) ),
-                       array( '4:array:key', array(), array( 'key' => array( ApiResult::META_TYPE => 'array' ) ) ),
-                       array( '4:assoc:key', array(), array( 'key' => array( ApiResult::META_TYPE => 'assoc' ) ) ),
-                       array( '4:kvp:key', array(), array( 'key' => array( ApiResult::META_TYPE => 'kvp' ) ) ),
-                       array( '4:timestamp:key', '20150102030405', array( 'key' => '2015-01-02T03:04:05Z' ) ),
-                       array( '4:msg:key', 'parentheses', array(
+               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(),
-                       ) ),
-                       array( '4:msg-content:key', 'parentheses', array(
+                       ] ],
+                       [ '4:msg-content:key', 'parentheses', [
                                'key_key' => 'parentheses',
                                'key_text' => wfMessage( 'parentheses' )->inContentLanguage()->text(),
-                       ) ),
-                       array( '4:title:key', 'project:foo', array(
+                       ] ],
+                       [ '4:title:key', 'project:foo', [
                                'key_ns' => NS_PROJECT,
                                'key_title' => Title::newFromText( 'project:foo' )->getFullText(),
-                       ) ),
-                       array( '4:title-link:key', 'project:foo', array(
+                       ] ],
+                       [ '4:title-link:key', 'project:foo', [
                                'key_ns' => NS_PROJECT,
                                'key_title' => Title::newFromText( 'project:foo' )->getFullText(),
-                       ) ),
-                       array( '4:user:key', 'foo', array( 'key' => 'Foo' ) ),
-                       array( '4:user-link:key', 'foo', array( 'key' => 'Foo' ) ),
+                       ] ],
+                       [ '4:user:key', 'foo', [ 'key' => 'Foo' ] ],
+                       [ '4:user-link:key', 'foo', [ 'key' => 'Foo' ] ],
+               ];
+       }
+
+       /**
+        * The testIrcMsgForAction* tests are supposed to cover the hacky
+        * LogFormatter::getIRCActionText / bug 34508
+        *
+        * Third parties bots listen to those messages. They are clever enough
+        * to fetch the i18n messages from the wiki and then analyze the IRC feed
+        * to reverse engineer the $1, $2 messages.
+        * One thing bots can not detect is when MediaWiki change the meaning of
+        * a message like what happened when we deployed 1.19. $1 became the user
+        * performing the action which broke basically all bots around.
+        *
+        * Should cover the following log actions (which are most commonly used by bots):
+        * - block/block
+        * - block/unblock
+        * - block/reblock
+        * - delete/delete
+        * - delete/restore
+        * - newusers/create
+        * - newusers/create2
+        * - newusers/autocreate
+        * - move/move
+        * - move/move_redir
+        * - protect/protect
+        * - protect/modifyprotect
+        * - protect/unprotect
+        * - protect/move_prot
+        * - upload/upload
+        * - merge/merge
+        * - import/upload
+        * - import/interwiki
+        *
+        * As well as the following Auto Edit Summaries:
+        * - blank
+        * - replace
+        * - rollback
+        * - undo
+        */
+
+       /**
+        * @covers LogFormatter::getIRCActionComment
+        * @covers LogFormatter::getIRCActionText
+        */
+       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
                );
        }
+
+       /**
+        * @covers LogFormatter::getIRCActionComment
+        * @covers LogFormatter::getIRCActionText
+        */
+       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
+               );
+       }
+
+       /**
+        * @covers LogFormatter::getIRCActionComment
+        * @covers LogFormatter::getIRCActionText
+        */
+       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',
+                       []
+               );
+       }
+
+       /**
+        * @covers LogFormatter::getIRCActionComment
+        * @covers LogFormatter::getIRCActionText
+        */
+       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
+               );
+       }
+
+       /**
+        * @covers LogFormatter::getIRCActionComment
+        * @covers LogFormatter::getIRCActionText
+        */
+       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,
+                       ]
+               );
+       }
+
+       /**
+        * @covers LogFormatter::getIRCActionComment
+        * @covers LogFormatter::getIRCActionText
+        */
+       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
+               );
+       }
+
+       /**
+        * @covers LogFormatter::getIRCActionComment
+        * @covers LogFormatter::getIRCActionText
+        */
+       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
+               );
+       }
+
+       /**
+        * @covers LogFormatter::getIRCActionComment
+        * @covers LogFormatter::getIRCActionText
+        */
+       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
+               );
+       }
+
+       /**
+        * @covers LogFormatter::getIRCActionComment
+        * @covers LogFormatter::getIRCActionText
+        */
+       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
+               );
+       }
+
+       /**
+        * @param string $expected Expected IRC text without colors codes
+        * @param string $type Log type (move, delete, suppress, patrol ...)
+        * @param string $action A log type action
+        * @param array $params
+        * @param string $comment (optional) A comment for the log action
+        * @param string $msg (optional) A message for PHPUnit :-)
+        */
+       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
+               );
+       }
+
 }