Limnoria/src/Misc.py

428 lines
16 KiB
Python
Raw Normal View History

2003-03-27 07:34:48 +01:00
#!/usr/bin/env python
###
# Copyright (c) 2002, Jeremiah Fincher
# All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# * Redistributions of source code must retain the above copyright notice,
# this list of conditions, and the following disclaimer.
# * Redistributions in binary form must reproduce the above copyright notice,
# this list of conditions, and the following disclaimer in the
# documentation and/or other materials provided with the distribution.
# * Neither the name of the author of this software nor the name of
# contributors to this software may be used to endorse or promote products
# derived from this software without specific prior written consent.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.
###
"""
Miscellaneous commands.
"""
2003-11-25 09:38:19 +01:00
__revision__ = "$Id$"
import fix
2003-03-27 07:34:48 +01:00
import os
import sys
import getopt
from itertools import imap, ifilter
2003-03-27 07:34:48 +01:00
import conf
import utils
import irclib
import ircmsgs
import ircutils
2003-03-27 07:34:48 +01:00
import privmsgs
import callbacks
2003-10-21 08:03:57 +02:00
class Misc(callbacks.Privmsg):
priority = sys.maxint
def invalidCommand(self, irc, msg, tokens):
self.log.debug('Misc.invalidCommand called')
if conf.replyWhenNotCommand:
command = tokens and tokens[0] or ''
irc.error(msg, '%r is not a valid command.' % command)
else:
if not isinstance(irc.irc, irclib.Irc):
irc.reply(msg, '[%s]' % ' '.join(tokens))
2003-03-27 07:34:48 +01:00
def list(self, irc, msg, args):
"""[--private] [<module name>]
2003-03-27 07:34:48 +01:00
2003-09-07 06:05:34 +02:00
Lists the commands available in the given plugin. If no plugin is
given, lists the public plugins available. If --private is given,
lists all commands, not just the public ones.
2003-03-27 07:34:48 +01:00
"""
(optlist, rest) = getopt.getopt(args, '', ['private'])
evenPrivate = False
for (option, argument) in optlist:
if option == '--private':
evenPrivate = True
name = privmsgs.getArgs(rest, required=0, optional=1)
2003-12-07 01:13:56 +01:00
name = callbacks.canonicalName(name)
2003-03-27 07:34:48 +01:00
if not name:
names = [cb.name() for cb in irc.callbacks
if evenPrivate or (hasattr(cb, 'public') and cb.public)]
2003-03-28 08:23:12 +01:00
names.sort()
2003-03-27 07:34:48 +01:00
irc.reply(msg, ', '.join(names))
else:
2003-12-07 01:13:56 +01:00
cb = irc.getCallback(name)
if cb is None:
irc.error(msg, 'No such plugin %r exists.' % name)
elif isinstance(cb, callbacks.PrivmsgRegexp) or \
not isinstance(cb, callbacks.Privmsg):
irc.error(msg, 'That plugin exists, but it has no commands.')
else:
commands = []
for s in dir(cb):
if cb.isCommand(s) and \
2003-12-09 22:32:55 +01:00
(s != name or cb._original) and \
2003-12-07 01:13:56 +01:00
s == callbacks.canonicalName(s):
method = getattr(cb, s)
if hasattr(method, '__doc__') and method.__doc__:
commands.append(s)
if commands:
2003-03-28 08:23:12 +01:00
commands.sort()
2003-03-27 07:34:48 +01:00
irc.reply(msg, ', '.join(commands))
2003-12-07 01:13:56 +01:00
else:
irc.error(msg, 'That plugin exists, but it has no '
'commands with help.')
2003-10-22 06:32:29 +02:00
def apropos(self, irc, msg, args):
"""<string>
Searches for <string> in the commands currently offered by the bot,
returning a list of the commands containing that string.
"""
s = privmsgs.getArgs(args)
commands = {}
2003-10-22 06:32:29 +02:00
L = []
for cb in irc.callbacks:
if isinstance(cb, callbacks.Privmsg) and \
not isinstance(cb, callbacks.PrivmsgRegexp):
for attr in dir(cb):
if s in attr and cb.isCommand(attr):
if attr == callbacks.canonicalName(attr):
commands.setdefault(attr, []).append(cb.name())
for (key, names) in commands.iteritems():
if len(names) == 1:
L.append(key)
else:
for name in names:
L.append('%s %s' % (name, key))
if L:
L.sort()
irc.reply(msg, utils.commaAndify(L))
else:
irc.error(msg, 'No appropriate commands were found.')
2003-10-22 06:32:29 +02:00
def help(self, irc, msg, args):
"""[<plugin>] <command>
2003-03-27 07:34:48 +01:00
2003-10-22 20:49:51 +02:00
This command gives a useful description of what <command> does.
<plugin> is only necessary if the command is in more than one plugin.
2003-03-27 07:34:48 +01:00
"""
if len(args) > 1:
cb = irc.getCallback(args[0])
if cb is not None:
command = callbacks.canonicalName(privmsgs.getArgs(args[1:]))
command = command.lstrip(conf.prefixChars)
name = ' '.join(args)
if hasattr(cb, 'isCommand') and cb.isCommand(command):
method = getattr(cb, command)
if hasattr(method, '__doc__') and method.__doc__ != None:
irc.reply(msg, callbacks.getHelp(method, name=name))
else:
irc.error(msg, 'That command has no help.')
else:
irc.error(msg, 'There is no such command %s.' % name)
2003-03-27 07:34:48 +01:00
else:
irc.error(msg, 'There is no such plugin %s' % args[0])
return
2003-03-27 07:34:48 +01:00
command = callbacks.canonicalName(privmsgs.getArgs(args))
# Users might expect "@help @list" to work.
command = command.lstrip(conf.prefixChars)
cbs = callbacks.findCallbackForCommand(irc, command)
if len(cbs) > 1:
names = [cb.name() for cb in cbs]
names.sort()
2003-10-22 20:49:51 +02:00
irc.error(msg, 'That command exists in the %s plugins. '
'Please specify exactly which plugin command '
'you want help with.'% utils.commaAndify(names))
return
elif not cbs:
irc.error(msg, 'There is no such command %s.' % command)
else:
cb = cbs[0]
2003-03-27 07:34:48 +01:00
method = getattr(cb, command)
if hasattr(method, '__doc__') and method.__doc__ is not None:
irc.reply(msg, callbacks.getHelp(method, name=command))
2003-03-27 07:34:48 +01:00
else:
irc.error(msg, '%s has no help.' % command)
2003-08-20 18:26:23 +02:00
2003-09-12 23:16:59 +02:00
def hostmask(self, irc, msg, args):
"""[<nick>]
2003-09-12 23:16:59 +02:00
Returns the hostmask of <nick>. If <nick> isn't given, return the
hostmask of the person giving the command.
2003-09-12 23:16:59 +02:00
"""
nick = privmsgs.getArgs(args, required=0, optional=1)
if nick:
try:
irc.reply(msg, irc.state.nickToHostmask(nick))
except KeyError:
irc.error(msg, 'I haven\'t seen anyone named %r' % nick)
else:
irc.reply(msg, msg.prefix)
2003-09-12 23:16:59 +02:00
2003-03-27 07:34:48 +01:00
def version(self, irc, msg, args):
"""takes no arguments
Returns the version of the current bot.
"""
2003-08-28 15:59:07 +02:00
irc.reply(msg, conf.version)
2003-03-27 07:34:48 +01:00
def revision(self, irc, msg, args):
"""[<module>]
Gives the latest revision of <module>. If <module> isn't given, gives
the revision of all supybot modules.
"""
name = privmsgs.getArgs(args, required=0, optional=1)
if name:
try:
2003-12-02 12:06:39 +01:00
modules = {}
for moduleName in sys.modules:
modules[moduleName.lower()] = moduleName
module = sys.modules[modules[name.lower()]]
except KeyError:
irc.error(msg, 'I couldn\'t find a module named %s' % name)
return
if hasattr(module, '__revision__'):
irc.reply(msg, module.__revision__)
else:
irc.error(msg, 'Module %s has no __revision__.' % name)
else:
def getVersion(s):
try:
return s.split(None, 3)[2]
except:
self.log.exception('Couldn\'t get id string: %r', s)
names = {}
dirs = map(os.path.abspath, conf.pluginDirs)
for (name, module) in sys.modules.items(): # Don't use iteritems.
if hasattr(module, '__revision__'):
if 'supybot' in module.__file__:
names[name] = getVersion(module.__revision__)
else:
for dir in dirs:
if dir in module.__file__:
names[name] = getVersion(module.__revision__)
break
L = ['%s: %s' % (k, v) for (k, v) in names.items()]
irc.reply(msg, utils.commaAndify(L))
2003-03-28 09:41:11 +01:00
def source(self, irc, msg, args):
"""takes no arguments
Returns a URL saying where to get SupyBot.
"""
irc.reply(msg, 'My source is at http://supybot.sf.net/')
2003-03-28 09:41:11 +01:00
2003-03-27 07:34:48 +01:00
def logfilesize(self, irc, msg, args):
"""[<logfile>]
2003-03-27 07:34:48 +01:00
Returns the size of the various logfiles in use. If given a specific
logfile, returns only the size of that logfile.
2003-03-27 07:34:48 +01:00
"""
2003-11-26 20:24:28 +01:00
filenameArg = privmsgs.getArgs(args, required=0, optional=1)
if filenameArg:
if not filenameArg.endswith('.log'):
irc.error(msg, 'That filename doesn\'t appear to be a log.')
return
2003-11-26 20:24:28 +01:00
filenameArg = os.path.basename(filenameArg)
ret = []
for (dirname, _, filenames) in os.walk(conf.logDir):
if filenameArg:
if filenameArg in filenames:
filename = os.path.join(dirname, filenameArg)
stats = os.stat(filename)
ret.append('%s: %s' % (filename, stats.st_size))
else:
for filename in filenames:
stats = os.stat(os.path.join(dirname, filename))
ret.append('%s: %s' % (filename, stats.st_size))
if ret:
ret.sort()
irc.reply(msg, utils.commaAndify(ret))
else:
2003-11-26 20:24:28 +01:00
irc.error(msg, 'I couldn\'t find any logfiles.')
2003-03-27 07:34:48 +01:00
2003-03-27 22:34:50 +01:00
def getprefixchar(self, irc, msg, args):
"""takes no arguments
Returns the prefix character(s) the bot is currently using.
"""
irc.reply(msg, repr(conf.prefixChars))
2003-09-07 06:05:34 +02:00
def plugin(self, irc, msg, args):
2003-04-14 07:54:33 +02:00
"""<command>
2003-09-07 06:05:34 +02:00
Returns the plugin <command> is in.
2003-04-14 07:54:33 +02:00
"""
command = callbacks.canonicalName(privmsgs.getArgs(args))
cbs = callbacks.findCallbackForCommand(irc, command)
if cbs:
irc.reply(msg, utils.commaAndify([cb.name() for cb in cbs]))
2003-04-14 07:54:33 +02:00
else:
irc.error(msg, 'There is no such command %s' % command)
2003-09-07 06:05:34 +02:00
def more(self, irc, msg, args):
"""[<nick>]
2003-09-07 06:05:34 +02:00
If the last command was truncated due to IRC message length
limitations, returns the next chunk of the result of the last command.
2003-09-12 00:21:56 +02:00
If <nick> is given, it takes the continuation of the last command from
<nick> instead of the person sending this message.
2003-09-07 06:05:34 +02:00
"""
nick = privmsgs.getArgs(args, required=0, optional=1)
userHostmask = msg.prefix.split('!', 1)[1]
if nick:
try:
(private, L) = self._mores[nick]
if not private:
self._mores[userHostmask] = L[:]
else:
irc.error(msg, '%s has no public mores.' % nick)
return
except KeyError:
irc.error(msg, 'Sorry, I can\'t find a hostmask for %s' % nick)
return
2003-09-07 06:05:34 +02:00
try:
L = self._mores[userHostmask]
chunk = L.pop()
if L:
chunk += ' \x02(%s)\x0F' % \
utils.nItems(len(L), 'message', 'more')
2003-09-07 06:56:26 +02:00
irc.reply(msg, chunk, True)
2003-09-07 06:05:34 +02:00
except KeyError:
irc.error(msg, 'You haven\'t asked me a command!')
except IndexError:
irc.error(msg, 'That\'s all, there is no more.')
def _validLastMsg(self, msg):
return msg.prefix and \
msg.command == 'PRIVMSG' and \
ircutils.isChannel(msg.args[0])
def last(self, irc, msg, args):
"""[--{from,in,to,with,regexp}] <args>
Returns the last message matching the given criteria. --from requires
a nick from whom the message came; --in and --to require a channel the
message was sent to; --with requires some string that had to be in the
message; --regexp requires a regular expression the message must
match. By default, the current channel is searched.
"""
(optlist, rest) = getopt.getopt(args, '', ['from=', 'in=', 'to=',
'with=', 'regexp='])
predicates = {}
if ircutils.isChannel(msg.args[0]):
predicates['in'] = lambda m: m.args[0] == msg.args[0]
for (option, arg) in optlist:
if option == '--from':
def f(m, arg=arg):
return ircutils.hostmaskPatternEqual(arg, m.nick)
predicates['from'] = f
elif option == '--in' or option == 'to':
def f(m, arg=arg):
return m.args[0] == arg
predicates['in'] = f
elif option == '--with':
def f(m, arg=arg):
return arg in m.args[1]
predicates.setdefault('with', []).append(f)
elif option == '--regexp':
try:
r = utils.perlReToPythonRe(arg)
def f(m, r=r):
return r.search(m.args[1])
predicates.setdefault('regexp', []).append(f)
except ValueError, e:
irc.error(msg, str(e))
return
iterable = ifilter(self._validLastMsg, reviter(irc.state.history))
iterable.next() # Drop the first message.
predicates = list(utils.flatten(predicates.itervalues()))
for m in iterable:
for predicate in predicates:
if not predicate(m):
break
else:
irc.reply(msg, ircmsgs.prettyPrint(m))
return
irc.error(msg, 'I couldn\'t find a message matching that criteria.')
def tell(self, irc, msg, args):
"""<nick|channel> <text>
Tells the <nick|channel> whatever <text> is. Use nested commands to
your benefit here.
"""
(target, text) = privmsgs.getArgs(args, required=2)
if not ircutils.isNick(target) and not ircutils.isChannel(target):
irc.error(msg, '%s is not a valid nick or channel.' % target)
return
s = '%s wants me to tell you: %s' % (msg.nick, text)
irc.reply(msg, s, to=target, private=True)
def private(self, irc, msg, args):
"""<text>
Replies with <text> in private. Use nested commands to your benefit
here.
"""
text = privmsgs.getArgs(args)
irc.reply(msg, text, private=True)
2003-11-11 12:32:09 +01:00
def action(self, irc, msg, args):
"""<text>
2003-11-11 12:32:09 +01:00
Returns the arguments given it, but as an action.
"""
text = privmsgs.getArgs(args)
if text:
irc.queueMsg(ircmsgs.action(ircutils.replyTo(msg), ' '.join(args)))
else:
raise callbacks.Error
2003-11-11 12:32:09 +01:00
def notice(self, irc, msg, args):
"""<text>
Replies with <text> in a private notice. Use nested commands to your
benefit here.
"""
text = privmsgs.getArgs(args)
irc.reply(msg, text, notice=True)
2003-03-27 07:34:48 +01:00
2003-10-21 08:03:57 +02:00
Class = Misc
2003-03-27 07:34:48 +01:00
# vim:set shiftwidth=4 tabstop=8 expandtab textwidth=78: