]>
Commit | Line | Data |
---|---|---|
0f8352dd | 1 | # Erebus IRC bot - Author: Erebus Team |
2 | # help module | |
3 | # This file is released into the public domain; see http://unlicense.org/ | |
4 | ||
5 | # module info | |
6 | modinfo = { | |
7 | 'author': 'Erebus Team', | |
8 | 'license': 'public domain', | |
9 | 'compatible': [1], # compatible module API versions | |
10 | 'depends': [], # other modules required to work properly? | |
11 | } | |
12 | ||
13 | # preamble | |
14 | import modlib | |
15 | lib = modlib.modlib(__name__) | |
16 | modstart = lib.modstart | |
17 | modstop = lib.modstop | |
18 | ||
19 | # module code | |
20 | helps = {} | |
21 | cmds = {} | |
22 | ||
23 | # ! this is part of this module's API, called from modlib.help() | |
24 | # this function only handles the command name and aliases - the rest is passed directly to _reghelp() | |
25 | def reghelp(func, *args, **kwargs): | |
26 | syntax = None | |
27 | shorthelp = None | |
28 | longhelps = [] | |
29 | ||
30 | if len(args) > 0: | |
31 | syntax = args[0] | |
32 | if len(args) > 1: | |
33 | shorthelp = args[1] | |
34 | if len(args) > 2: | |
35 | longhelps = args[2:] | |
36 | ||
37 | if 'syntax' in kwargs: | |
38 | syntax = kwargs['syntax'] | |
39 | if 'shorthelp' in kwargs: | |
40 | shorthelp = kwargs['shorthelp'] | |
41 | if 'longhelps' in kwargs: | |
42 | longhelps = kwargs['longhelps'] | |
43 | ||
44 | if syntax is None: syntax = "" | |
45 | if shorthelp is None: shorthelp = "" | |
46 | ||
47 | func.syntax = syntax | |
48 | func.shorthelp = shorthelp | |
49 | func.longhelps = longhelps | |
50 | helps[func] = func | |
51 | for c in func.cmd: | |
52 | cmds[c] = func | |
53 | ||
54 | def dereghelp(func, *args, **kwargs): | |
55 | for c in func.cmd: | |
56 | del cmds[cmd] | |
57 | del helps[func] | |
58 | ||
59 | @lib.hook(needchan=False) | |
60 | @lib.help('[<command>]', 'lists commands or describes a command') | |
5f03d045 | 61 | def help(bot, user, chan, realtarget, *args): #TODO add ordering - by access level, then alphabetic? |
62 | if len(args) == 0: # list commands | |
0f8352dd | 63 | for func in helps.itervalues(): |
64 | if user.glevel >= func.reqglevel: | |
65 | if func.reqglevel <= 0: | |
66 | bot.slowmsg(user, "%-40s - %-50s" % (func.cmd[0]+' '+func.syntax, func.shorthelp)) | |
67 | else: | |
68 | bot.slowmsg(user, "%-40s - %-50s (%5s)" % (func.cmd[0]+' '+func.syntax, func.shorthelp, func.reqglevel)) | |
69 | if len(func.cmd) > 1: | |
70 | for c in func.cmd[1:]: | |
71 | bot.slowmsg(user, "%-40s - Alias of %s" % (c, func.cmd[0])) | |
5f03d045 | 72 | else: # help for a specific command/topic |
0f8352dd | 73 | cmd = str(' '.join(args)) |
74 | if cmd in cmds and user.glevel >= cmds[cmd].reqglevel: | |
75 | func = cmds[cmd] | |
76 | if func.reqglevel <= 0: | |
77 | bot.slowmsg(user, "%-40s - %-50s" % (func.cmd[0]+' '+func.syntax, func.shorthelp)) | |
78 | else: | |
79 | bot.slowmsg(user, "%-40s - %-50s (%5s)" % (func.cmd[0]+' '+func.syntax, func.shorthelp, func.reqglevel)) | |
80 | for line in func.longhelps: | |
81 | bot.slowmsg(user, " %s" % (line)) | |
82 | ||
83 | if len(func.cmd) > 1: | |
84 | bot.slowmsg(user, " Aliases: %s" % (' '.join(func.cmd[1:]))) | |
85 | else: | |
86 | bot.slowmsg(user, "No help found for %s" % (cmd)) |