mirror of https://github.com/Mikaela/Limnoria.git
510 lines
18 KiB
Python
510 lines
18 KiB
Python
###
|
|
# Copyright (c) 2004, Brett Kelly
|
|
# 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.
|
|
###
|
|
|
|
"""
|
|
A complete messaging system that allows users to leave 'notes' for other
|
|
users that can be retrieved later.
|
|
"""
|
|
|
|
__revision__ = "$Id$"
|
|
|
|
import csv
|
|
import sets
|
|
import time
|
|
import getopt
|
|
import os.path
|
|
import operator
|
|
|
|
from itertools import imap
|
|
|
|
import supybot.dbi as dbi
|
|
import supybot.log as log
|
|
import supybot.conf as conf
|
|
import supybot.utils as utils
|
|
import supybot.ircdb as ircdb
|
|
import supybot.ircmsgs as ircmsgs
|
|
import supybot.plugins as plugins
|
|
import supybot.privmsgs as privmsgs
|
|
import supybot.registry as registry
|
|
import supybot.ircutils as ircutils
|
|
import supybot.callbacks as callbacks
|
|
|
|
conf.registerPlugin('Note')
|
|
conf.registerGroup(conf.supybot.plugins.Note, 'notify')
|
|
conf.registerGlobalValue(conf.supybot.plugins.Note.notify, 'onJoin',
|
|
registry.Boolean(False, """Determines whether the bot will notify people of
|
|
their new messages when they join the channel. Normally it will notify
|
|
them when they send a message to the channel, since oftentimes joins are
|
|
the result of netsplits and not the actual presence of the user."""))
|
|
conf.registerGlobalValue(conf.supybot.plugins.Note.notify.onJoin, 'repeatedly',
|
|
registry.Boolean(False, """Determines whether the bot will repeatedly
|
|
notify people of their new messages when they join the channel. That means
|
|
when they join the channel, the bot will tell them they have unread
|
|
messages, even if it's told them before."""))
|
|
conf.registerGlobalValue(conf.supybot.plugins.Note.notify, 'autoSend',
|
|
registry.NonNegativeInteger(0, """Determines the upper limit for
|
|
automatically sending messages instead of notifications. I.e., if this
|
|
value is 2 and there are 2 new messages to notify a user about, instead of
|
|
sending a notification message, the bot will simply send those new messages.
|
|
If there are 3 new messages, however, the bot will send a notification
|
|
message."""))
|
|
|
|
class Ignores(registry.SpaceSeparatedListOfStrings):
|
|
List = ircutils.IrcSet
|
|
|
|
conf.registerUserValue(conf.users.plugins.Note, 'ignores', Ignores([], ''))
|
|
|
|
class NoteRecord(dbi.Record):
|
|
__fields__ = [
|
|
'frm',
|
|
'to',
|
|
'at',
|
|
'notified',
|
|
'read',
|
|
'public',
|
|
'text',
|
|
]
|
|
|
|
class DbiNoteDB(dbi.DB):
|
|
Mapping = 'flat'
|
|
Record = NoteRecord
|
|
|
|
def __init__(self, *args, **kwargs):
|
|
dbi.DB.__init__(self, *args, **kwargs)
|
|
self.unRead = {}
|
|
self.unNotified = {}
|
|
for record in self:
|
|
self._addCache(record)
|
|
|
|
def _addCache(self, record):
|
|
if not record.read:
|
|
self.unRead.setdefault(record.to, []).append(record.id)
|
|
if not record.notified:
|
|
self.unNotified.setdefault(record.to, []).append(record.id)
|
|
|
|
def _removeCache(self, record):
|
|
if record.notified:
|
|
try:
|
|
self.unNotified[record.to].remove(record.id)
|
|
except (KeyError, ValueError):
|
|
pass
|
|
if record.read:
|
|
try:
|
|
self.unRead[record.to].remove(record.id)
|
|
except (KeyError, ValueError):
|
|
pass
|
|
|
|
def setRead(self, id):
|
|
n = self.get(id)
|
|
n.read = True
|
|
n.notified = True
|
|
self._removeCache(n)
|
|
self.set(id, n)
|
|
|
|
def setNotified(self, id):
|
|
n = self.get(id)
|
|
n.notified = True
|
|
self._removeCache(n)
|
|
self.set(id, n)
|
|
|
|
def getUnnotifiedIds(self, to):
|
|
## def p(note):
|
|
## return not note.notified and note.to == to
|
|
## return [note.id for note in self.select(p)]
|
|
return self.unNotified.get(to, [])
|
|
|
|
def getUnreadIds(self, to):
|
|
## def p(note):
|
|
## return not note.read and note.to == to
|
|
## return [note.id for note in self.select(p)]
|
|
return self.unRead.get(to, [])
|
|
|
|
def send(self, frm, to, public, text):
|
|
n = self.Record(frm=frm, to=to, text=text,
|
|
at=time.time(), public=public)
|
|
id = self.add(n)
|
|
self._addCache(n)
|
|
return id
|
|
|
|
def unsend(self, id):
|
|
self.remove(id)
|
|
for cache in self.unRead, self.unNotified:
|
|
for (to, ids) in cache.items():
|
|
while id in ids:
|
|
ids.remove(id)
|
|
|
|
|
|
NoteDB = plugins.DB('Note', {'flat': DbiNoteDB})
|
|
|
|
|
|
class Note(callbacks.Privmsg):
|
|
def __init__(self):
|
|
self.__parent= super(Note, self)
|
|
self.__parent.__init__()
|
|
self.db = NoteDB()
|
|
|
|
def die(self):
|
|
self.__parent.die()
|
|
self.db.close()
|
|
|
|
def doPrivmsg(self, irc, msg):
|
|
self._notify(irc, msg)
|
|
|
|
def doJoin(self, irc, msg):
|
|
if self.registryValue('notify.onJoin'):
|
|
repeatedly = self.registryValue('notify.onJoin.repeatedly')
|
|
self._notify(irc, msg, repeatedly)
|
|
|
|
def _notify(self, irc, msg, repeatedly=False):
|
|
irc = callbacks.SimpleProxy(irc, msg)
|
|
try:
|
|
to = ircdb.users.getUserId(msg.prefix)
|
|
except KeyError:
|
|
return
|
|
ids = self.db.getUnnotifiedIds(to)
|
|
if len(ids) <= self.registryValue('notify.autoSend'):
|
|
for id in ids:
|
|
s = '#%s: %s' % (id, self._formatNote(self.db.get(id), to))
|
|
irc.reply(s, private=True)
|
|
self.db.setRead(id)
|
|
return
|
|
unnotifiedIds = ['#%s' % nid for nid in ids]
|
|
unnotified = len(unnotifiedIds)
|
|
if unnotified or repeatedly:
|
|
unreadIds = ['#%s' % nid for nid in self.db.getUnreadIds(to)]
|
|
unread = len(unreadIds)
|
|
s = 'You have %s; %s that I haven\'t told you about before now. '\
|
|
'%s %s still unread.' % \
|
|
(utils.nItems('note', unread, 'unread'), unnotified,
|
|
utils.commaAndify(unreadIds), utils.be(unread))
|
|
# Later we'll have a user value for allowing this to be a NOTICE.
|
|
irc.reply(s, private=True)
|
|
for nid in unnotifiedIds:
|
|
id = int(nid[1:])
|
|
self.db.setNotified(id)
|
|
|
|
def _getUserId(self, irc, name):
|
|
if ircdb.users.hasUser(name):
|
|
return ircdb.users.getUserId(name)
|
|
else:
|
|
try:
|
|
hostmask = irc.state.nickToHostmask(name)
|
|
return ircdb.users.getUserId(hostmask)
|
|
except KeyError:
|
|
return None
|
|
|
|
def _validId(self, irc, id):
|
|
try:
|
|
id = id.lstrip('#')
|
|
return int(id)
|
|
except ValueError:
|
|
irc.error('That\'s not a valid note id.', Raise=True)
|
|
|
|
def send(self, irc, msg, args):
|
|
"""<recipient>,[<recipient>,[...]] <text>
|
|
|
|
Sends a new note to the user specified. Multiple recipients may be
|
|
specified by separating their names by commas, with *no* spaces
|
|
between.
|
|
"""
|
|
(names, text) = privmsgs.getArgs(args, required=2)
|
|
# Let's get the from user.
|
|
try:
|
|
fromId = ircdb.users.getUserId(msg.prefix)
|
|
except KeyError:
|
|
irc.errorNotRegistered()
|
|
return
|
|
public = ircutils.isChannel(msg.args[0])
|
|
names = names.split(',')
|
|
ids = [self._getUserId(irc, name) for name in names]
|
|
badnames = []
|
|
# Make sure all targets are registered.
|
|
if None in ids:
|
|
for (id, name) in zip(ids, names):
|
|
if id is None:
|
|
badnames.append(name)
|
|
irc.errorNoUser(name=utils.commaAndify(badnames, And='or'))
|
|
return
|
|
|
|
# Make sure the sender isn't being ignored.
|
|
senderName = ircdb.users.getUser(fromId).name
|
|
for name in names:
|
|
ignores = self.userValue('ignores', name)
|
|
if ignores and senderName in ignores:
|
|
badnames.append(name)
|
|
if badnames:
|
|
irc.error('%s %s ignoring notes from you.' % \
|
|
(utils.commaAndify(badnames), utils.be(len(badnames))))
|
|
return
|
|
sent = []
|
|
for toId in ids:
|
|
id = self.db.send(fromId, toId, public, text)
|
|
name = ircdb.users.getUser(toId).name
|
|
s = 'note #%s sent to %s' % (id, name)
|
|
sent.append(s)
|
|
irc.reply(utils.commaAndify(sent).capitalize() + '.')
|
|
|
|
def reply(self, irc, msg, args):
|
|
"""<id> <text>
|
|
|
|
Sends a note in reply to <id>.
|
|
"""
|
|
if not args:
|
|
raise callbacks.ArgumentError
|
|
id = self._validId(irc, args[0])
|
|
args.append('(in reply to #%s)' % id)
|
|
note = self.db.get(id)
|
|
to = self.db.get(id).frm
|
|
self.db.setRead(id)
|
|
try:
|
|
args[0] = ircdb.users.getUser(to).name
|
|
except KeyError:
|
|
irc.error('Odd, the user you\'re replying to is no longer in the '
|
|
'database. You should notify my owner about this.')
|
|
return
|
|
self.send(irc, msg, args)
|
|
|
|
def unsend(self, irc, msg, args):
|
|
"""<id>
|
|
|
|
Unsends the note with the id given. You must be the
|
|
author of the note, and it must be unread.
|
|
"""
|
|
try:
|
|
userid = ircdb.users.getUserId(msg.prefix)
|
|
except KeyError:
|
|
irc.errorNotRegistered()
|
|
return
|
|
id = privmsgs.getArgs(args)
|
|
id = self._validId(irc, id)
|
|
note = self.db.get(id)
|
|
if note.frm == userid:
|
|
if not note.read:
|
|
self.db.unsend(id)
|
|
irc.replySuccess()
|
|
else:
|
|
irc.error('That note has been read already.')
|
|
else:
|
|
irc.error('That note wasn\'t sent by you.')
|
|
|
|
def _formatNote(self, note, to):
|
|
elapsed = utils.timeElapsed(time.time() - note.at)
|
|
if note.to == to:
|
|
author = ircdb.users.getUser(note.frm).name
|
|
return '%s (Sent by %s %s ago)' % (note.text, author, elapsed)
|
|
else:
|
|
assert note.frm == to, 'Odd, userid isn\'t frm either.'
|
|
recipient = ircdb.users.getUser(note.to).name
|
|
return '%s (Sent to %s %s ago)' % (note.text, recipient, elapsed)
|
|
|
|
def note(self, irc, msg, args):
|
|
"""<note id>
|
|
|
|
Retrieves a single note by its unique note id. Use the 'note list'
|
|
command to see what unread notes you have.
|
|
"""
|
|
try:
|
|
userid = ircdb.users.getUserId(msg.prefix)
|
|
except KeyError:
|
|
irc.errorNotRegistered()
|
|
return
|
|
id = privmsgs.getArgs(args)
|
|
id = self._validId(irc, id)
|
|
try:
|
|
note = self.db.get(id)
|
|
except KeyError:
|
|
irc.error('That\'s not a valid note id.')
|
|
return
|
|
if userid != note.frm and userid != note.to:
|
|
s = 'You may only retrieve notes you\'ve sent or received.'
|
|
irc.error(s)
|
|
return
|
|
newnote = self._formatNote(note, userid)
|
|
irc.reply(newnote, private=(not note.public))
|
|
self.db.setRead(id)
|
|
|
|
def ignore(self, irc, msg, args):
|
|
"""[--remove] <user>
|
|
|
|
Ignores all messages from <user>. If --remove is listed, remove <user>
|
|
from the list of users being ignored.
|
|
"""
|
|
remove = False
|
|
while '--remove' in args:
|
|
remove = True
|
|
args.remove('--remove')
|
|
user = privmsgs.getArgs(args)
|
|
try:
|
|
L = self.userValue('ignores', msg.prefix)
|
|
if remove:
|
|
try:
|
|
L.remove(user)
|
|
except (KeyError, ValueError):
|
|
irc.error('%r was not in your list of ignores.' % user)
|
|
return
|
|
else:
|
|
L.add(user)
|
|
self.setUserValue('ignores', msg.prefix, L)
|
|
irc.replySuccess()
|
|
except KeyError:
|
|
irc.errorNoUser()
|
|
|
|
def _formatNoteId(self, msg, note, sent=False):
|
|
if note.public or not ircutils.isChannel(msg.args[0]):
|
|
sender = ircdb.users.getUser(note.frm).name
|
|
if sent:
|
|
return '#%s to %s' % (note.id, sender)
|
|
else:
|
|
return '#%s from %s' % (note.id, sender)
|
|
else:
|
|
return '#%s (private)' % note.id
|
|
|
|
def list(self, irc, msg, args):
|
|
"""[--{old,sent}] [--{from,to} <user>]
|
|
|
|
Retrieves the ids of all your unread notes. If --old is given, list
|
|
read notes. If --sent is given, list notes that you have sent. If
|
|
--from is specified, only lists notes sent to you from <user>. If
|
|
--to is specified, only lists notes sent by you to <user>.
|
|
"""
|
|
options = ['old', 'sent', 'from=', 'to=']
|
|
(optlist, rest) = getopt.getopt(args, '', options)
|
|
sender, receiver, old, sent = ('', '', False, False)
|
|
for (option, arg) in optlist:
|
|
if option == '--old':
|
|
old = True
|
|
if option == '--sent':
|
|
sent = True
|
|
if option == '--from':
|
|
sender = arg
|
|
if option == '--to':
|
|
receiver = arg
|
|
sent = True
|
|
if old:
|
|
return self._oldnotes(irc, msg, sender)
|
|
if sent:
|
|
return self._sentnotes(irc, msg, receiver)
|
|
try:
|
|
userid = ircdb.users.getUserId(msg.prefix)
|
|
except KeyError:
|
|
irc.errorNotRegistered()
|
|
return
|
|
|
|
def p(note):
|
|
return not note.read and note.to == userid
|
|
if sender:
|
|
try:
|
|
sender = ircdb.users.getUserId(sender)
|
|
originalP = p
|
|
def p(note):
|
|
return originalP(note) and note.frm == sender
|
|
except KeyError:
|
|
irc.errorNoUser()
|
|
return
|
|
notes = list(self.db.select(p))
|
|
if not notes:
|
|
irc.reply('You have no unread notes.')
|
|
else:
|
|
utils.sortBy(operator.attrgetter('id'), notes)
|
|
ids = [self._formatNoteId(msg, note) for note in notes]
|
|
ids = self._condense(ids)
|
|
irc.reply(utils.commaAndify(ids))
|
|
|
|
def _condense(self, notes):
|
|
temp = {}
|
|
for note in notes:
|
|
note = note.split(' ', 1)
|
|
if note[1] in temp:
|
|
temp[note[1]].append(note[0])
|
|
else:
|
|
temp[note[1]] = [note[0]]
|
|
notes = []
|
|
for (k,v) in temp.iteritems():
|
|
notes.append('%s %s' % (utils.commaAndify(v), k))
|
|
return notes
|
|
|
|
def _sentnotes(self, irc, msg, receiver):
|
|
try:
|
|
userid = ircdb.users.getUserId(msg.prefix)
|
|
except KeyError:
|
|
irc.errorNotRegistered()
|
|
return
|
|
def p(note):
|
|
return note.frm == userid
|
|
if receiver:
|
|
try:
|
|
receiver = ircdb.users.getUserId(receiver)
|
|
except KeyError:
|
|
irc.error('That user is not in my user database.')
|
|
return
|
|
originalP = p
|
|
def p(note):
|
|
return originalP(note) and note.to == receiver
|
|
notes = list(self.db.select(p))
|
|
if not notes:
|
|
irc.error('I couldn\'t find any sent notes for your user.')
|
|
else:
|
|
utils.sortBy(operator.attrgetter('id'), notes)
|
|
notes.reverse() # Most recently sent first.
|
|
ids = [self._formatNoteId(msg, note, sent=True) for note in notes]
|
|
ids = self._condense(ids)
|
|
irc.reply(utils.commaAndify(ids))
|
|
|
|
def _oldnotes(self, irc, msg, sender):
|
|
try:
|
|
userid = ircdb.users.getUserId(msg.prefix)
|
|
except KeyError:
|
|
irc.errorNotRegistered()
|
|
return
|
|
def p(note):
|
|
return note.to == userid and note.read
|
|
if sender:
|
|
try:
|
|
sender = ircdb.users.getUserId(sender)
|
|
except KeyError:
|
|
irc.error('That user is not in my user database.')
|
|
return
|
|
originalP = p
|
|
def p(note):
|
|
return originalP(note) and note.frm == sender
|
|
notes = list(self.db.select(p))
|
|
if not notes:
|
|
irc.reply('I couldn\'t find any matching read notes for your user.')
|
|
else:
|
|
utils.sortBy(operator.attrgetter('id'), notes)
|
|
notes.reverse()
|
|
ids = [self._formatNoteId(msg, note) for note in notes]
|
|
ids = self._condense(ids)
|
|
irc.reply(utils.commaAndify(ids))
|
|
|
|
|
|
Class = Note
|
|
|
|
# vim: shiftwidth=4 tabstop=8 expandtab textwidth=78:
|