mirror of
https://github.com/Mikaela/Limnoria.git
synced 2024-12-20 17:53:03 +01:00
592 lines
26 KiB
Python
592 lines
26 KiB
Python
###
|
|
# Copyright (c) 2002-2005, Jeremiah Fincher
|
|
# Copyright (c) 2009, James McCoy
|
|
# 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.
|
|
###
|
|
|
|
import re
|
|
import os
|
|
import imp
|
|
import sys
|
|
import json
|
|
import time
|
|
|
|
|
|
import supybot
|
|
|
|
import supybot.conf as conf
|
|
from supybot import commands
|
|
import supybot.utils as utils
|
|
from supybot.commands import *
|
|
import supybot.ircdb as ircdb
|
|
import supybot.irclib as irclib
|
|
import supybot.ircmsgs as ircmsgs
|
|
import supybot.ircutils as ircutils
|
|
import supybot.callbacks as callbacks
|
|
from supybot import commands
|
|
|
|
from supybot.i18n import PluginInternationalization, internationalizeDocstring
|
|
_ = PluginInternationalization('Misc')
|
|
|
|
if sys.version_info[0] < 3:
|
|
from itertools import ifilter as filter
|
|
|
|
def get_suffix(file):
|
|
for suffix in imp.get_suffixes():
|
|
if file[-len(suffix[0]):] == suffix[0]:
|
|
return suffix
|
|
return None
|
|
|
|
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):
|
|
def __init__(self, irc):
|
|
self.__parent = super(Misc, self)
|
|
self.__parent.__init__(irc)
|
|
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()
|
|
|
|
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')
|
|
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, 'owner'):
|
|
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.')
|
|
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 '
|
|
'%i seconds; I\'m now ignoring you for %s.') %
|
|
(maximum,
|
|
conf.supybot.abuse.flood.interval(),
|
|
utils.timeElapsed(punishment, seconds=False)))
|
|
return
|
|
# Now, for normal handling.
|
|
channel = msg.args[0]
|
|
# 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, 'owner') and \
|
|
msg.prefix != irc.prefix and \
|
|
ircutils.isUserHostmask(msg.prefix):
|
|
penalty = conf.supybot.abuse.flood.command.invalid.punishment()
|
|
banmask = banmasker(msg.prefix, channel=None)
|
|
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.get(conf.supybot.reply.whenNotCommand, 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)
|
|
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, not a command.', tokens[0])
|
|
if irc.nested:
|
|
bracketConfig = conf.supybot.commands.nested.brackets
|
|
brackets = conf.get(bracketConfig, channel)
|
|
if brackets:
|
|
(left, right) = brackets
|
|
irc.reply(left + ' '.join(tokens) + right)
|
|
else:
|
|
pass # Let's just do nothing, I can't think of better.
|
|
|
|
@internationalizeDocstring
|
|
def list(self, irc, msg, args, optlist, cb):
|
|
"""[--private] [--unloaded] [<plugin>]
|
|
|
|
Lists the commands available in the given plugin. If no plugin is
|
|
given, lists the public plugins available. If --private is given,
|
|
lists the private plugins. If --unloaded is given, it will list
|
|
available plugins that are not loaded.
|
|
"""
|
|
private = False
|
|
unloaded = False
|
|
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')
|
|
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 uncompatible options.'))
|
|
return
|
|
if not cb:
|
|
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.
|
|
installedPluginsDirectory = os.path.join(
|
|
os.path.dirname(conf.__file__), 'plugins')
|
|
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))
|
|
else:
|
|
def isPublic(cb):
|
|
name = cb.name()
|
|
return conf.supybot.plugins.get(name).public()
|
|
names = [cb.name() for cb in irc.callbacks
|
|
if (private and not isPublic(cb)) or
|
|
(not private and isPublic(cb))]
|
|
names.sort()
|
|
if names:
|
|
irc.reply(format('%L', names))
|
|
else:
|
|
if private:
|
|
irc.reply(_('There are no private plugins.'))
|
|
else:
|
|
irc.reply(_('There are no public plugins.'))
|
|
else:
|
|
commands = cb.listCommands()
|
|
if commands:
|
|
commands.sort()
|
|
irc.reply(format('%L', commands))
|
|
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()))
|
|
list = wrap(list, [getopts({'private':'', 'unloaded':''}),
|
|
additional('plugin')])
|
|
|
|
@internationalizeDocstring
|
|
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())
|
|
for (key, names) in commands.iteritems():
|
|
for name in names:
|
|
L.append('%s %s' % (name, key))
|
|
if L:
|
|
L.sort()
|
|
irc.reply(format('%L', L))
|
|
else:
|
|
irc.reply(_('No appropriate commands were found.'))
|
|
apropos = wrap(apropos, ['lowered'])
|
|
|
|
@internationalizeDocstring
|
|
def help(self, irc, msg, args, command):
|
|
"""[<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.
|
|
"""
|
|
command = list(map(callbacks.canonicalName, command))
|
|
(maxL, cbs) = irc.findCallbacksForArgs(command)
|
|
if maxL == command:
|
|
if len(cbs) > 1:
|
|
names = sorted([cb.name() for cb in cbs])
|
|
irc.error(format(_('That command exists in the %L plugins. '
|
|
'Please specify exactly which plugin command '
|
|
'you want help with.'), names))
|
|
else:
|
|
assert cbs, 'Odd, maxL == command, but no cbs.'
|
|
irc.reply(_.__call__(cbs[0].getCommandHelp(command, False)))
|
|
else:
|
|
irc.error(format(_('There is no command %q.'),
|
|
callbacks.formatCommand(command)))
|
|
help = wrap(help, [many('something')])
|
|
|
|
@internationalizeDocstring
|
|
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'
|
|
versions = {}
|
|
for branch in ('master', 'testing'):
|
|
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 sys.version_info[0] < 3 and isinstance(version, unicode):
|
|
version = version.encode('utf8')
|
|
versions[branch] = version
|
|
newest = _('The newest versions available online are %s.') % \
|
|
', '.join([_('%s (in %s)') % (y,x)
|
|
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 '
|
|
'from the Limnoria repository.')
|
|
s = _('The current (running) version of this Supybot is %s, '
|
|
'running on Python %s. %s') % \
|
|
(conf.version, sys.version.replace('\n', ' '), newest)
|
|
irc.reply(s)
|
|
version = wrap(thread(version))
|
|
|
|
@internationalizeDocstring
|
|
def source(self, irc, msg, args):
|
|
"""takes no arguments
|
|
|
|
Returns a URL saying where to get Limnoria.
|
|
"""
|
|
irc.reply(_('My source is at https://github.com/ProgVal/Limnoria'))
|
|
source = wrap(source)
|
|
|
|
@internationalizeDocstring
|
|
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]
|
|
if not private:
|
|
irc._mores[userHostmask] = L[:]
|
|
else:
|
|
irc.error(_('%s has no public mores.') % nick)
|
|
return
|
|
except KeyError:
|
|
irc.error(_('Sorry, I can\'t find any mores for %s') % nick)
|
|
return
|
|
try:
|
|
L = irc._mores[userHostmask]
|
|
number = self.registryValue('mores', msg.args[0])
|
|
chunks = [L.pop() for x in xrange(0, number)]
|
|
if L:
|
|
if len(L) < 2:
|
|
more = _('1 more message')
|
|
else:
|
|
more = _('%i more messages') % len(L)
|
|
chunks[-1] += format(' \x02(%s)\x0F', more)
|
|
irc.replies(chunks, noLengthCheck=True, oneToOne=False)
|
|
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.'))
|
|
except IndexError:
|
|
irc.error(_('That\'s all, there is no more.'))
|
|
more = wrap(more, [additional('seenNick')])
|
|
|
|
def _validLastMsg(self, msg):
|
|
return msg.prefix and \
|
|
msg.command == 'PRIVMSG' and \
|
|
ircutils.isChannel(msg.args[0])
|
|
|
|
@internationalizeDocstring
|
|
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 ircutils.isChannel(msg.args[0]):
|
|
predicates['in'] = lambda m: ircutils.strEqual(m.args[0],
|
|
msg.args[0])
|
|
else:
|
|
skipfirst = False
|
|
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.args[0]:
|
|
skipfirst = False
|
|
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 arg.search(s) is not None:
|
|
return True
|
|
else:
|
|
return False
|
|
if ircmsgs.isAction(m):
|
|
m1 = ircmsgs.unAction(m)
|
|
else:
|
|
m1 = m.args[1]
|
|
return regexp_wrapper(m1, reobj=arg, timeout=0.1,
|
|
plugin_name=self.name(),
|
|
fcn_name='last')
|
|
predicates.setdefault('regexp', []).append(f)
|
|
elif option == 'nolimit':
|
|
nolimit = True
|
|
iterable = filter(self._validLastMsg, 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)
|
|
predicates = list(utils.iter.flatten(predicates.itervalues()))
|
|
# 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
|
|
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)
|
|
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
|
|
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))
|
|
else:
|
|
irc.reply(format('%L', resp))
|
|
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)
|
|
if target.lower() == 'me':
|
|
target = msg.nick
|
|
if ircutils.isChannel(target):
|
|
irc.error(_('Hey, just give the command. No need for the tell.'))
|
|
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)
|
|
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
|
|
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)
|
|
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':''})])
|
|
|
|
Class = Misc
|
|
|
|
# vim:set shiftwidth=4 softtabstop=4 expandtab textwidth=79:
|