corecommands: add a 'clearqueue' command to force clear queue muckups (#441)

coremods/corecommands.py

@@ -201,3 +201,11 @@ def rehash(irc, source, args):
         return
     else:
         irc.reply("Done.")
+
+@utils.add_cmd
+def clearqueue(irc, source, args):
+    """takes no arguments.
+
+    Clears the outgoing text queue for the current connection."""
+    permissions.checkPermissions(irc, source, ['core.clearqueue'])
+    irc.queue.clear()

docs/permissions-reference.md

@@ -3,6 +3,7 @@
 Below is a list of all the permissions defined by PyLink and its official plugins. For instructions on how to fine-tune permissions, see [example-permissions.yml](../example-permissions.yml).
 
 ## PyLink Core
+- `core.clearqueue` - Allows access to the `clearqueue` command.
 - `core.shutdown` - Allows access to the `shutdown` command.
 - `core.load` - Allows access to the `load` command.
 - `core.unload` - Allows access to the `unload` command.