modinfo = {
'author': 'Erebus Team',
'license': 'public domain',
- 'compatible': [1],
+ 'compatible': [2],
'depends': [],
+ 'softdeps': ['help'],
}
# preamble
modstop = lib.modstop
# module code
-import sys
+import sys, os
import ctlmod
+from collections import deque
-@lib.hook('die', needchan=False, glevel=lib.MANAGER)
-def cmd_die(bot, user, chan, realtarget, *args):
+@lib.hook(('die','restart'), needchan=False, glevel=lib.MANAGER)
+@lib.help(None, "stops the bot")
+def die(bot, user, chan, realtarget, *args):
+ for botitem in bot.parent.bots.itervalues():
+ for chan in botitem.chans:
+ chan.fastmsg("Bot is restarting! %s" % ' '.join(args))
+ bot.conn.send("QUIT :Restarting.")
sys.exit(0)
os._exit(0)
-@lib.hook('modload', needchan=False, glevel=lib.MANAGER)
+@lib.hook(needchan=False, glevel=lib.MANAGER)
+@lib.help("<mod>", "loads a module")
@lib.argsEQ(1)
-def cmd_modload(bot, user, chan, realtarget, *args):
+def modload(bot, user, chan, realtarget, *args):
okay = ctlmod.load(bot.parent, args[0])
if okay:
bot.msg(user, "Loaded %s" % (args[0]))
else:
bot.msg(user, "Error loading %s: %r" % (args[0], okay))
-@lib.hook('modunload', needchan=False, glevel=lib.MANAGER)
-@lib.argsEQ(1)
-def cmd_modunload(bot, user, chan, realtarget, *args):
+@lib.hook(needchan=False, glevel=lib.MANAGER)
+@lib.help("<mod> [FORCE]", "unloads a module", "will refuse to unload a module which is depended on by others", "unless you specify FORCE.")
+@lib.argsGE(1)
+def modunload(bot, user, chan, realtarget, *args):
+ if len(ctlmod.dependents[args[0]]) > 0:
+ if len(args) == 1 or args[1].lower() != "force":
+ bot.msg(user, "That module has dependents! Say MODUNLOAD %s FORCE to unload it and any dependents." % (args[0]))
+ return
okay = ctlmod.unload(bot.parent, args[0])
if okay:
bot.msg(user, "Unloaded %s" % (args[0]))
else:
bot.msg(user, "Error unloading %s: %r" % (args[0], okay))
-@lib.hook('modreload', needchan=False, glevel=lib.MANAGER)
+@lib.hook(needchan=False, glevel=lib.MANAGER)
+@lib.help("<mod>", "reloads a module")
@lib.argsEQ(1)
-def cmd_modreload(bot, user, chan, realtarget, *args):
+def modreload(bot, user, chan, realtarget, *args):
okay = ctlmod.reloadmod(bot.parent, args[0])
if okay:
bot.msg(user, "Reloaded %s" % (args[0]))
else:
bot.msg(user, "Error occurred: %r" % (okay))
-@lib.hook('modlist', needchan=False, glevel=lib.STAFF)
+@lib.hook(needchan=False, glevel=lib.STAFF)
+@lib.help(None, "list loaded modules")
@lib.argsEQ(0)
-def cmd_modlist(bot, user, chan, realtarget, *args):
+def modlist(bot, user, chan, realtarget, *args):
mods = ctlmod.modules
- for mod in mods.itervalues():
- bot.msg(user, "- %s %r" % (mod.__name__, mod))
+ for modname, mod in mods.iteritems():
+ bot.msg(user, "- %s (%s) [%s]" % ((modname, mod.__file__, ', '.join(ctlmod.dependents[modname]))))
bot.msg(user, "Done.")
+
+def _whois(user, chan, showglevel=True, showclevel=True):
+ if not user.isauthed():
+ return "not authed."
+
+ fillers = {'auth': user.auth}
+ fmt = "%(auth)s"
+
+ if showglevel and user.glevel >= 1:
+ fillers['glevel'] = user.glevel
+ fmt += " (global access: %(glevel)s)"
+ elif user.glevel >= 1:
+ fmt += " (staff)"
+ else:
+ fmt += " (not staff)"
+
+ if showclevel and chan is not None:
+ if chan.levelof(user.auth) >= 1:
+ fillers['clevel'] = chan.levelof(user.auth)
+ fmt += " (channel access: %(clevel)s)"
+ else:
+ fmt += " (not a channel user)"
+ return fmt % fillers
+
+@lib.hook(needchan=False, wantchan=True)
+@lib.help("<user|#auth>", "shows who someone is")
+@lib.argsEQ(1)
+def whois(bot, user, chan, realtarget, *args):
+ name = args[0]
+ if name.startswith("#"):
+ target = bot.parent.User(name, name[1:])
+ else:
+ target = bot.parent.user(name, create=False)
+ if target is None:
+ bot.msg(user, "I don't know %s." % (args[0]))
+ else:
+ bot.msg(user, "%s is %s" % (args[0], _whois(target, chan, (user.glevel >= 1), (chan is not None and chan.levelof(user.auth) >= 1))))
+
+@lib.hook(needchan=False, wantchan=True)
+@lib.help(None, "shows who you are")
+def whoami(bot, user, chan, realtarget, *args):
+ bot.msg(user, "You are %s" % (_whois(user, chan)))
+
+@lib.hook(needchan=False)
+@lib.help(None, "tries to read your auth and access level again")
+def auth(bot, user, chan, realtarget, *args):
+ bot.msg(user, "Okay, give me a second.")
+ bot.conn.send("WHO %s n%%ant,2" % (user))
+
+@lib.hook(needchan=False, glevel=1)
+@lib.help(None, "displays length of each msgqueue")
+def qstat(bot, user, chan, realtarget, *args):
+ bot.fastmsg(user, "Regular: %d -- Slow: %d" % (len(bot.msgqueue), len(bot.slowmsgqueue)))
+
+@lib.hook(needchan=False, glevel=lib.ADMIN)
+@lib.help(('qclear','clearq','clearqueue'), "[regular|slow]", "clears both or a specific msgqueue")
+def qclear(bot, user, chan, realtarget, *args):
+ if len(args) == 0:
+ bot.msgqueue = deque()
+ bot.slowmsgqueue = deque()
+ bot.fastmsg(user, "Cleared both msgqueues.")
+ else:
+ if args[0] == 'regular':
+ bot.msgqueue = deque()
+ elif args[0] == 'slow':
+ bot.slowmsgqueue = deque()
+ else:
+ bot.fastmsg(user, "Syntax: QCLEAR [regular|slow]")
+ return #short-circuit
+ bot.fastmsg(user, "Cleared that msgqueue.")