Limnoria/plugins/Misc/plugin.py

640 lines
28 KiB
Python
Raw Normal View History

2005-01-19 14:14:38 +01:00
###
2005-01-19 14:33:05 +01:00
# Copyright (c) 2002-2005, Jeremiah Fincher
# Copyright (c) 2009, James McCoy
2005-01-19 14:14:38 +01:00
# 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.
###
2011-06-05 20:30:32 +02:00
import re
2005-01-19 14:14:38 +01:00
import os
import sys
import json
2005-01-19 14:14:38 +01:00
import time
import functools
2005-01-19 14:14:38 +01:00
2005-02-13 03:53:31 +01:00
import supybot
2005-01-19 14:14:38 +01:00
import supybot.conf as conf
from supybot import commands
2005-01-19 14:14:38 +01:00
import supybot.utils as utils
from supybot.commands import *
import supybot.ircdb as ircdb
import supybot.irclib as irclib
2015-08-11 16:50:23 +02:00
import supybot.utils.minisix as minisix
2005-01-19 14:14:38 +01:00
import supybot.ircmsgs as ircmsgs
import supybot.ircutils as ircutils
import supybot.callbacks as callbacks
import supybot.registry as registry
from supybot import commands
from supybot.i18n import PluginInternationalization, internationalizeDocstring
_ = PluginInternationalization('Misc')
if minisix.PY2:
from itertools import ifilter as filter
2011-09-01 19:48:09 +02:00
def getPluginsInDirectory(directory):
# get modules in a given directory
plugins = []
for filename in os.listdir(directory):
pluginPath = os.path.join(directory, filename)
if os.path.isdir(pluginPath):
if all(os.path.isfile(os.path.join(pluginPath, x))
for x in ['__init__.py', 'config.py', 'plugin.py']):
plugins.append(filename)
return plugins
class RegexpTimeout(Exception):
pass
class Misc(callbacks.Plugin):
"""Miscellaneous commands to access Supybot core. This is a core
Supybot plugin that should not be removed!"""
def __init__(self, irc):
self.__parent = super(Misc, self)
self.__parent.__init__(irc)
2013-05-09 09:40:55 +02:00
self.invalidCommands = \
ircutils.FloodQueue(conf.supybot.abuse.flood.interval())
conf.supybot.abuse.flood.interval.addCallback(self.setFloodQueueTimeout)
def setFloodQueueTimeout(self, *args, **kwargs):
self.invalidCommands.timeout = conf.supybot.abuse.flood.interval()
2005-01-19 14:14:38 +01:00
def callPrecedence(self, irc):
return ([cb for cb in irc.callbacks if cb is not self], [])
def invalidCommand(self, irc, msg, tokens):
assert not msg.repliedTo, 'repliedTo msg in Misc.invalidCommand.'
assert self is irc.callbacks[-1], 'Misc isn\'t last callback.'
assert msg.command in ('PRIVMSG', 'NOTICE')
2005-01-19 14:14:38 +01:00
self.log.debug('Misc.invalidCommand called (tokens %s)', tokens)
# First, we check for invalidCommand floods. This is rightfully done
# here since this will be the last invalidCommand called, and thus it
# will only be called if this is *truly* an invalid command.
maximum = conf.supybot.abuse.flood.command.invalid.maximum()
self.invalidCommands.enqueue(msg)
if self.invalidCommands.len(msg) > maximum and \
conf.supybot.abuse.flood.command.invalid() and \
not ircdb.checkCapability(msg.prefix, 'trusted'):
2005-01-19 14:14:38 +01:00
punishment = conf.supybot.abuse.flood.command.invalid.punishment()
banmask = '*!%s@%s' % (msg.user, msg.host)
self.log.info('Ignoring %s for %s seconds due to an apparent '
'invalid command flood.', banmask, punishment)
if tokens and tokens[0] == 'Error:':
self.log.warning('Apparent error loop with another Supybot '
'observed. Consider ignoring this bot '
'permanently.')
2005-01-19 14:14:38 +01:00
ircdb.ignores.add(banmask, time.time() + punishment)
if conf.supybot.abuse.flood.command.invalid.notify():
irc.reply(_('You\'ve given me %s invalid commands within the last '
2013-05-09 09:40:55 +02:00
'%i seconds; I\'m now ignoring you for %s.') %
(maximum,
2013-05-09 09:40:55 +02:00
conf.supybot.abuse.flood.interval(),
utils.timeElapsed(punishment, seconds=False)))
2005-01-19 14:14:38 +01:00
return
# Now, for normal handling.
channel = msg.channel
# Only bother with the invaildCommand flood handling if it's actually
# enabled
if conf.supybot.abuse.flood.command.invalid():
# First, we check for invalidCommand floods. This is rightfully done
# here since this will be the last invalidCommand called, and thus it
# will only be called if this is *truly* an invalid command.
maximum = conf.supybot.abuse.flood.command.invalid.maximum()
banmasker = conf.supybot.protocols.irc.banmask.makeBanmask
if self.invalidCommands.len(msg) > maximum and \
not ircdb.checkCapability(msg.prefix, 'trusted') and \
msg.prefix != irc.prefix and \
ircutils.isUserHostmask(msg.prefix):
penalty = conf.supybot.abuse.flood.command.invalid.punishment()
banmask = banmasker(msg.prefix, channel=channel,
network=irc.network)
self.log.info('Ignoring %s for %s seconds due to an apparent '
'invalid command flood.', banmask, penalty)
if tokens and tokens[0] == 'Error:':
self.log.warning('Apparent error loop with another Supybot '
'observed. Consider ignoring this bot '
'permanently.')
ircdb.ignores.add(banmask, time.time() + penalty)
if conf.supybot.abuse.flood.command.invalid.notify():
irc.reply('You\'ve given me %s invalid commands within '
'the last minute; I\'m now ignoring you for %s.' %
(maximum,
utils.timeElapsed(penalty, seconds=False)))
return
# Now, for normal handling.
if conf.supybot.reply.whenNotCommand.getSpecific(
irc.network, channel)():
if len(tokens) >= 2:
cb = irc.getCallback(tokens[0])
if cb:
plugin = cb.name()
irc.error(format(_('The %q plugin is loaded, but there is '
'no command named %q in it. Try "list '
'%s" to see the commands in the %q '
'plugin.'), plugin, tokens[1],
plugin, plugin))
else:
irc.errorInvalid(_('command'), tokens[0], repr=False)
else:
command = tokens and tokens[0] or ''
irc.errorInvalid(_('command'), command, repr=False)
2005-01-19 14:14:38 +01:00
else:
if tokens:
# echo [] will get us an empty token set, but there's no need
# to log this in that case anyway, it being a nested command.
self.log.info('Not replying to %s in %s, not a command.',
tokens[0], channel or _('private'))
if irc.nested:
2005-01-19 14:14:38 +01:00
bracketConfig = conf.supybot.commands.nested.brackets
brackets = bracketConfig.getSpecific(irc.network, channel)()
2005-01-19 14:14:38 +01:00
if brackets:
(left, right) = brackets
irc.reply(left + ' '.join(tokens) + right)
else:
pass # Let's just do nothing, I can't think of better.
def isPublic(self, cb):
name = cb.name()
return conf.supybot.plugins.get(name).public()
@internationalizeDocstring
2005-01-19 14:14:38 +01:00
def list(self, irc, msg, args, optlist, cb):
2011-09-01 19:48:09 +02:00
"""[--private] [--unloaded] [<plugin>]
2005-01-19 14:14:38 +01:00
Lists the commands available in the given plugin. If no plugin is
given, lists the public plugins available. If --private is given,
2011-09-01 19:48:09 +02:00
lists the private plugins. If --unloaded is given, it will list
available plugins that are not loaded.
2005-01-19 14:14:38 +01:00
"""
private = False
2011-09-01 19:48:09 +02:00
unloaded = False
2005-01-19 14:14:38 +01:00
for (option, argument) in optlist:
if option == 'private':
private = True
if not self.registryValue('listPrivatePlugins') and \
not ircdb.checkCapability(msg.prefix, 'owner'):
irc.errorNoCapability('owner')
2011-09-01 19:48:09 +02:00
elif option == 'unloaded':
unloaded = True
if not self.registryValue('listUnloadedPlugins') and \
not ircdb.checkCapability(msg.prefix, 'owner'):
irc.errorNoCapability('owner')
if unloaded and private:
irc.error(_('--private and --unloaded are incompatible options.'))
2011-09-01 19:48:09 +02:00
return
2005-01-19 14:14:38 +01:00
if not cb:
2011-09-01 19:48:09 +02:00
if unloaded:
# We were using the path of Misc + .. to detect the install
# directory. However, it fails if Misc is not in the
# installation directory for some reason, so we use a
# supybot module.
2011-09-01 19:48:09 +02:00
installedPluginsDirectory = os.path.join(
os.path.dirname(conf.__file__), 'plugins')
2011-09-01 19:48:09 +02:00
plugins = getPluginsInDirectory(installedPluginsDirectory)
for directory in conf.supybot.directories.plugins()[:]:
plugins.extend(getPluginsInDirectory(directory))
# Remove loaded plugins:
loadedPlugins = [x.name() for x in irc.callbacks]
plugins = [x for x in plugins if x not in loadedPlugins]
plugins.sort()
irc.reply(format('%L', plugins))
2005-01-19 14:14:38 +01:00
else:
2011-09-01 19:48:09 +02:00
names = [cb.name() for cb in irc.callbacks
if (private and not self.isPublic(cb)) or
(not private and self.isPublic(cb))]
2011-09-01 19:48:09 +02:00
names.sort()
if names:
irc.reply(format('%L', names))
2005-01-19 14:14:38 +01:00
else:
2011-09-01 19:48:09 +02:00
if private:
irc.reply(_('There are no private plugins.'))
else:
irc.reply(_('There are no public plugins.'))
2005-01-19 14:14:38 +01:00
else:
commands = cb.listCommands()
if commands:
commands.sort()
irc.reply(format('%L', commands))
2005-01-19 14:14:38 +01:00
else:
irc.reply(format(_('That plugin exists, but has no commands. '
'This probably means that it has some '
'configuration variables that can be '
'changed in order to modify its behavior. '
'Try "config list supybot.plugins.%s" to see '
'what configuration variables it has.'),
cb.name()))
2011-09-01 19:48:09 +02:00
list = wrap(list, [getopts({'private':'', 'unloaded':''}),
additional('plugin')])
2005-01-19 14:14:38 +01:00
@internationalizeDocstring
2005-01-19 14:14:38 +01:00
def apropos(self, irc, msg, args, s):
"""<string>
Searches for <string> in the commands currently offered by the bot,
returning a list of the commands containing that string.
"""
commands = {}
L = []
for cb in irc.callbacks:
if isinstance(cb, callbacks.Plugin):
for command in cb.listCommands():
if s in command:
commands.setdefault(command, []).append(cb.name())
2015-08-08 22:20:14 +02:00
for (key, names) in commands.items():
for name in names:
L.append('%s %s' % (name, key))
2005-01-19 14:14:38 +01:00
if L:
L.sort()
2005-01-31 15:52:27 +01:00
irc.reply(format('%L', L))
2005-01-19 14:14:38 +01:00
else:
irc.reply(_('No appropriate commands were found.'))
2005-01-19 14:14:38 +01:00
apropos = wrap(apropos, ['lowered'])
@internationalizeDocstring
def help(self, irc, msg, args, command):
2005-01-19 14:14:38 +01:00
"""[<plugin>] [<command>]
This command gives a useful description of what <command> does.
<plugin> is only necessary if the command is in more than one plugin.
You may also want to use the 'list' command to list all available
plugins and commands.
2005-01-19 14:14:38 +01:00
"""
if not command:
cHelp = self.registryValue("customHelpString")
if cHelp:
irc.reply(cHelp)
else:
irc.reply(_(
"Use the 'list' command to list all plugins, and "
"'list <plugin>' to list all commands in a plugin. "
"To show the help of a command, use 'help <command>'. "
))
return
command = list(map(callbacks.canonicalName, command))
(maxL, cbs) = irc.findCallbacksForArgs(command)
if maxL == command:
2005-02-19 20:44:49 +01:00
if len(cbs) > 1:
2005-01-19 14:14:38 +01:00
names = sorted([cb.name() for cb in cbs])
irc.error(format(_('That command exists in the %L plugins. '
2005-01-31 15:52:27 +01:00
'Please specify exactly which plugin command '
'you want help with.'), names))
2005-01-19 14:14:38 +01:00
else:
2005-02-19 20:44:49 +01:00
assert cbs, 'Odd, maxL == command, but no cbs.'
irc.reply(_.__call__(cbs[0].getCommandHelp(command, False)))
2005-01-19 14:14:38 +01:00
else:
plugins = [cb.name() for cb in irc.callbacks
if self.isPublic(cb)]
s = format(_('There is no command %q.'),
callbacks.formatCommand(command))
if command[0].lower() in map(str.lower, plugins):
s += (' However, "{0}" is the name of a loaded plugin, and '
'you may be able to find its provided commands '
'using \'list {0}\'.'.format(command[0].title()))
irc.error(s)
help = wrap(help, [any('something')])
2005-01-19 14:14:38 +01:00
@internationalizeDocstring
2005-01-19 14:14:38 +01:00
def version(self, irc, msg, args):
"""takes no arguments
Returns the version of the current bot.
"""
try:
newestUrl = 'https://api.github.com/repos/ProgVal/Limnoria/' + \
'commits/%s'
2011-06-05 20:30:32 +02:00
versions = {}
for branch in ('master', 'testing'):
2012-08-04 20:25:36 +02:00
data = json.loads(utils.web.getUrl(newestUrl % branch)
.decode('utf8'))
version = data['commit']['committer']['date']
# Strip the last 'Z':
version = version.rsplit('T', 1)[0].replace('-', '.')
if minisix.PY2 and isinstance(version, unicode):
2014-01-01 12:40:49 +01:00
version = version.encode('utf8')
2013-07-01 10:34:58 +02:00
versions[branch] = version
2011-06-05 20:30:32 +02:00
newest = _('The newest versions available online are %s.') % \
2011-06-06 19:06:52 +02:00
', '.join([_('%s (in %s)') % (y,x)
2011-06-05 20:30:32 +02:00
for x,y in versions.items()])
except utils.web.Error as e:
self.log.info('Couldn\'t get website version: %s', e)
newest = _('I couldn\'t fetch the newest version '
2011-06-05 20:30:32 +02:00
'from the Limnoria repository.')
2016-04-02 18:57:10 +02:00
s = _('The current (running) version of this Limnoria is %s, '
'running on Python %s. %s') % \
2013-10-29 17:10:59 +01:00
(conf.version, sys.version.replace('\n', ' '), newest)
2005-01-19 14:14:38 +01:00
irc.reply(s)
version = wrap(thread(version))
@internationalizeDocstring
2005-01-19 14:14:38 +01:00
def source(self, irc, msg, args):
"""takes no arguments
2011-07-16 13:45:43 +02:00
Returns a URL saying where to get Limnoria.
2005-01-19 14:14:38 +01:00
"""
2011-07-10 17:08:20 +02:00
irc.reply(_('My source is at https://github.com/ProgVal/Limnoria'))
2005-01-19 14:14:38 +01:00
source = wrap(source)
@internationalizeDocstring
2005-01-19 14:14:38 +01:00
def more(self, irc, msg, args, nick):
"""[<nick>]
If the last command was truncated due to IRC message length
limitations, returns the next chunk of the result of the last command.
If <nick> is given, it takes the continuation of the last command from
<nick> instead of the person sending this message.
"""
userHostmask = msg.prefix.split('!', 1)[1]
if nick:
try:
(private, L) = irc._mores[nick]
2005-01-19 14:14:38 +01:00
if not private:
irc._mores[userHostmask] = L[:]
2005-01-19 14:14:38 +01:00
else:
irc.error(_('%s has no public mores.') % nick)
2005-01-19 14:14:38 +01:00
return
except KeyError:
irc.error(_('Sorry, I can\'t find any mores for %s') % nick)
2005-01-19 14:14:38 +01:00
return
try:
L = irc._mores[userHostmask]
except KeyError:
irc.error(_('You haven\'t asked me a command; perhaps you want '
'to see someone else\'s more. To do so, call this '
'command with that person\'s nick.'), Raise=True)
number = self.registryValue('mores', msg.channel, irc.network)
if conf.supybot.protocols.irc.experimentalExtensions() \
and 'draft/multiline' in irc.state.capabilities_ack:
use_multiline = True
multiline_cap_values = ircutils.parseCapabilityKeyValue(
irc.state.capabilities_ls['draft/multiline'])
if multiline_cap_values.get('max-lines', '').isnumeric():
number = min(number, int(multiline_cap_values['max-lines']))
else:
use_multiline = False
msgs = L[-number:]
msgs.reverse()
L[-number:] = []
if msgs:
if use_multiline and len(msgs) > 1:
# If draft/multiline is available, use it.
# TODO: set concat=True. For now we can't, because every
# message has "(XX more messages)" at the end, so it would be
# unreadable if the messages were concatenated
irc.queueMultilineBatches(msgs, target=msgs[0].args[0],
targetNick=msg.nick, concat=False)
else:
for msg in msgs:
irc.queueMsg(msg)
else:
irc.error(_('That\'s all, there is no more.'))
2005-01-19 14:14:38 +01:00
more = wrap(more, [additional('seenNick')])
def _validLastMsg(self, irc, msg):
2005-01-19 14:14:38 +01:00
return msg.prefix and \
msg.command == 'PRIVMSG' and \
msg.channel
2005-01-19 14:14:38 +01:00
@internationalizeDocstring
2005-01-19 14:14:38 +01:00
def last(self, irc, msg, args, optlist):
"""[--{from,in,on,with,without,regexp} <value>] [--nolimit]
Returns the last message matching the given criteria. --from requires
a nick from whom the message came; --in requires a channel the message
was sent to; --on requires a network the message was sent on; --with
requires some string that had to be in the message; --regexp requires
a regular expression the message must match; --nolimit returns all
the messages that can be found. By default, the channel this command is
given in is searched.
"""
predicates = {}
nolimit = False
skipfirst = True
if msg.channel:
2005-01-19 14:14:38 +01:00
predicates['in'] = lambda m: ircutils.strEqual(m.args[0],
msg.channel)
else:
skipfirst = False
2005-01-19 14:14:38 +01:00
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':
def f(m, arg=arg):
return ircutils.strEqual(m.args[0], arg)
predicates['in'] = f
if arg != msg.channel:
skipfirst = False
2005-01-19 14:14:38 +01:00
elif option == 'on':
def f(m, arg=arg):
return m.receivedOn == arg
predicates['on'] = f
elif option == 'with':
def f(m, arg=arg):
return arg.lower() in m.args[1].lower()
predicates.setdefault('with', []).append(f)
elif option == 'without':
def f(m, arg=arg):
return arg.lower() not in m.args[1].lower()
predicates.setdefault('without', []).append(f)
elif option == 'regexp':
def f(m, arg=arg):
def f1(s, arg):
"""Since we can't enqueue match objects into the multiprocessing queue,
we'll just wrap the function to return bools."""
if process(arg.search, s, timeout=0.1) is not None:
return True
else:
return False
2005-01-19 14:14:38 +01:00
if ircmsgs.isAction(m):
m1 = ircmsgs.unAction(m)
2005-01-19 14:14:38 +01:00
else:
m1 = m.args[1]
return regexp_wrapper(m1, reobj=arg, timeout=0.1,
plugin_name=self.name(),
fcn_name='last')
2005-01-19 14:14:38 +01:00
predicates.setdefault('regexp', []).append(f)
elif option == 'nolimit':
nolimit = True
iterable = filter(functools.partial(self._validLastMsg, irc),
reversed(irc.state.history))
if skipfirst:
# Drop the first message only if our current channel is the same as
# the channel we've been instructed to look at.
next(iterable)
2015-08-08 22:20:14 +02:00
predicates = list(utils.iter.flatten(predicates.values()))
# Make sure the user can't get messages from channels they aren't in
def userInChannel(m):
return m.args[0] in irc.state.channels \
and msg.nick in irc.state.channels[m.args[0]].users
predicates.append(userInChannel)
# Make sure the user can't get messages from a +s channel unless
# they're calling the command from that channel or from a query
# TODO: support statusmsg, but be careful about leaking scopes.
def notSecretMsg(m):
return not irc.isChannel(msg.args[0]) \
or msg.args[0] == m.args[0] \
or (m.args[0] in irc.state.channels \
and 's' not in irc.state.channels[m.args[0]].modes)
predicates.append(notSecretMsg)
2005-01-19 14:14:38 +01:00
resp = []
if irc.nested and not \
self.registryValue('last.nested.includeTimestamp'):
tsf = None
else:
tsf = self.registryValue('timestampFormat')
if irc.nested and not self.registryValue('last.nested.includeNick'):
showNick = False
else:
showNick = True
for m in iterable:
for predicate in predicates:
try:
if not predicate(m):
break
except RegexpTimeout:
irc.error(_('The regular expression timed out.'))
return
2005-01-19 14:14:38 +01:00
else:
if nolimit:
resp.append(ircmsgs.prettyPrint(m,
timestampFormat=tsf,
showNick=showNick))
else:
irc.reply(ircmsgs.prettyPrint(m,
timestampFormat=tsf,
showNick=showNick))
return
if not resp:
irc.error(_('I couldn\'t find a message matching that criteria in '
'my history of %s messages.') % len(irc.state.history))
2005-01-19 14:14:38 +01:00
else:
2005-01-31 15:52:27 +01:00
irc.reply(format('%L', resp))
2005-01-19 14:14:38 +01:00
last = wrap(last, [getopts({'nolimit': '',
'on': 'something',
'with': 'something',
'from': 'something',
'without': 'something',
'in': 'callerInGivenChannel',
'regexp': 'regexpMatcher',})])
def _tell(self, irc, msg, args, target, text, notice):
if irc.nested:
irc.error('This command cannot be nested.', Raise=True)
2005-01-19 14:14:38 +01:00
if target.lower() == 'me':
target = msg.nick
if irc.isChannel(target):
irc.error(_('Hey, just give the command. No need for the tell.'))
2005-01-19 14:14:38 +01:00
return
if not ircutils.isNick(target):
irc.errorInvalid('nick', target)
if ircutils.nickEqual(target, irc.nick):
irc.error(_('You just told me, why should I tell myself?'),
Raise=True)
2005-01-19 14:14:38 +01:00
if target not in irc.state.nicksToHostmasks and \
not ircdb.checkCapability(msg.prefix, 'owner'):
# We'll let owners do this.
s = _('I haven\'t seen %s, I\'ll let you do the telling.') % target
2005-01-19 14:14:38 +01:00
irc.error(s, Raise=True)
if irc.action:
irc.action = False
text = '* %s %s' % (irc.nick, text)
s = _('%s wants me to tell you: %s') % (msg.nick, text)
irc.replySuccess()
irc.reply(s, to=target, private=True, notice=notice)
@internationalizeDocstring
def tell(self, *args):
"""<nick> <text>
Tells the <nick> whatever <text> is. Use nested commands to your
benefit here.
"""
self._tell(*args, notice=False)
2005-01-19 14:14:38 +01:00
tell = wrap(tell, ['something', 'text'])
@internationalizeDocstring
def noticetell(self, *args):
"""<nick> <text>
Tells the <nick> whatever <text> is, in a notice. Use nested
commands to your benefit here.
"""
self._tell(*args, notice=True)
noticetell = wrap(noticetell, ['something', 'text'])
@internationalizeDocstring
def ping(self, irc, msg, args):
"""takes no arguments
Checks to see if the bot is alive.
"""
irc.reply(_('pong'), prefixNick=False)
@internationalizeDocstring
def completenick(self, irc, msg, args, channel, beginning, optlist):
"""[<channel>] <beginning> [--match-case]
Returns the nick of someone on the channel whose nick begins with the
given <beginning>.
<channel> defaults to the current channel."""
if channel not in irc.state.channels:
irc.error(_('I\'m not even in %s.') % channel, Raise=True)
if ('match-case', True) in optlist:
def match(nick):
return nick.startswith(beginning)
else:
beginning = beginning.lower()
def match(nick):
return nick.lower().startswith(beginning)
for nick in irc.state.channels[channel].users:
if match(nick):
irc.reply(nick)
return
irc.error(_('No such nick.'))
completenick = wrap(completenick, ['channel', 'something',
getopts({'match-case':''})])
@internationalizeDocstring
def clearmores(self, irc, msg, args):
"""takes no arguments
Clears all mores for the current network."""
irc._mores.clear()
irc.replySuccess()
clearmores = wrap(clearmores, ['admin'])
2005-01-19 14:14:38 +01:00
Class = Misc
# vim:set shiftwidth=4 softtabstop=4 expandtab textwidth=79: