Add AvailableRightsTest for User::getAllRights completeness
authorMarius Hoch <hoo@online.de>
Mon, 9 Feb 2015 22:50:35 +0000 (23:50 +0100)
committerMarius Hoch <hoo@online.de>
Tue, 10 Feb 2015 12:12:11 +0000 (13:12 +0100)
Because extensions often don't add their rights to $wgAvailableRights
or via the 'UserGetAllRights' hook, thus User::getAllRights is incomplete.

Change-Id: Id9ae9eff71e822ec5c038c1c1f990ac36f05cea8

includes/User.php
tests/phpunit/structure/AvailableRightsTest.php [new file with mode: 0644]

index c2db67a..961c510 100644 (file)
@@ -4399,7 +4399,7 @@ class User implements IDBAccessObject {
 
        /**
         * Get a list of all available permissions.
-        * @return array Array of permission names
+        * @return string[] Array of permission names
         */
        public static function getAllRights() {
                if ( self::$mAllRights === false ) {
diff --git a/tests/phpunit/structure/AvailableRightsTest.php b/tests/phpunit/structure/AvailableRightsTest.php
new file mode 100644 (file)
index 0000000..9737e82
--- /dev/null
@@ -0,0 +1,45 @@
+<?php
+
+/**
+ * Try to make sure that extensions register all rights in $wgAvailableRights
+ * or via the 'UserGetAllRights' hook.
+ *
+ * @author Marius Hoch < hoo@online.de >
+ */
+class AvailableRightsTest extends PHPUnit_Framework_TestCase {
+
+       /**
+        * Returns all rights that should be in $wgAvailableRights + all rights
+        * registered via the 'UserGetAllRights' hook + all "core" rights.
+        *
+        * @return string[]
+        */
+       private function getAllVisibleRights() {
+               global $wgGroupPermissions, $wgRevokePermissions;
+
+               $rights = User::getAllRights();
+
+               foreach( $wgGroupPermissions as $permissions ) {
+                       $rights = array_merge( $rights, array_keys( $permissions ) );
+               }
+
+               foreach( $wgRevokePermissions as $permissions ) {
+                       $rights = array_merge( $rights, array_keys( $permissions ) );
+               }
+
+               $rights = array_unique( $rights );
+               sort( $rights );
+
+               return $rights;
+       }
+
+       public function testAvailableRights() {
+               $missingRights = array_diff( $this->getAllVisibleRights(), User::getAllRights() );
+
+               $this->assertEquals(
+                       array(),
+                       array_values( $missingRights ), // Re-Index to produce nicer output, keys are meaningless
+                       'Additional user rights need to be added to $wgAvailableRights or via the "UserGetAllRights" hook'
+               );
+       }
+}