Limnoria/plugins/Lookup.py

404 lines
15 KiB
Python
Raw Normal View History

2003-09-11 00:22:50 +02:00
###
# Copyright (c) 2002-2004, Jeremiah Fincher
2003-09-11 00:22:50 +02: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.
###
"""
The Lookup plugin handles looking up various values by their key.
2003-09-11 00:22:50 +02:00
"""
import supybot
2003-11-25 09:23:47 +01:00
__revision__ = "$Id$"
__contributors__ = {
supybot.authors.skorobeus: ['--nokey parameter', 'database abstraction'],
}
2003-11-25 09:23:47 +01:00
2004-07-24 07:18:26 +02:00
import supybot.plugins as plugins
2003-09-11 00:22:50 +02:00
import os
import re
2003-09-11 00:22:50 +02:00
import sys
import sets
2003-12-11 01:25:50 +01:00
import getopt
import string
2003-09-11 00:22:50 +02:00
import supybot.dbi as dbi
2004-07-24 07:18:26 +02:00
import supybot.conf as conf
import supybot.utils as utils
import supybot.privmsgs as privmsgs
import supybot.registry as registry
import supybot.callbacks as callbacks
2003-09-11 00:22:50 +02:00
try:
import sqlite
except ImportError:
raise callbacks.Error, 'You need to have PySQLite installed to use this ' \
'plugin. Download it at <http://pysqlite.sf.net/>'
def configure(advanced):
2004-07-25 20:24:51 +02:00
from supybot.questions import output, expect, anything, something, yn
conf.registerPlugin('Lookup', True)
lookups = conf.supybot.plugins.Lookup.lookups
output("""This module allows you to define commands that do a simple key
lookup and return some simple value. It has a command "add"
that takes a command name and a file from the data dir and adds a
command with that name that responds with the mapping from that
file. The file itself should be composed of lines
of the form key:value.""")
while yn('Would you like to add a file?'):
2003-09-11 12:05:24 +02:00
filename = something('What\'s the filename?')
try:
2004-08-25 19:32:49 +02:00
fd = file(filename)
except EnvironmentError, e:
output('I couldn\'t open that file: %s' % e)
continue
2003-09-11 12:05:24 +02:00
counter = 1
try:
for line in fd:
line = line.rstrip('\r\n')
if not line or line.startswith('#'):
continue
2003-09-11 12:05:24 +02:00
(key, value) = line.split(':', 1)
counter += 1
except ValueError:
output('That\'s not a valid file; '
'line #%s is malformed.' % counter)
2003-09-11 12:05:24 +02:00
continue
command = something('What would you like the command to be?')
conf.registerGlobalValue(lookups,command, registry.String(filename,''))
nokeyVal = yn('Would you like the key to be shown for random \
responses?')
conf.registerGlobalValue(lookups.get(command), 'nokey',
registry.Boolean(nokeyVal, ''))
2003-09-11 00:22:50 +02:00
conf.registerPlugin('Lookup')
conf.registerGroup(conf.supybot.plugins.Lookup, 'lookups')
class SqliteLookupDB(object):
def __init__(self, filename):
try:
import sqlite
except ImportError:
raise callbacks.Error, 'You need to have PySQLite installed to '\
'use this plugin. Download it at '\
'<http://pysqlite.sf.net/>'
self.filename = filename
try:
self.db = sqlite.connect(self.filename)
except sqlite.DatabaseError, e:
raise dbi.InvalidDBError, str(e)
def close(self):
self.db.close()
def getRecordCount(self, tableName):
cursor = self.db.cursor()
cursor.execute("""SELECT COUNT(*) FROM %s""" % tableName)
rows = int(cursor.fetchone()[0])
if rows == 0:
raise dbi.NoRecordError
return rows
def checkLookup(self, name):
cursor = self.db.cursor()
sql = "SELECT name FROM sqlite_master \
WHERE type='table' \
AND name='%s'" % name
cursor.execute(sql)
if cursor.rowcount == 0:
return False
else:
return True
def addLookup(self, name, fd, splitRe):
cursor = self.db.cursor()
cursor.execute("CREATE TABLE %s (key TEXT, value TEXT)" % name)
sql = "INSERT INTO %s VALUES (%%s, %%s)" % name
for line in utils.nonCommentNonEmptyLines(fd):
line = line.rstrip('\r\n')
try:
(key, value) = splitRe.split(line, 1)
key = key.replace('\\:', ':')
except ValueError:
cursor.execute("""DROP TABLE %s""" % name)
s = 'Invalid line in %s: %r' % (filename, line)
raise callbacks.Error, s
cursor.execute(sql, key, value)
cursor.execute("CREATE INDEX %s_keys ON %s (key)" % (name, name))
self.db.commit()
def dropLookup(self, name):
cursor = self.db.cursor()
if self.checkLookup(name):
cursor.execute("""DROP TABLE %s""" % name)
self.db.commit()
else:
raise dbi.NoRecordError
def getResults(self, name, key):
cursor = self.db.cursor()
sql = """SELECT value FROM %s WHERE key LIKE %%s""" % name
cursor.execute(sql, key)
if cursor.rowcount == 0:
raise dbi.NoRecordError
else:
return cursor.fetchall()
def getRandomResult(self, name, key):
cursor = self.db.cursor()
sql = """SELECT key, value FROM %s
ORDER BY random() LIMIT 1""" % name
cursor.execute(sql)
if cursor.rowcount == 0:
raise dbi.NoRecordError
else:
return cursor.fetchone()
_sqlTrans = string.maketrans('*?', '%_')
def searchResults(self, name, options, globs, column):
cursor = self.db.cursor()
criteria = []
formats = []
predicateName = 'p'
for (option, arg) in options:
if option == '--regexp':
criteria.append('%s(%s)' % (predicateName, column))
try:
r = utils.perlReToPythonRe(arg)
except ValueError, e:
irc.error('%r is not a valid regular expression' %
arg)
return
def p(s, r=r):
return int(bool(r.search(s)))
self.db.create_function(predicateName, 1, p)
predicateName += 'p'
for glob in globs.split():
if '?' not in glob and '*' not in glob:
glob = '*%s*' % glob
criteria.append('%s LIKE %%s' % column)
formats.append(glob.translate(self._sqlTrans))
if not criteria:
raise callbacks.ArgumentError
#print 'criteria: %s' % repr(criteria)
#print 'formats: %s' % repr(formats)
sql = """SELECT key, value FROM %s WHERE %s""" % \
(name, ' AND '.join(criteria))
#print 'sql: %s' % sql
cursor.execute(sql, formats)
if cursor.rowcount == 0:
raise dbi.NoRecordError
else:
return cursor.fetchall()
LookupDB = plugins.DB('Lookup',
{'sqlite': SqliteLookupDB,
}
)
2003-09-11 00:22:50 +02:00
2003-10-21 06:32:52 +02:00
class Lookup(callbacks.Privmsg):
2003-12-02 23:40:50 +01:00
def __init__(self):
callbacks.Privmsg.__init__(self)
self.lookupDomains = sets.Set()
try:
self.db = LookupDB()
except Exception:
self.log.exception('Error loading %s:', self.filename)
raise # So it doesn't get loaded without its database.
for (name, value) in registry._cache.iteritems():
name = name.lower()
if name.startswith('supybot.plugins.lookup.lookups.'):
name = name[len('supybot.plugins.lookup.lookups.'):]
if '.' in name:
continue
self.addRegistryValue(name, value)
group = conf.supybot.plugins.Lookup.lookups
for (name, value) in group.getValues(fullNames=False):
name = name.lower() # Just in case.
filename = value()
try:
if not self.db.checkLookup(name):
self.addDatabase(name, filename)
self.addCommand(name)
except Exception, e:
self.log.warning('Couldn\'t add lookup %s: %s', name, e)
2003-12-11 01:25:50 +01:00
def _shrink(self, s):
return utils.ellipsisify(s, 50)
2003-09-11 12:05:24 +02:00
def die(self):
self.db.close()
2003-09-11 12:05:24 +02:00
2003-10-21 06:32:52 +02:00
def remove(self, irc, msg, args):
2003-09-11 00:22:50 +02:00
"""<name>
Removes the lookup for <name>.
"""
name = privmsgs.getArgs(args)
name = callbacks.canonicalName(name)
if name not in self.lookupDomains:
2004-09-17 07:09:14 +02:00
irc.error('That\'s not a valid lookup to remove.')
return
2003-09-11 00:22:50 +02:00
try:
self.db.dropLookup(name)
delattr(self.__class__, name)
self.delRegistryValues(name)
irc.replySuccess()
except dbi.NoRecordError:
irc.error('No such lookup exists.')
remove = privmsgs.checkCapability(remove, 'admin')
_splitRe = re.compile(r'(?<!\\):')
2003-10-21 06:32:52 +02:00
def add(self, irc, msg, args):
"""[--nokey] <name> <filename>
2003-09-11 00:22:50 +02:00
Adds a lookup for <name> with the key/value pairs specified in the
colon-delimited file specified by <filename>. <filename> is searched
2004-01-18 08:58:26 +01:00
for in conf.supybot.directories.data. If <name> is not singular, we
try to make it singular before creating the command. If the --nokey
option is specified, the new lookup will display only the value when
queried, and will omit the key from the response.
2003-09-11 00:22:50 +02:00
"""
opts = ['nokey']
(optlist, rest) = getopt.getopt(args, '', opts)
(name, filename) = privmsgs.getArgs(rest, required=2)
nokey = False
for (option, argument) in optlist:
option = option.lstrip('-')
if option == 'nokey':
nokey = True
#print 'nokey: %s' % nokey
name = utils.depluralize(name)
name = callbacks.canonicalName(name)
if hasattr(self, name):
s = 'I already have a command in this plugin named %s' % name
irc.error(s)
return
if not self.db.checkLookup(name):
2003-09-11 00:22:50 +02:00
try:
self.addDatabase(name, filename)
except EnvironmentError, e:
irc.error('Could not open %s: %s' % (filename, e.args[1]))
2003-09-11 00:22:50 +02:00
return
self.addCommand(name)
self.addRegistryValue(name, filename, nokey)
irc.replySuccess('Lookup %s added.' % name)
add = privmsgs.checkCapability(add, 'admin')
2003-09-11 00:22:50 +02:00
def addRegistryValue(self, name, filename, nokey = False):
group = conf.supybot.plugins.Lookup.lookups
conf.registerGlobalValue(group, name, registry.String(filename, ''))
#print 'nokey: %s' % nokey
conf.registerGlobalValue(group.get(name), 'nokey', registry.Boolean(nokey, ''))
def delRegistryValues(self, name):
group = conf.supybot.plugins.Lookup.lookups
group.unregister(name)
def addDatabase(self, name, filename):
dataDir = conf.supybot.directories.data()
filename = os.path.join(dataDir, filename)
fd = file(filename)
self.db.addLookup(name, fd, self._splitRe)
def addCommand(self, name):
def f(self, irc, msg, args):
args.insert(0, name)
self._lookup(irc, msg, args)
rows = self.db.getRecordCount(name)
2003-12-02 19:37:39 +01:00
docstring = """[<key>]
If <key> is given, looks up <key> in the %s database. Otherwise,
returns a random key: value pair from the database. There are
%s in the database.
""" % (name, utils.nItems(name, rows))
f = utils.changeFunctionName(f, name, docstring)
self.lookupDomains.add(name)
setattr(self.__class__, name, f)
2003-12-11 01:25:50 +01:00
def search(self, irc, msg, args):
"""[--{regexp}=<value>] [--values] <name> <glob>
2003-12-11 01:25:50 +01:00
Searches the domain <name> for lookups matching <glob>. If --regexp
is given, its associated value is taken as a regexp and matched
against the lookups. If --values is given, search the values rather
than the keys.
2003-12-11 01:25:50 +01:00
"""
column = 'key'
while '--values' in args:
column = 'value'
args.remove('--values')
(options, rest) = getopt.getopt(args, '', ['regexp='])
2003-12-11 01:25:50 +01:00
(name, globs) = privmsgs.getArgs(rest, optional=1)
if self.db.checkLookup(name):
try:
results = self.db.searchResults(name, options, globs, column)
lookups = ['%s: %s' % (item[0], self._shrink(item[1]))
for item in results]
irc.reply(utils.commaAndify(lookups))
except dbi.NoRecordError:
irc.reply('No entries in %s matched that query.' % name)
return
else:
irc.reply('I don\'t have a domain %s' % name)
return
def _lookup(self, irc, msg, args):
2003-09-11 00:22:50 +02:00
"""<name> <key>
Looks up the value of <key> in the domain <name>.
"""
(name, key) = privmsgs.getArgs(args, optional=1)
if self.db.checkLookup(name):
results = []
if key:
try:
results = self.db.getResults(name, key)
except dbi.NoRecordError:
irc.error('I couldn\'t find %s in %s.' % (key, name))
return
if len(results) == 1:
irc.reply(results[0][0])
else:
values = [t[0] for t in results]
irc.reply('%s could be %s' % (key, ', or '.join(values)))
2003-09-11 00:22:50 +02:00
else:
(key, value) = self.db.getRandomResult(name, key)
nokeyRegKey = 'lookups.%s.nokey' % name
if not self.registryValue(nokeyRegKey):
irc.reply('%s: %s' % (key, value))
else:
irc.reply('%s' % value)
else:
irc.error('I don\'t have a domain %s' % name)
return
2003-10-21 06:32:52 +02:00
Class = Lookup
2003-09-11 00:22:50 +02:00
# vim:set shiftwidth=4 tabstop=8 expandtab textwidth=78: