2005-01-20 00:12:50 +01:00
|
|
|
###
|
|
|
|
# Copyright (c) 2002-2005, Jeremiah Fincher
|
2012-09-01 16:16:48 +02:00
|
|
|
# Copyright (c) 2011, James McCoy
|
2005-01-20 00:12:50 +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 gc
|
|
|
|
import os
|
|
|
|
import re
|
|
|
|
import sys
|
|
|
|
import time
|
|
|
|
import shutil
|
2011-07-03 16:16:19 +02:00
|
|
|
import urllib
|
2005-01-20 00:12:50 +01:00
|
|
|
import unittest
|
2015-08-11 17:13:27 +02:00
|
|
|
import functools
|
2005-01-20 00:12:50 +01:00
|
|
|
import threading
|
|
|
|
|
2013-08-24 11:28:29 +02:00
|
|
|
from . import (callbacks, conf, drivers, httpserver, i18n, ircdb, irclib,
|
2015-08-11 16:50:23 +02:00
|
|
|
ircmsgs, ircutils, log, plugin, registry, utils, world)
|
|
|
|
from .utils import minisix
|
2005-01-20 00:12:50 +01:00
|
|
|
|
2015-08-10 17:55:25 +02:00
|
|
|
if minisix.PY2:
|
|
|
|
from httplib import HTTPConnection
|
|
|
|
from urllib import splithost, splituser
|
|
|
|
from urllib import URLopener
|
|
|
|
else:
|
|
|
|
from http.client import HTTPConnection
|
|
|
|
from urllib.parse import splithost, splituser
|
|
|
|
from urllib.request import URLopener
|
|
|
|
|
2015-08-29 23:02:20 +02:00
|
|
|
class verbosity:
|
|
|
|
NONE = 0
|
|
|
|
EXCEPTIONS = 1
|
|
|
|
MESSAGES = 2
|
|
|
|
|
2011-07-03 16:16:19 +02:00
|
|
|
i18n.import_conf()
|
2005-01-20 00:12:50 +01:00
|
|
|
network = True
|
2017-01-10 22:56:17 +01:00
|
|
|
setuid = True
|
2005-01-20 00:12:50 +01:00
|
|
|
|
2005-01-23 20:42:25 +01:00
|
|
|
# This is the global list of suites that are to be run.
|
|
|
|
suites = []
|
|
|
|
|
2011-08-22 20:07:39 +02:00
|
|
|
timeout = 10
|
|
|
|
|
2005-01-20 00:12:50 +01:00
|
|
|
originalCallbacksGetHelp = callbacks.getHelp
|
2009-08-16 23:17:05 +02:00
|
|
|
lastGetHelp = 'x' * 1000
|
2008-12-22 03:19:37 +01:00
|
|
|
def cachingGetHelp(method, name=None, doc=None):
|
2005-01-20 00:12:50 +01:00
|
|
|
global lastGetHelp
|
2008-12-22 03:19:37 +01:00
|
|
|
lastGetHelp = originalCallbacksGetHelp(method, name, doc)
|
2005-01-20 00:12:50 +01:00
|
|
|
return lastGetHelp
|
|
|
|
callbacks.getHelp = cachingGetHelp
|
|
|
|
|
2019-10-05 12:12:46 +02:00
|
|
|
real_time = time.time
|
|
|
|
mock_time_offset = 0
|
|
|
|
|
|
|
|
def mockTime():
|
|
|
|
"""Wrapper for time.time() that adds an offset, eg. for skipping after a
|
|
|
|
timeout expired."""
|
|
|
|
return real_time() + mock_time_offset
|
|
|
|
|
|
|
|
def timeFastForward(extra_offset):
|
|
|
|
global mock_time_offset
|
|
|
|
mock_time_offset += extra_offset
|
|
|
|
|
|
|
|
def setupMockTime():
|
|
|
|
time.time = mockTime
|
|
|
|
|
|
|
|
def teardownMockTime():
|
|
|
|
time.time = real_time
|
|
|
|
|
2015-08-11 17:13:27 +02:00
|
|
|
def retry(tries=3):
|
|
|
|
assert tries > 0
|
|
|
|
def decorator(f):
|
|
|
|
@functools.wraps(f)
|
|
|
|
def newf(self):
|
|
|
|
try:
|
|
|
|
f(self)
|
|
|
|
except AssertionError as e:
|
|
|
|
first_exception = e
|
|
|
|
for _ in range(1, tries):
|
|
|
|
try:
|
|
|
|
f(self)
|
|
|
|
except AssertionError as e:
|
|
|
|
pass
|
|
|
|
else:
|
|
|
|
break
|
|
|
|
else:
|
|
|
|
# All failed
|
|
|
|
raise first_exception
|
|
|
|
return newf
|
|
|
|
return decorator
|
|
|
|
|
2019-08-15 12:22:43 +02:00
|
|
|
def getTestIrc(name='test'):
|
|
|
|
irc = irclib.Irc(name)
|
2005-01-20 00:12:50 +01:00
|
|
|
# Gotta clear the connect messages (USER, NICK, etc.)
|
|
|
|
while irc.takeMsg():
|
|
|
|
pass
|
|
|
|
return irc
|
|
|
|
|
|
|
|
class TimeoutError(AssertionError):
|
|
|
|
def __str__(self):
|
|
|
|
return '%r timed out' % self.args[0]
|
|
|
|
|
2005-02-15 08:40:03 +01:00
|
|
|
class TestPlugin(callbacks.Plugin):
|
2005-01-20 00:12:50 +01:00
|
|
|
def eval(self, irc, msg, args):
|
|
|
|
"""<text>
|
|
|
|
|
|
|
|
This is the help for eval. Since Owner doesn't have an eval command
|
|
|
|
anymore, we needed to add this so as not to invalidate any of the tests
|
|
|
|
that depended on that eval command.
|
|
|
|
"""
|
|
|
|
try:
|
|
|
|
irc.reply(repr(eval(' '.join(args))))
|
2005-02-15 08:40:03 +01:00
|
|
|
except callbacks.ArgumentError:
|
|
|
|
raise
|
2014-01-20 15:49:15 +01:00
|
|
|
except Exception as e:
|
2005-02-15 14:57:57 +01:00
|
|
|
irc.reply(utils.exnToString(e))
|
2005-01-29 20:16:29 +01:00
|
|
|
# Since we know we don't now need the Irc object, we just give None. This
|
|
|
|
# might break if callbacks.Privmsg ever *requires* the Irc object.
|
|
|
|
TestInstance = TestPlugin(None)
|
2005-01-20 00:12:50 +01:00
|
|
|
conf.registerPlugin('TestPlugin', True, public=False)
|
|
|
|
|
|
|
|
class SupyTestCase(unittest.TestCase):
|
|
|
|
"""This class exists simply for extra logging. It's come in useful in the
|
|
|
|
past."""
|
|
|
|
def setUp(self):
|
|
|
|
log.critical('Beginning test case %s', self.id())
|
|
|
|
threads = [t.getName() for t in threading.enumerate()]
|
2005-02-01 14:43:57 +01:00
|
|
|
log.critical('Threads: %L', threads)
|
2019-10-05 12:12:46 +02:00
|
|
|
setupMockTime()
|
2005-01-20 00:12:50 +01:00
|
|
|
unittest.TestCase.setUp(self)
|
|
|
|
|
|
|
|
def tearDown(self):
|
|
|
|
for irc in world.ircs[:]:
|
|
|
|
irc._reallyDie()
|
2019-10-05 12:12:46 +02:00
|
|
|
teardownMockTime()
|
2005-01-20 00:12:50 +01:00
|
|
|
|
2013-01-05 21:13:36 +01:00
|
|
|
if sys.version_info < (2, 7, 0):
|
2013-01-05 21:16:30 +01:00
|
|
|
def assertIn(self, member, container, msg=None):
|
|
|
|
"""Just like self.assertTrue(a in b), but with a nicer default message."""
|
|
|
|
if member not in container:
|
2013-05-15 18:52:56 +02:00
|
|
|
standardMsg = '%s not found in %s' % (repr(member),
|
|
|
|
repr(container))
|
2013-01-05 21:16:30 +01:00
|
|
|
self.fail(self._formatMessage(msg, standardMsg))
|
|
|
|
|
|
|
|
def assertNotIn(self, member, container, msg=None):
|
|
|
|
"""Just like self.assertTrue(a not in b), but with a nicer default message."""
|
|
|
|
if member in container:
|
2013-05-15 18:52:56 +02:00
|
|
|
standardMsg = '%s unexpectedly found in %s' % (repr(member),
|
|
|
|
repr(container))
|
2013-01-05 21:16:30 +01:00
|
|
|
self.fail(self._formatMessage(msg, standardMsg))
|
|
|
|
|
2013-01-05 21:13:36 +01:00
|
|
|
def assertIs(self, expr1, expr2, msg=None):
|
|
|
|
"""Just like self.assertTrue(a is b), but with a nicer default message."""
|
|
|
|
if expr1 is not expr2:
|
2013-05-15 18:52:56 +02:00
|
|
|
standardMsg = '%s is not %s' % (repr(expr1),
|
|
|
|
repr(expr2))
|
2013-01-05 21:13:36 +01:00
|
|
|
self.fail(self._formatMessage(msg, standardMsg))
|
|
|
|
|
|
|
|
def assertIsNot(self, expr1, expr2, msg=None):
|
|
|
|
"""Just like self.assertTrue(a is not b), but with a nicer default message."""
|
|
|
|
if expr1 is expr2:
|
2013-05-15 18:52:56 +02:00
|
|
|
standardMsg = 'unexpectedly identical: %s' % (repr(expr1),)
|
2013-01-05 21:13:36 +01:00
|
|
|
self.fail(self._formatMessage(msg, standardMsg))
|
|
|
|
|
2005-01-20 00:12:50 +01:00
|
|
|
|
|
|
|
class PluginTestCase(SupyTestCase):
|
2006-05-03 19:34:35 +02:00
|
|
|
"""Subclass this to write a test case for a plugin. See
|
|
|
|
plugins/Plugin/test.py for an example.
|
2005-01-20 00:12:50 +01:00
|
|
|
"""
|
|
|
|
plugins = None
|
|
|
|
cleanConfDir = True
|
|
|
|
cleanDataDir = True
|
|
|
|
config = {}
|
2020-04-11 00:17:16 +02:00
|
|
|
timeout = None
|
2005-01-20 00:12:50 +01:00
|
|
|
def __init__(self, methodName='runTest'):
|
2020-04-11 00:17:16 +02:00
|
|
|
if self.timeout is None:
|
|
|
|
self.timeout = timeout
|
2005-01-20 00:12:50 +01:00
|
|
|
originalRunTest = getattr(self, methodName)
|
|
|
|
def runTest(self):
|
|
|
|
run = True
|
|
|
|
if hasattr(self, 'irc') and self.irc:
|
|
|
|
for cb in self.irc.callbacks:
|
|
|
|
cbModule = sys.modules[cb.__class__.__module__]
|
|
|
|
if hasattr(cbModule, 'deprecated') and cbModule.deprecated:
|
2014-01-20 15:31:09 +01:00
|
|
|
print('')
|
|
|
|
print('Ignored, %s is deprecated.' % cb.name())
|
2005-01-20 00:12:50 +01:00
|
|
|
run = False
|
|
|
|
if run:
|
|
|
|
originalRunTest()
|
2005-05-15 19:17:26 +02:00
|
|
|
runTest = utils.python.changeFunctionName(runTest, methodName)
|
2005-01-20 00:12:50 +01:00
|
|
|
setattr(self.__class__, methodName, runTest)
|
|
|
|
SupyTestCase.__init__(self, methodName=methodName)
|
|
|
|
self.originals = {}
|
|
|
|
|
2011-07-03 16:16:19 +02:00
|
|
|
def setUp(self, nick='test', forceSetup=False):
|
|
|
|
if not forceSetup and \
|
|
|
|
self.__class__ in (PluginTestCase, ChannelPluginTestCase):
|
2005-01-20 00:12:50 +01:00
|
|
|
# Necessary because there's a test in here that shouldn\'t run.
|
|
|
|
return
|
|
|
|
SupyTestCase.setUp(self)
|
|
|
|
# Just in case, let's do this. Too many people forget to call their
|
|
|
|
# super methods.
|
|
|
|
for irc in world.ircs[:]:
|
|
|
|
irc._reallyDie()
|
|
|
|
# Set conf variables appropriately.
|
|
|
|
conf.supybot.reply.whenAddressedBy.chars.setValue('@')
|
|
|
|
conf.supybot.reply.error.detailed.setValue(True)
|
|
|
|
conf.supybot.reply.whenNotCommand.setValue(True)
|
2019-12-15 20:18:09 +01:00
|
|
|
# Choose a random port for tests using the HTTP server
|
|
|
|
conf.supybot.servers.http.port.setValue(0)
|
2005-01-20 00:12:50 +01:00
|
|
|
self.myVerbose = world.myVerbose
|
|
|
|
def rmFiles(dir):
|
|
|
|
for filename in os.listdir(dir):
|
|
|
|
file = os.path.join(dir, filename)
|
|
|
|
if os.path.isfile(file):
|
|
|
|
os.remove(file)
|
|
|
|
else:
|
|
|
|
shutil.rmtree(file)
|
|
|
|
if self.cleanConfDir:
|
|
|
|
rmFiles(conf.supybot.directories.conf())
|
|
|
|
if self.cleanDataDir:
|
|
|
|
rmFiles(conf.supybot.directories.data())
|
|
|
|
ircdb.users.reload()
|
|
|
|
ircdb.ignores.reload()
|
|
|
|
ircdb.channels.reload()
|
|
|
|
if self.plugins is None:
|
2014-01-20 15:43:55 +01:00
|
|
|
raise ValueError('PluginTestCase must have a "plugins" attribute.')
|
2005-01-20 00:12:50 +01:00
|
|
|
self.nick = nick
|
|
|
|
self.prefix = ircutils.joinHostmask(nick, 'user', 'host.domain.tld')
|
|
|
|
self.irc = getTestIrc()
|
|
|
|
MiscModule = plugin.loadPluginModule('Misc')
|
|
|
|
OwnerModule = plugin.loadPluginModule('Owner')
|
|
|
|
ConfigModule = plugin.loadPluginModule('Config')
|
2015-08-31 15:38:35 +02:00
|
|
|
plugin.loadPluginClass(self.irc, MiscModule)
|
|
|
|
plugin.loadPluginClass(self.irc, OwnerModule)
|
|
|
|
plugin.loadPluginClass(self.irc, ConfigModule)
|
2005-01-20 00:12:50 +01:00
|
|
|
if isinstance(self.plugins, str):
|
|
|
|
self.plugins = [self.plugins]
|
|
|
|
else:
|
|
|
|
for name in self.plugins:
|
|
|
|
if name not in ('Owner', 'Misc', 'Config'):
|
|
|
|
module = plugin.loadPluginModule(name,
|
|
|
|
ignoreDeprecation=True)
|
2015-08-31 15:38:35 +02:00
|
|
|
plugin.loadPluginClass(self.irc, module)
|
2005-01-20 00:12:50 +01:00
|
|
|
self.irc.addCallback(TestInstance)
|
2015-08-08 22:20:14 +02:00
|
|
|
for (name, value) in self.config.items():
|
2005-01-20 00:12:50 +01:00
|
|
|
group = conf.supybot
|
|
|
|
parts = registry.split(name)
|
|
|
|
if parts[0] == 'supybot':
|
|
|
|
parts.pop(0)
|
|
|
|
for part in parts:
|
|
|
|
group = group.get(part)
|
|
|
|
self.originals[group] = group()
|
|
|
|
group.setValue(value)
|
|
|
|
|
|
|
|
def tearDown(self):
|
|
|
|
if self.__class__ in (PluginTestCase, ChannelPluginTestCase):
|
|
|
|
# Necessary because there's a test in here that shouldn\'t run.
|
|
|
|
return
|
2015-08-08 22:20:14 +02:00
|
|
|
for (group, original) in self.originals.items():
|
2005-01-20 00:12:50 +01:00
|
|
|
group.setValue(original)
|
|
|
|
ircdb.users.close()
|
|
|
|
ircdb.ignores.close()
|
|
|
|
ircdb.channels.close()
|
|
|
|
SupyTestCase.tearDown(self)
|
|
|
|
self.irc = None
|
|
|
|
gc.collect()
|
|
|
|
|
|
|
|
def _feedMsg(self, query, timeout=None, to=None, frm=None,
|
2015-08-29 23:02:20 +02:00
|
|
|
usePrefixChar=True, expectException=False):
|
2005-01-20 00:12:50 +01:00
|
|
|
if to is None:
|
|
|
|
to = self.irc.nick
|
|
|
|
if frm is None:
|
|
|
|
frm = self.prefix
|
|
|
|
if timeout is None:
|
|
|
|
timeout = self.timeout
|
2015-08-29 23:02:20 +02:00
|
|
|
if self.myVerbose >= verbosity.MESSAGES:
|
2014-01-20 15:31:09 +01:00
|
|
|
print('') # Extra newline, so it's pretty.
|
2005-01-20 00:12:50 +01:00
|
|
|
prefixChars = conf.supybot.reply.whenAddressedBy.chars()
|
|
|
|
if not usePrefixChar and query[0] in prefixChars:
|
|
|
|
query = query[1:]
|
2015-08-09 00:23:03 +02:00
|
|
|
if minisix.PY2:
|
2013-01-05 20:51:36 +01:00
|
|
|
query = query.encode('utf8') # unicode->str
|
2005-01-20 00:12:50 +01:00
|
|
|
msg = ircmsgs.privmsg(to, query, prefix=frm)
|
2015-08-29 23:02:20 +02:00
|
|
|
if self.myVerbose >= verbosity.MESSAGES:
|
2014-01-20 15:31:09 +01:00
|
|
|
print('Feeding: %r' % msg)
|
2015-08-29 23:02:20 +02:00
|
|
|
if not expectException and self.myVerbose >= verbosity.EXCEPTIONS:
|
|
|
|
conf.supybot.log.stdout.setValue(True)
|
2005-01-20 00:12:50 +01:00
|
|
|
self.irc.feedMsg(msg)
|
2019-10-05 12:12:46 +02:00
|
|
|
fed = real_time()
|
2005-01-20 00:12:50 +01:00
|
|
|
response = self.irc.takeMsg()
|
2019-10-05 12:12:46 +02:00
|
|
|
while response is None and real_time() - fed < timeout:
|
2017-01-28 02:46:21 +01:00
|
|
|
time.sleep(0.01) # So it doesn't suck up 100% cpu.
|
2005-01-20 00:12:50 +01:00
|
|
|
drivers.run()
|
|
|
|
response = self.irc.takeMsg()
|
2015-08-29 23:02:20 +02:00
|
|
|
if self.myVerbose >= verbosity.MESSAGES:
|
2014-01-20 15:31:09 +01:00
|
|
|
print('Response: %r' % response)
|
2015-08-29 23:02:20 +02:00
|
|
|
if not expectException and self.myVerbose >= verbosity.EXCEPTIONS:
|
|
|
|
conf.supybot.log.stdout.setValue(False)
|
2005-01-20 00:12:50 +01:00
|
|
|
return response
|
|
|
|
|
|
|
|
def getMsg(self, query, **kwargs):
|
|
|
|
return self._feedMsg(query, **kwargs)
|
|
|
|
|
|
|
|
def feedMsg(self, query, to=None, frm=None):
|
|
|
|
"""Just feeds it a message, that's all."""
|
|
|
|
if to is None:
|
|
|
|
to = self.irc.nick
|
|
|
|
if frm is None:
|
|
|
|
frm = self.prefix
|
|
|
|
self.irc.feedMsg(ircmsgs.privmsg(to, query, prefix=frm))
|
|
|
|
|
|
|
|
# These assertError/assertNoError are somewhat fragile. The proper way to
|
|
|
|
# do them would be to use a proxy for the irc object and intercept .error.
|
|
|
|
# But that would be hard, so I don't bother. When this breaks, it'll get
|
|
|
|
# fixed, but not until then.
|
|
|
|
def assertError(self, query, **kwargs):
|
2015-08-29 23:02:20 +02:00
|
|
|
m = self._feedMsg(query, expectException=True, **kwargs)
|
2005-01-20 00:12:50 +01:00
|
|
|
if m is None:
|
2014-01-20 15:43:55 +01:00
|
|
|
raise TimeoutError(query)
|
2005-01-20 00:12:50 +01:00
|
|
|
if lastGetHelp not in m.args[1]:
|
2020-01-26 11:13:56 +01:00
|
|
|
self.assertTrue(m.args[1].startswith('Error:'),
|
2005-01-20 00:12:50 +01:00
|
|
|
'%r did not error: %s' % (query, m.args[1]))
|
|
|
|
return m
|
|
|
|
|
|
|
|
def assertSnarfError(self, query, **kwargs):
|
|
|
|
return self.assertError(query, usePrefixChar=False, **kwargs)
|
|
|
|
|
|
|
|
def assertNotError(self, query, **kwargs):
|
|
|
|
m = self._feedMsg(query, **kwargs)
|
|
|
|
if m is None:
|
2014-01-20 15:43:55 +01:00
|
|
|
raise TimeoutError(query)
|
2020-01-26 11:13:56 +01:00
|
|
|
self.assertFalse(m.args[1].startswith('Error:'),
|
|
|
|
'%r errored: %s' % (query, m.args[1]))
|
|
|
|
self.assertFalse(lastGetHelp in m.args[1],
|
|
|
|
'%r returned the help string.' % query)
|
2005-01-20 00:12:50 +01:00
|
|
|
return m
|
|
|
|
|
|
|
|
def assertSnarfNotError(self, query, **kwargs):
|
|
|
|
return self.assertNotError(query, usePrefixChar=False, **kwargs)
|
|
|
|
|
|
|
|
def assertHelp(self, query, **kwargs):
|
|
|
|
m = self._feedMsg(query, **kwargs)
|
|
|
|
if m is None:
|
2014-01-20 15:43:55 +01:00
|
|
|
raise TimeoutError(query)
|
2012-08-08 21:41:25 +02:00
|
|
|
msg = m.args[1]
|
|
|
|
if 'more message' in msg:
|
2014-03-02 00:43:58 +01:00
|
|
|
msg = msg[0:-27] # Strip (XXX more messages)
|
2020-01-26 11:13:56 +01:00
|
|
|
self.assertTrue(msg in lastGetHelp,
|
2005-01-20 00:12:50 +01:00
|
|
|
'%s is not the help (%s)' % (m.args[1], lastGetHelp))
|
|
|
|
return m
|
|
|
|
|
2020-04-11 00:17:16 +02:00
|
|
|
def assertNoResponse(self, query, timeout=None, **kwargs):
|
|
|
|
if timeout is None:
|
|
|
|
timeout = 0
|
|
|
|
# timeout=0 does not wait at all for an answer after the command
|
|
|
|
# function finished running. This is fine for non-threaded
|
|
|
|
# plugins because they usually won't answer anything after that;
|
|
|
|
# but not for threaded plugins.
|
|
|
|
# TODO: also detect threaded commands
|
|
|
|
for cb in self.irc.callbacks:
|
|
|
|
if cb.threaded:
|
|
|
|
timeout = self.timeout
|
|
|
|
break
|
2005-01-20 00:12:50 +01:00
|
|
|
m = self._feedMsg(query, timeout=timeout, **kwargs)
|
2020-01-26 11:13:56 +01:00
|
|
|
self.assertFalse(m, 'Unexpected response: %r' % m)
|
2005-01-20 00:12:50 +01:00
|
|
|
return m
|
|
|
|
|
2020-04-11 00:17:16 +02:00
|
|
|
def assertSnarfNoResponse(self, query, timeout=None, **kwargs):
|
2005-01-20 00:12:50 +01:00
|
|
|
return self.assertNoResponse(query, timeout=timeout,
|
|
|
|
usePrefixChar=False, **kwargs)
|
|
|
|
|
|
|
|
def assertResponse(self, query, expectedResponse, **kwargs):
|
|
|
|
m = self._feedMsg(query, **kwargs)
|
|
|
|
if m is None:
|
2014-01-20 15:43:55 +01:00
|
|
|
raise TimeoutError(query)
|
2005-01-20 00:12:50 +01:00
|
|
|
self.assertEqual(m.args[1], expectedResponse,
|
|
|
|
'%r != %r' % (expectedResponse, m.args[1]))
|
|
|
|
return m
|
|
|
|
|
|
|
|
def assertSnarfResponse(self, query, expectedResponse, **kwargs):
|
|
|
|
return self.assertResponse(query, expectedResponse,
|
|
|
|
usePrefixChar=False, **kwargs)
|
|
|
|
|
|
|
|
def assertRegexp(self, query, regexp, flags=re.I, **kwargs):
|
|
|
|
m = self._feedMsg(query, **kwargs)
|
|
|
|
if m is None:
|
2014-01-20 15:43:55 +01:00
|
|
|
raise TimeoutError(query)
|
2020-01-26 11:13:56 +01:00
|
|
|
self.assertTrue(re.search(regexp, m.args[1], flags),
|
2005-01-20 00:12:50 +01:00
|
|
|
'%r does not match %r' % (m.args[1], regexp))
|
|
|
|
return m
|
|
|
|
|
|
|
|
def assertSnarfRegexp(self, query, regexp, flags=re.I, **kwargs):
|
|
|
|
return self.assertRegexp(query, regexp, flags=re.I,
|
|
|
|
usePrefixChar=False, **kwargs)
|
|
|
|
|
|
|
|
def assertNotRegexp(self, query, regexp, flags=re.I, **kwargs):
|
|
|
|
m = self._feedMsg(query, **kwargs)
|
|
|
|
if m is None:
|
2014-01-20 15:43:55 +01:00
|
|
|
raise TimeoutError(query)
|
2020-01-26 11:13:56 +01:00
|
|
|
self.assertTrue(re.search(regexp, m.args[1], flags) is None,
|
2005-01-20 00:12:50 +01:00
|
|
|
'%r matched %r' % (m.args[1], regexp))
|
|
|
|
return m
|
|
|
|
|
|
|
|
def assertSnarfNotRegexp(self, query, regexp, flags=re.I, **kwargs):
|
|
|
|
return self.assertNotRegexp(query, regexp, flags=re.I,
|
|
|
|
usePrefixChar=False, **kwargs)
|
|
|
|
|
|
|
|
def assertAction(self, query, expectedResponse=None, **kwargs):
|
|
|
|
m = self._feedMsg(query, **kwargs)
|
|
|
|
if m is None:
|
2014-01-20 15:43:55 +01:00
|
|
|
raise TimeoutError(query)
|
2020-01-26 11:13:56 +01:00
|
|
|
self.assertTrue(ircmsgs.isAction(m), '%r is not an action.' % m)
|
2005-01-20 00:12:50 +01:00
|
|
|
if expectedResponse is not None:
|
|
|
|
s = ircmsgs.unAction(m)
|
2006-11-13 21:32:45 +01:00
|
|
|
self.assertEqual(s, expectedResponse,
|
|
|
|
'%r != %r' % (s, expectedResponse))
|
2005-01-20 00:12:50 +01:00
|
|
|
return m
|
|
|
|
|
|
|
|
def assertSnarfAction(self, query, expectedResponse=None, **kwargs):
|
|
|
|
return self.assertAction(query, expectedResponse=None,
|
|
|
|
usePrefixChar=False, **kwargs)
|
|
|
|
|
|
|
|
def assertActionRegexp(self, query, regexp, flags=re.I, **kwargs):
|
|
|
|
m = self._feedMsg(query, **kwargs)
|
|
|
|
if m is None:
|
2014-01-20 15:43:55 +01:00
|
|
|
raise TimeoutError(query)
|
2020-01-26 11:13:56 +01:00
|
|
|
self.assertTrue(ircmsgs.isAction(m))
|
2005-01-20 00:12:50 +01:00
|
|
|
s = ircmsgs.unAction(m)
|
2020-01-26 11:13:56 +01:00
|
|
|
self.assertTrue(re.search(regexp, s, flags),
|
2005-01-20 00:12:50 +01:00
|
|
|
'%r does not match %r' % (s, regexp))
|
|
|
|
|
|
|
|
def assertSnarfActionRegexp(self, query, regexp, flags=re.I, **kwargs):
|
|
|
|
return self.assertActionRegexp(query, regexp, flags=re.I,
|
|
|
|
usePrefixChar=False, **kwargs)
|
|
|
|
|
|
|
|
_noTestDoc = ('Admin', 'Channel', 'Config',
|
|
|
|
'Misc', 'Owner', 'User', 'TestPlugin')
|
2011-07-03 16:16:19 +02:00
|
|
|
def TestDocumentation(self):
|
2005-01-20 00:12:50 +01:00
|
|
|
if self.__class__ in (PluginTestCase, ChannelPluginTestCase):
|
|
|
|
return
|
|
|
|
for cb in self.irc.callbacks:
|
|
|
|
name = cb.name()
|
|
|
|
if ((name in self._noTestDoc) and \
|
2005-02-07 07:23:01 +01:00
|
|
|
not name.lower() in self.__class__.__name__.lower()):
|
2005-01-20 00:12:50 +01:00
|
|
|
continue
|
2020-01-26 11:13:56 +01:00
|
|
|
self.assertTrue(sys.modules[cb.__class__.__name__].__doc__,
|
2005-01-20 00:12:50 +01:00
|
|
|
'%s has no module documentation.' % name)
|
2005-02-18 06:17:23 +01:00
|
|
|
if hasattr(cb, 'isCommandMethod'):
|
2005-01-20 00:12:50 +01:00
|
|
|
for attr in dir(cb):
|
2005-02-18 06:17:23 +01:00
|
|
|
if cb.isCommandMethod(attr) and \
|
2005-01-20 00:12:50 +01:00
|
|
|
attr == callbacks.canonicalName(attr):
|
2020-01-26 11:13:56 +01:00
|
|
|
self.assertTrue(getattr(cb, attr, None).__doc__,
|
2005-01-20 00:12:50 +01:00
|
|
|
'%s.%s has no help.' % (name, attr))
|
2011-07-03 16:16:19 +02:00
|
|
|
|
2005-01-20 00:12:50 +01:00
|
|
|
|
|
|
|
|
|
|
|
class ChannelPluginTestCase(PluginTestCase):
|
|
|
|
channel = '#test'
|
2011-07-03 16:16:19 +02:00
|
|
|
def setUp(self, nick='test', forceSetup=False):
|
|
|
|
if not forceSetup and \
|
|
|
|
self.__class__ in (PluginTestCase, ChannelPluginTestCase):
|
2005-01-20 00:12:50 +01:00
|
|
|
return
|
|
|
|
PluginTestCase.setUp(self)
|
|
|
|
self.irc.feedMsg(ircmsgs.join(self.channel, prefix=self.prefix))
|
|
|
|
m = self.irc.takeMsg()
|
2020-01-26 11:13:56 +01:00
|
|
|
self.assertFalse(m is None, 'No message back from joining channel.')
|
2005-01-20 00:12:50 +01:00
|
|
|
self.assertEqual(m.command, 'MODE')
|
2012-12-26 15:37:52 +01:00
|
|
|
m = self.irc.takeMsg()
|
2020-01-26 11:13:56 +01:00
|
|
|
self.assertFalse(m is None, 'No message back from joining channel.')
|
2012-12-26 15:37:52 +01:00
|
|
|
self.assertEqual(m.command, 'MODE')
|
2005-01-20 00:12:50 +01:00
|
|
|
m = self.irc.takeMsg()
|
2020-01-26 11:13:56 +01:00
|
|
|
self.assertFalse(m is None, 'No message back from joining channel.')
|
2005-01-20 00:12:50 +01:00
|
|
|
self.assertEqual(m.command, 'WHO')
|
|
|
|
|
|
|
|
def _feedMsg(self, query, timeout=None, to=None, frm=None, private=False,
|
2015-08-29 23:02:20 +02:00
|
|
|
usePrefixChar=True, expectException=False):
|
2005-01-20 00:12:50 +01:00
|
|
|
if to is None:
|
|
|
|
if private:
|
|
|
|
to = self.irc.nick
|
|
|
|
else:
|
|
|
|
to = self.channel
|
|
|
|
if frm is None:
|
|
|
|
frm = self.prefix
|
|
|
|
if timeout is None:
|
|
|
|
timeout = self.timeout
|
2015-08-29 23:02:20 +02:00
|
|
|
if self.myVerbose >= verbosity.MESSAGES:
|
2014-01-20 15:31:09 +01:00
|
|
|
print('') # Newline, just like PluginTestCase.
|
2005-01-20 00:12:50 +01:00
|
|
|
prefixChars = conf.supybot.reply.whenAddressedBy.chars()
|
|
|
|
if query[0] not in prefixChars and usePrefixChar:
|
|
|
|
query = prefixChars[0] + query
|
2015-08-09 00:23:03 +02:00
|
|
|
if minisix.PY2 and isinstance(query, unicode):
|
2013-01-05 20:51:36 +01:00
|
|
|
query = query.encode('utf8') # unicode->str
|
2015-08-29 23:02:20 +02:00
|
|
|
if not expectException and self.myVerbose >= verbosity.EXCEPTIONS:
|
|
|
|
conf.supybot.log.stdout.setValue(True)
|
2005-01-20 00:12:50 +01:00
|
|
|
msg = ircmsgs.privmsg(to, query, prefix=frm)
|
2015-08-29 23:02:20 +02:00
|
|
|
if self.myVerbose >= verbosity.MESSAGES:
|
2014-01-20 15:31:09 +01:00
|
|
|
print('Feeding: %r' % msg)
|
2005-01-20 00:12:50 +01:00
|
|
|
self.irc.feedMsg(msg)
|
2019-10-05 12:12:46 +02:00
|
|
|
fed = real_time()
|
2005-01-20 00:12:50 +01:00
|
|
|
response = self.irc.takeMsg()
|
2019-10-05 12:12:46 +02:00
|
|
|
while response is None and real_time() - fed < timeout:
|
2005-01-20 00:12:50 +01:00
|
|
|
time.sleep(0.1)
|
|
|
|
drivers.run()
|
|
|
|
response = self.irc.takeMsg()
|
|
|
|
if response is not None:
|
|
|
|
if response.command == 'PRIVMSG':
|
|
|
|
args = list(response.args)
|
|
|
|
# Strip off nick: at beginning of response.
|
|
|
|
if args[1].startswith(self.nick) or \
|
|
|
|
args[1].startswith(ircutils.nickFromHostmask(self.prefix)):
|
|
|
|
try:
|
|
|
|
args[1] = args[1].split(' ', 1)[1]
|
|
|
|
except IndexError:
|
|
|
|
# Odd. We'll skip this.
|
|
|
|
pass
|
|
|
|
ret = ircmsgs.privmsg(*args)
|
|
|
|
else:
|
|
|
|
ret = response
|
|
|
|
else:
|
|
|
|
ret = None
|
2015-08-29 23:02:20 +02:00
|
|
|
if self.myVerbose >= verbosity.MESSAGES:
|
2014-01-20 15:31:09 +01:00
|
|
|
print('Returning: %r' % ret)
|
2015-08-29 23:02:20 +02:00
|
|
|
if not expectException and self.myVerbose >= verbosity.EXCEPTIONS:
|
|
|
|
conf.supybot.log.stdout.setValue(False)
|
2005-01-20 00:12:50 +01:00
|
|
|
return ret
|
|
|
|
|
|
|
|
def feedMsg(self, query, to=None, frm=None, private=False):
|
|
|
|
"""Just feeds it a message, that's all."""
|
|
|
|
if to is None:
|
|
|
|
if private:
|
|
|
|
to = self.irc.nick
|
|
|
|
else:
|
|
|
|
to = self.channel
|
|
|
|
if frm is None:
|
|
|
|
frm = self.prefix
|
|
|
|
self.irc.feedMsg(ircmsgs.privmsg(to, query, prefix=frm))
|
|
|
|
|
2011-07-03 16:16:19 +02:00
|
|
|
class TestRequestHandler(httpserver.SupyHTTPRequestHandler):
|
|
|
|
def __init__(self, rfile, wfile, *args, **kwargs):
|
|
|
|
self._headers_mode = True
|
|
|
|
self.rfile = rfile
|
|
|
|
self.wfile = wfile
|
|
|
|
self.handle_one_request()
|
|
|
|
|
|
|
|
def send_response(self, code):
|
|
|
|
assert self._headers_mode
|
|
|
|
self._response = code
|
|
|
|
def send_headers(self, name, value):
|
|
|
|
assert self._headers_mode
|
|
|
|
self._headers[name] = value
|
|
|
|
def end_headers(self):
|
|
|
|
assert self._headers_mode
|
|
|
|
self._headers_mode = False
|
|
|
|
|
|
|
|
def do_X(self, *args, **kwargs):
|
2013-01-21 20:20:26 +01:00
|
|
|
assert httpserver.http_servers, \
|
2011-07-03 16:16:19 +02:00
|
|
|
'The HTTP server is not started.'
|
2013-01-21 20:20:26 +01:00
|
|
|
self.server = httpserver.http_servers[0]
|
2011-07-03 16:16:19 +02:00
|
|
|
httpserver.SupyHTTPRequestHandler.do_X(self, *args, **kwargs)
|
|
|
|
|
2013-02-01 20:38:01 +01:00
|
|
|
httpserver.http_servers = [httpserver.TestSupyHTTPServer()]
|
|
|
|
|
2014-05-22 12:54:25 +02:00
|
|
|
# Partially stolen from the standard Python library :)
|
2011-07-03 16:16:19 +02:00
|
|
|
def open_http(url, data=None):
|
|
|
|
"""Use HTTP protocol."""
|
|
|
|
user_passwd = None
|
|
|
|
proxy_passwd= None
|
|
|
|
if isinstance(url, str):
|
2015-08-10 17:55:25 +02:00
|
|
|
host, selector = splithost(url)
|
2011-07-03 16:16:19 +02:00
|
|
|
if host:
|
2015-08-10 17:55:25 +02:00
|
|
|
user_passwd, host = splituser(host)
|
2011-07-03 16:16:19 +02:00
|
|
|
host = urllib.unquote(host)
|
|
|
|
realhost = host
|
|
|
|
else:
|
|
|
|
host, selector = url
|
|
|
|
# check whether the proxy contains authorization information
|
2015-08-10 17:55:25 +02:00
|
|
|
proxy_passwd, host = splituser(host)
|
2011-07-03 16:16:19 +02:00
|
|
|
# now we proceed with the url we want to obtain
|
2012-05-02 21:13:09 +02:00
|
|
|
urltype, rest = urllib.splittype(selector)
|
2011-07-03 16:16:19 +02:00
|
|
|
url = rest
|
|
|
|
user_passwd = None
|
|
|
|
if urltype.lower() != 'http':
|
|
|
|
realhost = None
|
|
|
|
else:
|
2015-08-10 17:55:25 +02:00
|
|
|
realhost, rest = splithost(rest)
|
2011-07-03 16:16:19 +02:00
|
|
|
if realhost:
|
2015-08-10 17:55:25 +02:00
|
|
|
user_passwd, realhost = splituser(realhost)
|
2011-07-03 16:16:19 +02:00
|
|
|
if user_passwd:
|
|
|
|
selector = "%s://%s%s" % (urltype, realhost, rest)
|
2012-05-02 21:13:09 +02:00
|
|
|
if urllib.proxy_bypass(realhost):
|
2011-07-03 16:16:19 +02:00
|
|
|
host = realhost
|
|
|
|
|
|
|
|
#print "proxy via http:", host, selector
|
2014-01-20 15:43:55 +01:00
|
|
|
if not host: raise IOError('http error', 'no host given')
|
2011-07-03 16:16:19 +02:00
|
|
|
|
|
|
|
if proxy_passwd:
|
|
|
|
import base64
|
|
|
|
proxy_auth = base64.b64encode(proxy_passwd).strip()
|
|
|
|
else:
|
|
|
|
proxy_auth = None
|
|
|
|
|
|
|
|
if user_passwd:
|
|
|
|
import base64
|
|
|
|
auth = base64.b64encode(user_passwd).strip()
|
|
|
|
else:
|
|
|
|
auth = None
|
2012-08-04 16:32:15 +02:00
|
|
|
c = FakeHTTPConnection(host)
|
2011-07-03 16:16:19 +02:00
|
|
|
if data is not None:
|
2012-08-04 16:32:15 +02:00
|
|
|
c.putrequest('POST', selector)
|
|
|
|
c.putheader('Content-Type', 'application/x-www-form-urlencoded')
|
|
|
|
c.putheader('Content-Length', '%d' % len(data))
|
2011-07-03 16:16:19 +02:00
|
|
|
else:
|
2012-08-04 16:32:15 +02:00
|
|
|
c.putrequest('GET', selector)
|
|
|
|
if proxy_auth: c.putheader('Proxy-Authorization', 'Basic %s' % proxy_auth)
|
|
|
|
if auth: c.putheader('Authorization', 'Basic %s' % auth)
|
|
|
|
if realhost: c.putheader('Host', realhost)
|
2015-08-10 17:55:25 +02:00
|
|
|
for args in URLopener().addheaders: c.putheader(*args)
|
2012-08-04 16:32:15 +02:00
|
|
|
c.endheaders()
|
|
|
|
return c
|
2011-07-03 16:16:19 +02:00
|
|
|
|
2015-08-10 17:55:25 +02:00
|
|
|
class FakeHTTPConnection(HTTPConnection):
|
2011-07-03 16:16:19 +02:00
|
|
|
_data = ''
|
|
|
|
_headers = {}
|
|
|
|
def __init__(self, rfile, wfile):
|
2015-08-10 17:55:25 +02:00
|
|
|
HTTPConnection.__init__(self, 'localhost')
|
2011-07-03 16:16:19 +02:00
|
|
|
self.rfile = rfile
|
|
|
|
self.wfile = wfile
|
|
|
|
def send(self, data):
|
|
|
|
self.wfile.write(data)
|
|
|
|
#def putheader(self, name, value):
|
|
|
|
# self._headers[name] = value
|
|
|
|
#def connect(self, *args, **kwargs):
|
|
|
|
# self.sock = self.wfile
|
|
|
|
#def getresponse(self, *args, **kwargs):
|
|
|
|
# pass
|
|
|
|
|
|
|
|
class HTTPPluginTestCase(PluginTestCase):
|
|
|
|
def setUp(self):
|
|
|
|
PluginTestCase.setUp(self, forceSetup=True)
|
|
|
|
|
|
|
|
def request(self, url, method='GET', read=True, data={}):
|
|
|
|
assert url.startswith('/')
|
2019-10-10 17:27:34 +02:00
|
|
|
wfile = minisix.io.BytesIO()
|
|
|
|
rfile = minisix.io.BytesIO()
|
2011-07-03 16:16:19 +02:00
|
|
|
connection = FakeHTTPConnection(wfile, rfile)
|
|
|
|
connection.putrequest(method, url)
|
|
|
|
connection.endheaders()
|
|
|
|
rfile.seek(0)
|
|
|
|
handler = TestRequestHandler(rfile, wfile)
|
2019-10-10 17:27:34 +02:00
|
|
|
wfile.seek(0)
|
2011-07-03 16:16:19 +02:00
|
|
|
if read:
|
|
|
|
return (handler._response, wfile.read())
|
|
|
|
else:
|
|
|
|
return handler._response
|
|
|
|
|
|
|
|
def assertHTTPResponse(self, uri, expectedResponse, **kwargs):
|
|
|
|
response = self.request(uri, read=False, **kwargs)
|
|
|
|
self.assertEqual(response, expectedResponse)
|
|
|
|
|
2012-05-02 21:14:30 +02:00
|
|
|
def assertNotHTTPResponse(self, uri, expectedResponse, **kwargs):
|
2011-07-03 17:09:53 +02:00
|
|
|
response = self.request(uri, read=False, **kwargs)
|
|
|
|
self.assertNotEqual(response, expectedResponse)
|
|
|
|
|
2011-07-03 16:16:19 +02:00
|
|
|
class ChannelHTTPPluginTestCase(ChannelPluginTestCase, HTTPPluginTestCase):
|
|
|
|
def setUp(self):
|
|
|
|
ChannelPluginTestCase.setUp(self, forceSetup=True)
|
2005-01-20 00:12:50 +01:00
|
|
|
|
2006-02-11 16:52:51 +01:00
|
|
|
# vim:set shiftwidth=4 softtabstop=4 expandtab textwidth=79:
|
2005-01-20 00:12:50 +01:00
|
|
|
|