2003-03-12 07:26:59 +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.
|
|
|
|
###
|
|
|
|
|
2003-03-25 07:53:51 +01:00
|
|
|
"""
|
|
|
|
Provides commands for manipulating channel topics.
|
|
|
|
"""
|
|
|
|
|
2003-11-25 09:23:47 +01:00
|
|
|
__revision__ = "$Id$"
|
|
|
|
|
2003-10-05 14:56:56 +02:00
|
|
|
import plugins
|
2003-03-12 07:26:59 +01:00
|
|
|
|
|
|
|
import re
|
|
|
|
import random
|
|
|
|
|
2003-10-11 23:03:02 +02:00
|
|
|
import conf
|
2003-06-02 08:41:35 +02:00
|
|
|
import utils
|
2003-03-12 07:26:59 +01:00
|
|
|
import ircdb
|
|
|
|
import ircmsgs
|
2003-12-02 17:26:08 +01:00
|
|
|
import plugins
|
2003-03-12 07:26:59 +01:00
|
|
|
import privmsgs
|
|
|
|
import callbacks
|
2003-12-04 00:14:09 +01:00
|
|
|
import configurable
|
2003-03-12 07:26:59 +01:00
|
|
|
|
2003-12-04 00:14:09 +01:00
|
|
|
class Topic(callbacks.Privmsg, configurable.Mixin):
|
2003-03-12 07:26:59 +01:00
|
|
|
topicFormatter = '%s (%s)'
|
2003-08-29 09:32:14 +02:00
|
|
|
topicUnformatter = re.compile('(.*) \((\S+)\)')
|
2003-12-04 00:14:09 +01:00
|
|
|
configurables = configurable.Dictionary(
|
2004-01-04 14:51:33 +01:00
|
|
|
[('separator', configurable.SpaceSurroundedStrType, ' || ',
|
2003-12-02 17:26:08 +01:00
|
|
|
"The separator between individual topics in the channel topic.")]
|
|
|
|
)
|
|
|
|
def __init__(self):
|
|
|
|
callbacks.Privmsg.__init__(self)
|
2003-12-04 00:14:09 +01:00
|
|
|
configurable.Mixin.__init__(self)
|
2003-12-02 17:26:08 +01:00
|
|
|
|
|
|
|
def _splitTopic(self, topic, channel):
|
|
|
|
separator = self.configurables.get('separator', channel)
|
|
|
|
return filter(None, topic.split(separator))
|
|
|
|
|
|
|
|
def _joinTopic(self, topics, channel):
|
|
|
|
separator = self.configurables.get('separator', channel)
|
|
|
|
return separator.join(topics)
|
2003-10-28 06:49:31 +01:00
|
|
|
|
2003-12-12 16:41:33 +01:00
|
|
|
def _unformatTopic(self, topic, channel):
|
|
|
|
m = self.topicUnformatter.match(topic)
|
|
|
|
if m:
|
|
|
|
return (m.group(1), m.group(2))
|
|
|
|
else:
|
|
|
|
return (topic, '')
|
|
|
|
|
2003-10-21 06:03:25 +02:00
|
|
|
def add(self, irc, msg, args, channel):
|
2003-04-16 09:11:28 +02:00
|
|
|
"""[<channel>] <topic>
|
|
|
|
|
|
|
|
Adds <topic> to the topics for <channel>. <channel> is only necessary
|
|
|
|
if the message isn't sent in the channel itself.
|
|
|
|
"""
|
2003-03-12 07:26:59 +01:00
|
|
|
topic = privmsgs.getArgs(args)
|
2003-12-02 17:26:08 +01:00
|
|
|
separator = self.configurables.get('separator', channel)
|
|
|
|
if separator in topic:
|
|
|
|
s = 'You can\'t have %s in your topic' % separator
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error(s)
|
2003-09-18 00:38:03 +02:00
|
|
|
return
|
|
|
|
currentTopic = irc.state.getTopic(channel)
|
|
|
|
try:
|
|
|
|
name = ircdb.users.getUser(msg.prefix).name
|
|
|
|
except KeyError:
|
|
|
|
name = msg.nick
|
|
|
|
formattedTopic = self.topicFormatter % (topic, name)
|
|
|
|
if currentTopic:
|
2003-12-02 17:26:08 +01:00
|
|
|
newTopic = self._joinTopic([currentTopic, formattedTopic], channel)
|
2003-03-12 07:26:59 +01:00
|
|
|
else:
|
2003-09-18 00:38:03 +02:00
|
|
|
newTopic = formattedTopic
|
|
|
|
irc.queueMsg(ircmsgs.topic(channel, newTopic))
|
2003-10-21 06:03:25 +02:00
|
|
|
add = privmsgs.checkChannelCapability(add, 'topic')
|
2003-03-12 07:26:59 +01:00
|
|
|
|
2003-10-21 06:03:25 +02:00
|
|
|
def shuffle(self, irc, msg, args, channel):
|
2003-04-16 09:11:28 +02:00
|
|
|
"""[<channel>]
|
|
|
|
|
|
|
|
Shuffles the topics in <channel>. <channel> is only necessary if the
|
|
|
|
message isn't sent in the channel itself.
|
|
|
|
"""
|
2003-09-18 00:38:03 +02:00
|
|
|
newtopic = irc.state.getTopic(channel)
|
2003-12-02 17:26:08 +01:00
|
|
|
topics = self._splitTopic(irc.state.getTopic(channel), channel)
|
2003-10-28 06:49:31 +01:00
|
|
|
if len(topics) == 0 or len(topics) == 1:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('I can\'t shuffle 1 or fewer topics.')
|
2003-10-28 06:49:31 +01:00
|
|
|
return
|
|
|
|
elif len(topics) == 2:
|
|
|
|
topics.reverse()
|
2003-12-02 17:26:08 +01:00
|
|
|
newtopic = self._joinTopic(topics, channel)
|
2003-10-28 06:49:31 +01:00
|
|
|
else:
|
2003-09-18 00:38:03 +02:00
|
|
|
random.shuffle(topics)
|
2003-12-02 17:26:08 +01:00
|
|
|
newtopic = self._joinTopic(topics, channel)
|
2003-10-28 06:49:31 +01:00
|
|
|
while newtopic == irc.state.getTopic(channel):
|
|
|
|
random.shuffle(topics)
|
2003-12-02 17:26:08 +01:00
|
|
|
newtopic = self._joinTopic(topics, channel)
|
2003-09-18 00:38:03 +02:00
|
|
|
irc.queueMsg(ircmsgs.topic(channel, newtopic))
|
2003-10-21 06:03:25 +02:00
|
|
|
shuffle = privmsgs.checkChannelCapability(shuffle, 'topic')
|
2003-09-18 00:38:03 +02:00
|
|
|
|
2003-12-09 15:05:32 +01:00
|
|
|
def reorder(self, irc, msg, args, channel):
|
|
|
|
"""[<channel>] <number> [<number> ...]
|
|
|
|
|
|
|
|
Reorders the topics from <channel> in the order of the specified
|
|
|
|
<number> arguments. <number> is a one-based index into the topics.
|
|
|
|
<channel> is only necessary if the message isn't sent in the channel
|
|
|
|
itself.
|
|
|
|
"""
|
|
|
|
topics = self._splitTopic(irc.state.getTopic(channel), channel)
|
2003-12-09 16:57:19 +01:00
|
|
|
num = len(topics)
|
|
|
|
if num == 0 or num == 1:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('I cannot reorder 1 or fewer topics.')
|
2003-12-09 16:57:19 +01:00
|
|
|
return
|
|
|
|
if len(args) != num:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('All topic numbers must be specified.')
|
2003-12-09 16:57:19 +01:00
|
|
|
return
|
|
|
|
order = privmsgs.getArgs(args, required=num)
|
2003-12-09 15:05:32 +01:00
|
|
|
if topics:
|
|
|
|
for i,p in enumerate(order):
|
|
|
|
try:
|
|
|
|
p = int(p)
|
|
|
|
if p > 0:
|
|
|
|
order[i] = p - 1
|
|
|
|
elif p == 0:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('0 is not a valid topic number.')
|
2003-12-09 15:05:32 +01:00
|
|
|
return
|
|
|
|
else:
|
|
|
|
order[i] = num + p
|
|
|
|
except ValueError:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('The positions must be valid integers.')
|
2003-12-09 15:05:32 +01:00
|
|
|
return
|
2003-12-09 15:51:04 +01:00
|
|
|
if utils.sorted(order) != range(num):
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('Duplicate topic numbers cannot be specified.')
|
2003-12-09 15:51:04 +01:00
|
|
|
return
|
2003-12-09 15:05:32 +01:00
|
|
|
try:
|
|
|
|
newtopics = [topics[i] for i in order]
|
|
|
|
newtopic = self._joinTopic(newtopics, channel)
|
|
|
|
irc.queueMsg(ircmsgs.topic(channel, newtopic))
|
|
|
|
except IndexError:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('An invalid topic number was specified.')
|
2003-12-09 15:05:32 +01:00
|
|
|
else:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('There are no topics to reorder.')
|
2003-12-09 15:05:32 +01:00
|
|
|
reorder = privmsgs.checkChannelCapability(reorder, 'topic')
|
|
|
|
|
2003-12-12 16:41:33 +01:00
|
|
|
def list(self, irc, msg, args, channel):
|
|
|
|
"""[<channel>] <number>
|
|
|
|
|
|
|
|
Returns a list of the topics in <channel>, prefixed by their indexes.
|
|
|
|
Mostly useful for topic reordering. <channel> is only necessary if the
|
|
|
|
message isn't sent in the channel itself.
|
|
|
|
"""
|
|
|
|
topics = self._splitTopic(irc.state.getTopic(channel), channel)
|
|
|
|
L = []
|
|
|
|
for (i, t) in enumerate(topics):
|
|
|
|
(t, _) = self._unformatTopic(t, channel)
|
|
|
|
L.append('%s: %s' % (i+1, utils.ellipsisify(t, 30)))
|
|
|
|
s = utils.commaAndify(L)
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.reply(s)
|
2003-12-12 16:41:33 +01:00
|
|
|
list = privmsgs.channel(list)
|
|
|
|
|
2003-10-21 06:03:25 +02:00
|
|
|
def get(self, irc, msg, args, channel):
|
2003-04-16 09:11:28 +02:00
|
|
|
"""[<channel>] <number>
|
|
|
|
|
2003-10-03 12:09:49 +02:00
|
|
|
Returns topic number <number> from <channel>. <number> is a one-based
|
2003-04-16 09:11:28 +02:00
|
|
|
index into the topics. <channel> is only necessary if the message
|
|
|
|
isn't sent in the channel itself.
|
|
|
|
"""
|
2003-10-02 07:58:53 +02:00
|
|
|
number = privmsgs.getArgs(args)
|
2003-04-16 09:11:28 +02:00
|
|
|
try:
|
2003-10-02 07:58:53 +02:00
|
|
|
number = int(number)
|
2003-10-28 06:49:31 +01:00
|
|
|
if number > 0:
|
2003-10-02 07:58:53 +02:00
|
|
|
number -= 1
|
2003-10-28 06:49:31 +01:00
|
|
|
elif number == 0:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('That\'s not a valid topic number.')
|
2003-10-28 06:49:31 +01:00
|
|
|
return
|
2003-04-16 09:11:28 +02:00
|
|
|
except ValueError:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('The argument must be a valid integer.')
|
2003-04-16 09:11:28 +02:00
|
|
|
return
|
2003-12-02 17:26:08 +01:00
|
|
|
topics = self._splitTopic(irc.state.getTopic(channel), channel)
|
2003-10-28 06:49:31 +01:00
|
|
|
if topics:
|
|
|
|
try:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.reply(self._unformatTopic(topics[number], channel)[0])
|
2003-10-28 06:49:31 +01:00
|
|
|
except IndexError:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('That\'s not a valid topic.')
|
2003-10-28 06:49:31 +01:00
|
|
|
else:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('There are no topics to get.')
|
2003-10-21 06:03:25 +02:00
|
|
|
get = privmsgs.channel(get)
|
2003-08-20 18:26:23 +02:00
|
|
|
|
2003-10-21 06:03:25 +02:00
|
|
|
def change(self, irc, msg, args, channel):
|
2003-04-16 09:11:28 +02:00
|
|
|
"""[<channel>] <number> <regexp>
|
|
|
|
|
|
|
|
Changes the topic number <number> on <channel> according to the regular
|
2003-10-03 12:09:49 +02:00
|
|
|
expression <regexp>. <number> is the one-based index into the topics;
|
2003-04-16 09:11:28 +02:00
|
|
|
<regexp> is a regular expression of the form
|
|
|
|
s/regexp/replacement/flags. <channel> is only necessary if the message
|
|
|
|
isn't sent in the channel itself.
|
|
|
|
"""
|
2003-11-11 14:20:06 +01:00
|
|
|
(number, regexp) = privmsgs.getArgs(args, required=2)
|
2003-03-28 18:30:10 +01:00
|
|
|
try:
|
|
|
|
number = int(number)
|
2003-10-28 06:49:31 +01:00
|
|
|
if number > 0:
|
2003-10-02 07:58:53 +02:00
|
|
|
number -= 1
|
2003-10-28 06:49:31 +01:00
|
|
|
elif number == 0:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('That\'s not a valid topic number.')
|
2003-10-28 06:49:31 +01:00
|
|
|
return
|
2003-03-28 18:30:10 +01:00
|
|
|
except ValueError:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('The <number> argument must be a number.')
|
2003-03-28 18:30:10 +01:00
|
|
|
return
|
2003-04-16 09:11:28 +02:00
|
|
|
try:
|
|
|
|
replacer = utils.perlReToReplacer(regexp)
|
|
|
|
except ValueError, e:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('The regexp wasn\'t valid: %s' % e.args[0])
|
2003-09-24 08:16:29 +02:00
|
|
|
return
|
2003-08-26 19:08:46 +02:00
|
|
|
except re.error, e:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error(utils.exnToString(e))
|
2003-03-28 18:30:10 +01:00
|
|
|
return
|
2003-12-02 17:26:08 +01:00
|
|
|
topics = self._splitTopic(irc.state.getTopic(channel), channel)
|
2003-10-28 06:49:31 +01:00
|
|
|
if not topics:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('There are no topics to change.')
|
2003-10-28 06:49:31 +01:00
|
|
|
return
|
2003-03-28 18:30:10 +01:00
|
|
|
topic = topics.pop(number)
|
2003-12-12 16:41:33 +01:00
|
|
|
(topic, name) = self._unformatTopic(topic, channel)
|
2003-04-16 10:34:44 +02:00
|
|
|
try:
|
2003-09-12 22:06:58 +02:00
|
|
|
senderName = ircdb.users.getUser(msg.prefix).name
|
2003-04-16 10:34:44 +02:00
|
|
|
except KeyError:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error(conf.replyNoUser)
|
2003-04-16 10:34:44 +02:00
|
|
|
return
|
2003-09-06 07:25:42 +02:00
|
|
|
if name and name != senderName and \
|
2003-08-19 03:20:56 +02:00
|
|
|
not ircdb.checkCapabilities(msg.prefix, ('op', 'admin')):
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('You can only modify your own topics.')
|
2003-03-28 18:30:10 +01:00
|
|
|
return
|
2003-04-16 09:11:28 +02:00
|
|
|
newTopic = self.topicFormatter % (replacer(topic), name)
|
2003-09-16 20:08:33 +02:00
|
|
|
if number < 0:
|
|
|
|
number = len(topics)+1+number
|
2003-03-28 18:30:10 +01:00
|
|
|
topics.insert(number, newTopic)
|
2003-12-02 17:26:08 +01:00
|
|
|
newTopic = self._joinTopic(topics, channel)
|
2003-03-28 18:30:10 +01:00
|
|
|
irc.queueMsg(ircmsgs.topic(channel, newTopic))
|
2003-10-21 06:03:25 +02:00
|
|
|
change = privmsgs.checkChannelCapability(change, 'topic')
|
2003-08-20 18:26:23 +02:00
|
|
|
|
2003-10-21 06:03:25 +02:00
|
|
|
def remove(self, irc, msg, args, channel):
|
2003-09-06 07:25:42 +02:00
|
|
|
"""[<channel>] <number>
|
|
|
|
|
|
|
|
Removes topic <number> from the topic for <channel> Topics are
|
2003-10-03 12:09:49 +02:00
|
|
|
numbered starting from 1; you can also use negative indexes to refer
|
2003-09-06 07:25:42 +02:00
|
|
|
to topics starting the from the end of the topic. <channel> is only
|
|
|
|
necessary if the message isn't sent in the channel itself.
|
|
|
|
"""
|
2003-03-12 07:26:59 +01:00
|
|
|
try:
|
|
|
|
number = int(privmsgs.getArgs(args))
|
2003-10-28 06:49:31 +01:00
|
|
|
if number > 0:
|
2003-10-02 07:58:53 +02:00
|
|
|
number -= 1
|
2003-10-28 06:49:31 +01:00
|
|
|
elif number == 0:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('That\'s not a valid topic number.')
|
2003-10-28 06:49:31 +01:00
|
|
|
return
|
2003-03-12 07:26:59 +01:00
|
|
|
except ValueError:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('The argument must be a number.')
|
2003-03-12 07:26:59 +01:00
|
|
|
return
|
2003-12-02 17:26:08 +01:00
|
|
|
topics = self._splitTopic(irc.state.getTopic(channel), channel)
|
2003-09-18 00:38:03 +02:00
|
|
|
try:
|
|
|
|
topic = topics.pop(number)
|
|
|
|
except IndexError:
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('That\'s not a valid topic number.')
|
2003-09-18 00:38:03 +02:00
|
|
|
return
|
2003-12-12 16:41:33 +01:00
|
|
|
(topic, name) = self._unformatTopic(topic, channel)
|
2003-09-18 00:38:03 +02:00
|
|
|
try:
|
|
|
|
username = ircdb.users.getUser(msg.prefix).name
|
|
|
|
except KeyError:
|
|
|
|
username = msg.nick
|
|
|
|
if name and name != username and \
|
|
|
|
not ircdb.checkCapabilities(msg.prefix, ('op', 'admin')):
|
2004-01-08 04:12:14 +01:00
|
|
|
irc.error('You can only remove your own topics.')
|
2003-09-18 00:38:03 +02:00
|
|
|
return
|
2003-12-02 17:26:08 +01:00
|
|
|
newTopic = self._joinTopic(topics, channel)
|
2003-09-18 00:38:03 +02:00
|
|
|
irc.queueMsg(ircmsgs.topic(channel, newTopic))
|
2003-10-21 06:03:25 +02:00
|
|
|
remove = privmsgs.checkChannelCapability(remove, 'topic')
|
2003-03-12 07:26:59 +01:00
|
|
|
|
|
|
|
|
2003-10-19 17:48:44 +02:00
|
|
|
Class = Topic
|
2003-10-18 15:14:57 +02:00
|
|
|
|
|
|
|
|
2003-03-24 09:41:19 +01:00
|
|
|
# vim:set shiftwidth=4 tabstop=8 expandtab textwidth=78:
|