]>
Commit | Line | Data |
---|---|---|
e2b30093 | 1 | # Erebus IRC bot - Author: Erebus Team |
4477123d | 2 | # vim: fileencoding=utf-8 |
4df64299 | 3 | # Various highly recommended "control" commands. |
e2b30093 | 4 | # This file is released into the public domain; see http://unlicense.org/ |
5 | ||
6 | # module info | |
7 | modinfo = { | |
8 | 'author': 'Erebus Team', | |
9 | 'license': 'public domain', | |
fa93b933 | 10 | 'compatible': [0], |
e2b30093 | 11 | 'depends': [], |
a62d0d18 | 12 | 'softdeps': ['help'], |
e2b30093 | 13 | } |
14 | ||
15 | # preamble | |
16 | import modlib | |
17 | lib = modlib.modlib(__name__) | |
18 | modstart = lib.modstart | |
19 | modstop = lib.modstop | |
20 | ||
21 | # module code | |
d371d194 | 22 | import sys, os |
e2b30093 | 23 | import ctlmod |
32a54ded | 24 | from collections import deque |
e2b30093 | 25 | |
26 | ||
f7725bee | 27 | @lib.hook(('die','restart'), needchan=False, glevel=lib.MANAGER) |
5f03d045 | 28 | @lib.help(None, "stops the bot") |
fb20be7c | 29 | def die(bot, user, chan, realtarget, *args): |
889eeb24 | 30 | quitmsg = ' '.join(args) |
a28e2ae9 | 31 | for botitem in bot.parent.bots.values(): |
889eeb24 | 32 | bot.conn.send("QUIT :Restarting. %s" % (quitmsg)) |
e2b30093 | 33 | sys.exit(0) |
4df64299 | 34 | |
fb20be7c | 35 | @lib.hook(needchan=False, glevel=lib.MANAGER) |
de66fe6d JR |
36 | @lib.help("[-autoload] <mod>", "loads a module, optionally marking it for autoloading") |
37 | @lib.argsGE(1) | |
fb20be7c | 38 | def modload(bot, user, chan, realtarget, *args): |
de66fe6d JR |
39 | module = None |
40 | autoload = False | |
41 | for arg in args: | |
42 | if arg[0] != "-": | |
43 | if module is not None: | |
44 | bot.msg(user, "Wrong number of arguments.") | |
45 | return | |
46 | module = arg | |
47 | elif arg == "-autoload": | |
48 | autoload = True | |
49 | else: | |
50 | bot.msg(user, "Bad option %s" % (arg)) | |
51 | ||
52 | if autoload: | |
53 | bot.parent.cfg.set('autoloads', module, 1) | |
54 | bot.msg(user, "Marked %s for autoloading." % (module)) | |
55 | okay = ctlmod.load(bot.parent, module) | |
4df64299 | 56 | if okay: |
de66fe6d | 57 | bot.msg(user, "Loaded %s" % (module)) |
4df64299 | 58 | else: |
de66fe6d | 59 | bot.msg(user, "Error loading %s: %r" % (module, okay)) |
4df64299 | 60 | |
fb20be7c | 61 | @lib.hook(needchan=False, glevel=lib.MANAGER) |
de66fe6d | 62 | @lib.help("[-force] [-autoload] <mod>", "unloads a module", "will refuse to unload a module which is depended on by others unless you specify FORCE.", "optionally removes from autoloads") |
b0910717 | 63 | @lib.argsGE(1) |
fb20be7c | 64 | def modunload(bot, user, chan, realtarget, *args): |
de66fe6d JR |
65 | module = None |
66 | autoload = False | |
67 | force = False | |
68 | for arg in args: | |
69 | if arg[0] != "-": | |
70 | if module is not None: | |
71 | bot.msg(user, "Wrong number of arguments.") | |
72 | return | |
73 | module = arg | |
74 | elif arg == "-autoload": | |
75 | autoload = True | |
76 | elif arg == "-force": | |
77 | force = True | |
78 | else: | |
79 | bot.msg(user, "Bad option %s" % (arg)) | |
80 | ||
81 | if autoload: | |
82 | bot.parent.cfg.delete('autoloads', module) | |
83 | bot.msg(user, "Unmarked %s for autoloading." % (module)) | |
84 | if not ctlmod.isloaded(module): | |
85 | bot.msg(user, "%s is not loaded" % (module)) | |
68dff4aa | 86 | return |
de66fe6d JR |
87 | if len(ctlmod.dependents[module]) > 0: |
88 | if not force: | |
89 | bot.msg(user, "That module has dependents! Say MODUNLOAD %s FORCE to unload it and any dependents." % (module)) | |
b0910717 | 90 | return |
68dff4aa | 91 | |
de66fe6d | 92 | okay = ctlmod.unload(bot.parent, module) |
4df64299 | 93 | if okay: |
de66fe6d | 94 | bot.msg(user, "Unloaded %s" % (module)) |
4df64299 | 95 | else: |
de66fe6d | 96 | bot.msg(user, "Error unloading %s: %r" % (module, okay)) |
4df64299 | 97 | |
fb20be7c | 98 | @lib.hook(needchan=False, glevel=lib.MANAGER) |
5f03d045 | 99 | @lib.help("<mod>", "reloads a module") |
4df64299 | 100 | @lib.argsEQ(1) |
fb20be7c | 101 | def modreload(bot, user, chan, realtarget, *args): |
68dff4aa JR |
102 | if not ctlmod.isloaded(args[0]): |
103 | bot.msg(user, "%s is not loaded" % (args[0])) | |
104 | return | |
105 | ||
4df64299 | 106 | okay = ctlmod.reloadmod(bot.parent, args[0]) |
107 | if okay: | |
108 | bot.msg(user, "Reloaded %s" % (args[0])) | |
109 | else: | |
110 | bot.msg(user, "Error occurred: %r" % (okay)) | |
111 | ||
fb20be7c | 112 | @lib.hook(needchan=False, glevel=lib.STAFF) |
5f03d045 | 113 | @lib.help(None, "list loaded modules") |
4df64299 | 114 | @lib.argsEQ(0) |
fb20be7c | 115 | def modlist(bot, user, chan, realtarget, *args): |
4df64299 | 116 | mods = ctlmod.modules |
958b8081 | 117 | for modname, mod in sorted(mods.items()): |
53fff692 | 118 | bot.msg(user, "- %s (%s) [%s]" % ((modname, mod.__file__, ', '.join(ctlmod.dependents[modname])))) |
4df64299 | 119 | bot.msg(user, "Done.") |
fb20be7c | 120 | |
72e5bb4e | 121 | def _whois(user, chan, showglevel=True, showclevel=True): |
fb20be7c | 122 | if not user.isauthed(): |
72e5bb4e | 123 | return "not authed." |
fb20be7c | 124 | |
125 | fillers = {'auth': user.auth} | |
72e5bb4e | 126 | fmt = "%(auth)s" |
fb20be7c | 127 | |
72e5bb4e | 128 | if showglevel and user.glevel >= 1: |
44aea37b JR |
129 | fillers['glevel'] = user.glevel |
130 | fmt += " (global access: %(glevel)s)" | |
72e5bb4e | 131 | elif user.glevel >= 1: |
132 | fmt += " (staff)" | |
44aea37b JR |
133 | elif user.glevel <= -2: |
134 | fmt += " (ignored)" | |
fb20be7c | 135 | else: |
136 | fmt += " (not staff)" | |
137 | ||
905f5930 | 138 | if (showclevel or showglevel) and chan is not None: |
68dff4aa JR |
139 | clev = chan.levelof(user.auth) |
140 | if clev >= 1: | |
141 | fillers['clevel'] = (lib.clevs[clev] if clev < len(lib.clevs) else clev) | |
72e5bb4e | 142 | fmt += " (channel access: %(clevel)s)" |
143 | else: | |
144 | fmt += " (not a channel user)" | |
145 | return fmt % fillers | |
146 | ||
827ec8f0 | 147 | @lib.hook(needchan=False, wantchan=True) |
b4e3e62e | 148 | @lib.help("<user|#auth>", "shows who someone is") |
72e5bb4e | 149 | @lib.argsEQ(1) |
150 | def whois(bot, user, chan, realtarget, *args): | |
3fb492b9 | 151 | name = args[0] |
152 | if name.startswith("#"): | |
153 | target = bot.parent.User(name, name[1:]) | |
154 | else: | |
155 | target = bot.parent.user(name, create=False) | |
72e5bb4e | 156 | if target is None: |
a5e7905a | 157 | return "I don't know %s." % (args[0]) |
fb20be7c | 158 | else: |
a5e7905a | 159 | return "%s is %s" % (args[0], _whois(target, chan, (user.glevel >= 1), (chan is not None and chan.levelof(user.auth) >= 1))) |
72e5bb4e | 160 | |
363febf1 | 161 | @lib.hook(needchan=False, wantchan=True) |
5f03d045 | 162 | @lib.help(None, "shows who you are") |
72e5bb4e | 163 | def whoami(bot, user, chan, realtarget, *args): |
a5e7905a | 164 | return "You are %s" % (_whois(user, chan)) |
32a54ded | 165 | |
b319b837 | 166 | @lib.hook(needchan=False) |
167 | @lib.help(None, "tries to read your auth and access level again") | |
168 | def auth(bot, user, chan, realtarget, *args): | |
169 | bot.msg(user, "Okay, give me a second.") | |
170 | bot.conn.send("WHO %s n%%ant,2" % (user)) | |
171 | ||
32a54ded | 172 | @lib.hook(needchan=False, glevel=1) |
5f03d045 | 173 | @lib.help(None, "displays length of each msgqueue") |
32a54ded | 174 | def qstat(bot, user, chan, realtarget, *args): |
175 | bot.fastmsg(user, "Regular: %d -- Slow: %d" % (len(bot.msgqueue), len(bot.slowmsgqueue))) | |
176 | ||
74feb80e | 177 | @lib.hook(('qclear','cq','clearq','clearqueue'), needchan=False, glevel=lib.ADMIN) |
e6b60193 | 178 | @lib.help("[regular|slow]", "clears both or a specific msgqueue") |
32a54ded | 179 | def qclear(bot, user, chan, realtarget, *args): |
180 | if len(args) == 0: | |
181 | bot.msgqueue = deque() | |
182 | bot.slowmsgqueue = deque() | |
183 | bot.fastmsg(user, "Cleared both msgqueues.") | |
184 | else: | |
185 | if args[0] == 'regular': | |
186 | bot.msgqueue = deque() | |
187 | elif args[0] == 'slow': | |
188 | bot.slowmsgqueue = deque() | |
189 | else: | |
190 | bot.fastmsg(user, "Syntax: QCLEAR [regular|slow]") | |
191 | return #short-circuit | |
192 | bot.fastmsg(user, "Cleared that msgqueue.") |