def handle_whereis(bot, ievent):
""" arguments: <cmnd> - locate a command. """
try: cmnd = ievent.args[0]
except IndexError:
ievent.missing('<cmnd>')
return
cmnds.reloadcheck(bot, ievent, cmnd)
plugin = cmnds.whereis(cmnd)
if plugin: ievent.reply("%s command is in: %s" % (cmnd, plugin))
else: ievent.reply("can't find " + cmnd)
def handle_helpplug(bot, ievent):
""" arguments: <plugname> - how help on plugin/command or show basic help msg. """
try: what = ievent.args[0]
except (IndexError, TypeError):
ievent.reply("available plugins: ", getpluginlist())
ievent.reply("see !help <plugin> to get help on a plugin.")
return
cmnds.reloadcheck(bot, ievent, what)
plugin = None
modname = ""
perms = []
for package in plugin_packages:
try:
modname = "%s.%s" % (package, what)
try:
plugin = plugs.load_mod(modname)
if plugin: break
except NoSuchPlugin: continue
except(KeyError, ImportError): pass
if not plugin:
ievent.reply("no %s plugin loaded" % what)
return
try: phelp = plugin.__doc__
except (KeyError, AttributeError):
ievent.reply('no description of %s plugin available' % what)
return
cmndresult = []
if phelp:
counter = 1
for i, j in cmnds.items():
if not j: continue
if what == j.plugname:
try:
descr = j.func.__doc__
if not descr: descr = "no description provided"
try: cmndresult.append(" <b>!%s</b> - <i>%s</i> - perms: %s" % (i, descr, j.perms))
except KeyError: pass
except AttributeError: pass
counter += 1
if cmndresult and phelp:
res = []
for r in cmndresult:
if bot.type in ['web', ]: res.append("%s<br>" % r)
elif bot.type in ['irc', ]: res.append(r.strip())
else: res.append(r)
res.sort()
what = what.upper()
ievent.reply('<b>help on plugin %s: </b><br>%s' % (what, phelp))
ievent.reply("commands: ", res, dot="count")
else:
if perms: ievent.reply('no commands available for permissions: %s' % ", ".join(perms))
else: ievent.reply("can't find help on %s" % what)
def handle_help(bot, event):
""" arguments: [<cmndname or plugname>] - show help. """
if not event.args:
event.reply("documentation for tl can be found at http:///docs/tl")
event.reply('see !list for loaded plugins and "!help plugin" for help on the plugin.')
return
t = event.args[0]
logging.warn("help target is %s" % t)
cmnds.reloadcheck(bot, event, t)
where = cmnds.whereis(t)
cmndhelp = cmnds.gethelp(t)
if not cmndhelp: handle_helpplug(bot, event) ; return
try: ex = examples[t].example
except KeyError: ex = None
p = cmnds.perms(t)
res = "permissions: %s - location: %s - examples: %s" % (", ".join(p), where, ex)
event.reply('help on %s command: %s' % (event.rest, cmndhelp), res.split(" - "), dot="<br>")
def woulddispatch(self):
cmnds.reloadcheck(self.bot, self)
return cmnds.woulddispatch(self.bot, self)
