[commands] Add __global_check_once to list of cog functions.

discord/__main__.py

@@ -119,6 +119,10 @@ cog_extras = '''
         # checks that apply to every command to the bot
         return True
 
+    async def __global_check_once(self, ctx):
+        # check that apply to every command but is guaranteed to be called only once
+        return True
+
     async def __error(self, ctx, error):
         # error handling to every command in here
         pass

docs/migrating.rst

@@ -937,6 +937,10 @@ An example cog with every special method registered is as follows: ::
             print('cog global check')
             return True
 
+        def __global_check_once(self, ctx):
+            print('cog global check once')
+            return True
+
         async def __local_check(self, ctx):
             print('cog local check')
             return await ctx.bot.is_owner(ctx.author)