2005-01-19 14:14:38 +01:00
|
|
|
###
|
2005-01-19 14:33:05 +01:00
|
|
|
# Copyright (c) 2002-2005, Jeremiah Fincher
|
2012-09-01 16:16:48 +02:00
|
|
|
# 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.
|
|
|
|
###
|
|
|
|
|
|
|
|
import os
|
|
|
|
import signal
|
|
|
|
|
|
|
|
import supybot.log as log
|
|
|
|
import supybot.conf as conf
|
|
|
|
import supybot.utils as utils
|
|
|
|
import supybot.world as world
|
|
|
|
import supybot.ircdb as ircdb
|
|
|
|
from supybot.commands import *
|
2005-01-31 16:22:48 +01:00
|
|
|
from supybot.utils.iter import all
|
2005-01-19 14:14:38 +01:00
|
|
|
import supybot.ircutils as ircutils
|
|
|
|
import supybot.registry as registry
|
|
|
|
import supybot.callbacks as callbacks
|
2010-10-16 13:51:27 +02:00
|
|
|
from supybot.i18n import PluginInternationalization, internationalizeDocstring
|
|
|
|
_ = PluginInternationalization('Config')
|
2005-01-19 14:14:38 +01:00
|
|
|
|
|
|
|
###
|
|
|
|
# Now, to setup the registry.
|
|
|
|
###
|
|
|
|
|
|
|
|
def getWrapper(name):
|
|
|
|
parts = registry.split(name)
|
|
|
|
if not parts or parts[0] not in ('supybot', 'users'):
|
2014-01-20 15:43:55 +01:00
|
|
|
raise InvalidRegistryName(name)
|
2005-01-19 14:14:38 +01:00
|
|
|
group = getattr(conf, parts.pop(0))
|
|
|
|
while parts:
|
|
|
|
try:
|
|
|
|
group = group.get(parts.pop(0))
|
|
|
|
# We'll catch registry.InvalidRegistryName and re-raise it here so
|
|
|
|
# that we have a useful error message for the user.
|
|
|
|
except (registry.NonExistentRegistryEntry,
|
|
|
|
registry.InvalidRegistryName):
|
2014-01-20 15:43:55 +01:00
|
|
|
raise registry.InvalidRegistryName(name)
|
2005-01-19 14:14:38 +01:00
|
|
|
return group
|
|
|
|
|
|
|
|
def getCapability(name):
|
|
|
|
capability = 'owner' # Default to requiring the owner capability.
|
|
|
|
parts = registry.split(name)
|
|
|
|
while parts:
|
|
|
|
part = parts.pop()
|
|
|
|
if ircutils.isChannel(part):
|
2009-08-16 23:17:05 +02:00
|
|
|
# If a registry value has a channel in it, it requires a
|
|
|
|
# 'channel,op' capability, or so we assume. We'll see if we're
|
|
|
|
# proven wrong.
|
2005-01-19 14:14:38 +01:00
|
|
|
capability = ircdb.makeChannelCapability(part, 'op')
|
|
|
|
### Do more later, for specific capabilities/sections.
|
|
|
|
return capability
|
|
|
|
|
|
|
|
def _reload():
|
|
|
|
ircdb.users.reload()
|
2005-08-10 13:40:24 +02:00
|
|
|
ircdb.ignores.reload()
|
2005-01-19 14:14:38 +01:00
|
|
|
ircdb.channels.reload()
|
2012-09-07 19:20:09 +02:00
|
|
|
registry.open_registry(world.registryFilename)
|
2005-01-19 14:14:38 +01:00
|
|
|
|
|
|
|
def _hupHandler(sig, frame):
|
|
|
|
log.info('Received SIGHUP, reloading configuration.')
|
|
|
|
_reload()
|
|
|
|
|
|
|
|
if os.name == 'posix':
|
|
|
|
signal.signal(signal.SIGHUP, _hupHandler)
|
|
|
|
|
|
|
|
def getConfigVar(irc, msg, args, state):
|
|
|
|
name = args[0]
|
|
|
|
if name.startswith('conf.'):
|
|
|
|
name = name[5:]
|
|
|
|
if not name.startswith('supybot') and not name.startswith('users'):
|
|
|
|
name = 'supybot.' + name
|
|
|
|
try:
|
|
|
|
group = getWrapper(name)
|
|
|
|
state.args.append(group)
|
|
|
|
del args[0]
|
|
|
|
except registry.InvalidRegistryName, e:
|
2010-12-12 15:03:13 +01:00
|
|
|
state.errorInvalid(_('configuration variable'), str(e))
|
2005-01-19 14:14:38 +01:00
|
|
|
addConverter('configVar', getConfigVar)
|
|
|
|
|
2009-01-28 06:31:36 +01:00
|
|
|
def getSettableConfigVar(irc, msg, args, state):
|
|
|
|
getConfigVar(irc, msg, args, state)
|
|
|
|
if not hasattr(state.args[-1], 'set'):
|
2010-12-12 15:03:13 +01:00
|
|
|
state.errorInvalid(_('settable configuration variable'),
|
2009-01-28 06:31:36 +01:00
|
|
|
state.args[-1]._name)
|
|
|
|
addConverter('settableConfigVar', getSettableConfigVar)
|
|
|
|
|
2005-02-09 08:04:04 +01:00
|
|
|
class Config(callbacks.Plugin):
|
2005-02-17 23:39:44 +01:00
|
|
|
def callCommand(self, command, irc, msg, *args, **kwargs):
|
2005-01-19 14:14:38 +01:00
|
|
|
try:
|
2005-02-17 23:39:44 +01:00
|
|
|
super(Config, self).callCommand(command, irc, msg, *args, **kwargs)
|
2005-01-19 14:14:38 +01:00
|
|
|
except registry.InvalidRegistryValue, e:
|
|
|
|
irc.error(str(e))
|
|
|
|
|
|
|
|
def _list(self, group):
|
|
|
|
L = []
|
|
|
|
for (vname, v) in group._children.iteritems():
|
|
|
|
if hasattr(group, 'channelValue') and group.channelValue and \
|
|
|
|
ircutils.isChannel(vname) and not v._children:
|
|
|
|
continue
|
|
|
|
if hasattr(v, 'channelValue') and v.channelValue:
|
|
|
|
vname = '#' + vname
|
|
|
|
if v._added and not all(ircutils.isChannel, v._added):
|
|
|
|
vname = '@' + vname
|
|
|
|
L.append(vname)
|
2005-02-15 14:57:57 +01:00
|
|
|
utils.sortBy(str.lower, L)
|
2005-01-19 14:14:38 +01:00
|
|
|
return L
|
|
|
|
|
2010-10-16 13:51:27 +02:00
|
|
|
@internationalizeDocstring
|
2005-01-19 14:14:38 +01:00
|
|
|
def list(self, irc, msg, args, group):
|
|
|
|
"""<group>
|
|
|
|
|
|
|
|
Returns the configuration variables available under the given
|
|
|
|
configuration <group>. If a variable has values under it, it is
|
|
|
|
preceded by an '@' sign. If a variable is a 'ChannelValue', that is,
|
|
|
|
it can be separately configured for each channel using the 'channel'
|
|
|
|
command in this plugin, it is preceded by an '#' sign.
|
|
|
|
"""
|
|
|
|
L = self._list(group)
|
|
|
|
if L:
|
2005-01-31 15:52:27 +01:00
|
|
|
irc.reply(format('%L', L))
|
2005-01-19 14:14:38 +01:00
|
|
|
else:
|
2010-10-16 13:51:27 +02:00
|
|
|
irc.error(_('There don\'t seem to be any values in %s.') %
|
|
|
|
group._name)
|
2005-01-19 14:14:38 +01:00
|
|
|
list = wrap(list, ['configVar'])
|
|
|
|
|
2010-10-16 13:51:27 +02:00
|
|
|
@internationalizeDocstring
|
2005-01-19 14:14:38 +01:00
|
|
|
def search(self, irc, msg, args, word):
|
|
|
|
"""<word>
|
|
|
|
|
|
|
|
Searches for <word> in the current configuration variables.
|
|
|
|
"""
|
|
|
|
L = []
|
2010-11-26 23:19:05 +01:00
|
|
|
for (name, x) in conf.supybot.getValues(getChildren=True):
|
2005-01-19 14:14:38 +01:00
|
|
|
if word in name.lower():
|
|
|
|
possibleChannel = registry.split(name)[-1]
|
|
|
|
if not ircutils.isChannel(possibleChannel):
|
|
|
|
L.append(name)
|
|
|
|
if L:
|
2005-01-31 15:52:27 +01:00
|
|
|
irc.reply(format('%L', L))
|
2005-01-19 14:14:38 +01:00
|
|
|
else:
|
2010-10-16 13:51:27 +02:00
|
|
|
irc.reply(_('There were no matching configuration variables.'))
|
2005-01-19 14:14:38 +01:00
|
|
|
search = wrap(search, ['lowered']) # XXX compose with withoutSpaces?
|
|
|
|
|
2009-03-18 19:41:02 +01:00
|
|
|
def _getValue(self, irc, msg, group, addChannel=False):
|
2005-01-19 14:14:38 +01:00
|
|
|
value = str(group) or ' '
|
2009-03-18 19:41:02 +01:00
|
|
|
if addChannel and irc.isChannel(msg.args[0]) and not irc.nested:
|
|
|
|
s = str(group.get(msg.args[0]))
|
2010-10-16 13:51:27 +02:00
|
|
|
value = _('Global: %s; %s: %s') % (value, msg.args[0], s)
|
2005-01-19 14:14:38 +01:00
|
|
|
if hasattr(group, 'value'):
|
|
|
|
if not group._private:
|
|
|
|
irc.reply(value)
|
|
|
|
else:
|
|
|
|
capability = getCapability(group._name)
|
|
|
|
if ircdb.checkCapability(msg.prefix, capability):
|
|
|
|
irc.reply(value, private=True)
|
|
|
|
else:
|
|
|
|
irc.errorNoCapability(capability)
|
|
|
|
else:
|
2010-10-16 13:51:27 +02:00
|
|
|
irc.error(_('That registry variable has no value. Use the list '
|
2005-01-19 14:14:38 +01:00
|
|
|
'command in this plugin to see what variables are '
|
2010-10-16 13:51:27 +02:00
|
|
|
'available in this group.'))
|
2005-01-19 14:14:38 +01:00
|
|
|
|
|
|
|
def _setValue(self, irc, msg, group, value):
|
|
|
|
capability = getCapability(group._name)
|
|
|
|
if ircdb.checkCapability(msg.prefix, capability):
|
|
|
|
# I think callCommand catches exceptions here. Should it?
|
|
|
|
group.set(value)
|
|
|
|
irc.replySuccess()
|
|
|
|
else:
|
|
|
|
irc.errorNoCapability(capability)
|
2005-08-10 13:40:24 +02:00
|
|
|
|
2010-10-16 13:51:27 +02:00
|
|
|
@internationalizeDocstring
|
2005-01-19 14:14:38 +01:00
|
|
|
def channel(self, irc, msg, args, channel, group, value):
|
|
|
|
"""[<channel>] <name> [<value>]
|
|
|
|
|
|
|
|
If <value> is given, sets the channel configuration variable for <name>
|
|
|
|
to <value> for <channel>. Otherwise, returns the current channel
|
|
|
|
configuration value of <name>. <channel> is only necessary if the
|
|
|
|
message isn't sent in the channel itself."""
|
|
|
|
if not group.channelValue:
|
2010-10-16 13:51:27 +02:00
|
|
|
irc.error(_('That configuration variable is not a channel-specific '
|
|
|
|
'configuration variable.'))
|
2005-01-19 14:14:38 +01:00
|
|
|
return
|
|
|
|
group = group.get(channel)
|
|
|
|
if value is not None:
|
|
|
|
self._setValue(irc, msg, group, value)
|
|
|
|
else:
|
|
|
|
self._getValue(irc, msg, group)
|
2009-01-28 06:31:36 +01:00
|
|
|
channel = wrap(channel, ['channel', 'settableConfigVar',
|
|
|
|
additional('text')])
|
2005-01-19 14:14:38 +01:00
|
|
|
|
2010-10-16 13:51:27 +02:00
|
|
|
@internationalizeDocstring
|
2005-01-19 14:14:38 +01:00
|
|
|
def config(self, irc, msg, args, group, value):
|
|
|
|
"""<name> [<value>]
|
|
|
|
|
|
|
|
If <value> is given, sets the value of <name> to <value>. Otherwise,
|
|
|
|
returns the current value of <name>. You may omit the leading
|
|
|
|
"supybot." in the name if you so choose.
|
|
|
|
"""
|
|
|
|
if value is not None:
|
|
|
|
self._setValue(irc, msg, group, value)
|
|
|
|
else:
|
2009-03-18 19:41:02 +01:00
|
|
|
self._getValue(irc, msg, group, addChannel=group.channelValue)
|
2009-01-28 06:31:36 +01:00
|
|
|
config = wrap(config, ['settableConfigVar', additional('text')])
|
2005-01-19 14:14:38 +01:00
|
|
|
|
2010-10-16 13:51:27 +02:00
|
|
|
@internationalizeDocstring
|
2005-01-19 14:14:38 +01:00
|
|
|
def help(self, irc, msg, args, group):
|
|
|
|
"""<name>
|
|
|
|
|
|
|
|
Returns the description of the configuration variable <name>.
|
|
|
|
"""
|
|
|
|
if hasattr(group, '_help'):
|
|
|
|
s = group.help()
|
|
|
|
if s:
|
|
|
|
if hasattr(group, 'value') and not group._private:
|
2010-10-16 13:51:27 +02:00
|
|
|
s += _(' (Current value: %s)') % group
|
2005-01-19 14:14:38 +01:00
|
|
|
irc.reply(s)
|
|
|
|
else:
|
2010-10-16 13:51:27 +02:00
|
|
|
irc.reply(_('That configuration group exists, but seems to '
|
|
|
|
'have no help. Try "config list %s" to see if it '
|
|
|
|
'has any children values.') % group._name)
|
2005-01-19 14:14:38 +01:00
|
|
|
else:
|
2010-10-16 13:51:27 +02:00
|
|
|
irc.error(_('%s has no help.') % group._name)
|
2005-01-19 14:14:38 +01:00
|
|
|
help = wrap(help, ['configVar'])
|
|
|
|
|
2010-10-16 13:51:27 +02:00
|
|
|
@internationalizeDocstring
|
2005-01-19 14:14:38 +01:00
|
|
|
def default(self, irc, msg, args, group):
|
|
|
|
"""<name>
|
|
|
|
|
|
|
|
Returns the default value of the configuration variable <name>.
|
|
|
|
"""
|
|
|
|
v = group.__class__(group._default, '')
|
|
|
|
irc.reply(str(v))
|
2009-01-28 06:31:36 +01:00
|
|
|
default = wrap(default, ['settableConfigVar'])
|
2005-01-19 14:14:38 +01:00
|
|
|
|
2010-10-16 13:51:27 +02:00
|
|
|
@internationalizeDocstring
|
2005-01-19 14:14:38 +01:00
|
|
|
def reload(self, irc, msg, args):
|
|
|
|
"""takes no arguments
|
|
|
|
|
|
|
|
Reloads the various configuration files (user database, channel
|
|
|
|
database, registry, etc.).
|
|
|
|
"""
|
|
|
|
_reload() # This was factored out for SIGHUP handling.
|
|
|
|
irc.replySuccess()
|
|
|
|
reload = wrap(reload, [('checkCapability', 'owner')])
|
|
|
|
|
2010-10-16 13:51:27 +02:00
|
|
|
@internationalizeDocstring
|
2005-01-19 14:14:38 +01:00
|
|
|
def export(self, irc, msg, args, filename):
|
|
|
|
"""<filename>
|
|
|
|
|
|
|
|
Exports the public variables of your configuration to <filename>.
|
|
|
|
If you want to show someone your configuration file, but you don't
|
|
|
|
want that person to be able to see things like passwords, etc., this
|
|
|
|
command will export a "sanitized" configuration file suitable for
|
|
|
|
showing publicly.
|
|
|
|
"""
|
|
|
|
registry.close(conf.supybot, filename, private=False)
|
|
|
|
irc.replySuccess()
|
|
|
|
export = wrap(export, [('checkCapability', 'owner'), 'filename'])
|
|
|
|
|
2012-11-07 05:20:03 +01:00
|
|
|
@internationalizeDocstring
|
2012-11-09 23:32:01 +01:00
|
|
|
def setdefault(self, irc, msg, args, group):
|
2012-11-07 05:20:03 +01:00
|
|
|
"""<name>
|
|
|
|
|
|
|
|
Resets the configuration variable <name> to its default value.
|
|
|
|
"""
|
|
|
|
v = str(group.__class__(group._default, ''))
|
|
|
|
self._setValue(irc, msg, group, v)
|
2012-11-09 23:40:10 +01:00
|
|
|
setdefault = wrap(setdefault, ['settableConfigVar'])
|
2005-01-19 14:14:38 +01:00
|
|
|
|
|
|
|
Class = Config
|
|
|
|
|
2006-02-11 16:52:51 +01:00
|
|
|
# vim:set shiftwidth=4 softtabstop=4 expandtab textwidth=79:
|