synapse/tests/utils.py

481 lines
14 KiB
Python
Raw Normal View History

# -*- coding: utf-8 -*-
# Copyright 2014 OpenMarket Ltd
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
2014-08-12 16:10:52 +02:00
from synapse.http.server import HttpServer
from synapse.api.errors import cs_error, CodeMessageException, StoreError
2014-12-16 12:29:05 +01:00
from synapse.api.constants import EventTypes
from synapse.storage.prepare_database import prepare_database
from synapse.storage.engines import create_engine
from synapse.server import HomeServer
2014-08-12 16:10:52 +02:00
2014-12-10 20:24:12 +01:00
from synapse.util.logcontext import LoggingContext
from twisted.internet import defer, reactor
from twisted.enterprise.adbapi import ConnectionPool
2014-08-12 16:10:52 +02:00
from collections import namedtuple
from mock import patch, Mock
import hashlib
2014-12-12 16:08:29 +01:00
import urllib
2014-08-12 16:10:52 +02:00
import urlparse
from inspect import getcallargs
@defer.inlineCallbacks
def setup_test_homeserver(name="test", datastore=None, config=None, **kargs):
"""Setup a homeserver suitable for running tests against. Keyword arguments
are passed to the Homeserver constructor. If no datastore is supplied a
datastore backed by an in-memory sqlite db will be given to the HS.
"""
if config is None:
config = Mock()
config.signing_key = [MockKey()]
2015-02-11 16:01:15 +01:00
config.event_cache_size = 1
2015-02-19 15:34:32 +01:00
config.disable_registration = False
config.macaroon_secret_key = "not even a little secret"
config.server_name = "server.under.test"
if "clock" not in kargs:
kargs["clock"] = MockClock()
if datastore is None:
db_pool = SQLiteMemoryDbPool()
yield db_pool.prepare()
hs = HomeServer(
name, db_pool=db_pool, config=config,
version_string="Synapse/tests",
database_engine=create_engine("sqlite3"),
**kargs
)
else:
hs = HomeServer(
name, db_pool=None, datastore=datastore, config=config,
version_string="Synapse/tests",
database_engine=create_engine("sqlite3"),
**kargs
)
# bcrypt is far too slow to be doing in unit tests
def swap_out_hash_for_testing(old_build_handlers):
def build_handlers():
handlers = old_build_handlers()
auth_handler = handlers.auth_handler
auth_handler.hash = lambda p: hashlib.md5(p).hexdigest()
auth_handler.validate_hash = lambda p, h: hashlib.md5(p).hexdigest() == h
return handlers
return build_handlers
hs.build_handlers = swap_out_hash_for_testing(hs.build_handlers)
defer.returnValue(hs)
def get_mock_call_args(pattern_func, mock_func):
""" Return the arguments the mock function was called with interpreted
by the pattern functions argument list.
"""
invoked_args, invoked_kargs = mock_func.call_args
return getcallargs(pattern_func, *invoked_args, **invoked_kargs)
2014-08-12 16:10:52 +02:00
# This is a mock /resource/ not an entire server
class MockHttpResource(HttpServer):
2014-08-12 16:10:52 +02:00
def __init__(self, prefix=""):
self.callbacks = [] # 3-tuple of method/pattern/function
self.prefix = prefix
def trigger_get(self, path):
return self.trigger("GET", path, None)
@patch('twisted.web.http.Request')
@defer.inlineCallbacks
def trigger(self, http_method, path, content, mock_request):
""" Fire an HTTP event.
Args:
http_method : The HTTP method
path : The HTTP path
content : The HTTP body
mock_request : Mocked request to pass to the event so it can get
content.
Returns:
A tuple of (code, response)
Raises:
KeyError If no event is found which will handle the path.
"""
path = self.prefix + path
# annoyingly we return a twisted http request which has chained calls
# to get at the http content, hence mock it here.
mock_content = Mock()
config = {'read.return_value': content}
mock_content.configure_mock(**config)
mock_request.content = mock_content
mock_request.method = http_method
mock_request.uri = path
2015-06-12 18:17:29 +02:00
mock_request.getClientIP.return_value = "-"
mock_request.requestHeaders.getRawHeaders.return_value=[
"X-Matrix origin=test,key=,sig="
]
2014-08-12 16:10:52 +02:00
# return the right path if the event requires it
mock_request.path = path
# add in query params to the right place
try:
mock_request.args = urlparse.parse_qs(path.split('?')[1])
mock_request.path = path.split('?')[0]
path = mock_request.path
except:
pass
for (method, pattern, func) in self.callbacks:
if http_method != method:
continue
matcher = pattern.match(path)
if matcher:
try:
2014-12-12 16:08:29 +01:00
args = [
urllib.unquote(u).decode("UTF-8")
for u in matcher.groups()
]
2014-08-12 16:10:52 +02:00
(code, response) = yield func(
mock_request,
2014-12-12 16:08:29 +01:00
*args
2014-08-12 16:10:52 +02:00
)
defer.returnValue((code, response))
except CodeMessageException as e:
defer.returnValue((e.code, cs_error(e.msg)))
raise KeyError("No event can handle %s" % path)
def register_paths(self, method, path_patterns, callback):
for path_pattern in path_patterns:
self.callbacks.append((method, path_pattern, callback))
2014-08-12 16:10:52 +02:00
2014-09-24 18:25:41 +02:00
class MockKey(object):
alg = "mock_alg"
version = "mock_version"
2014-10-16 01:09:48 +02:00
signature = b"\x9a\x87$"
2014-09-24 18:25:41 +02:00
@property
def verify_key(self):
return self
def sign(self, message):
2014-10-16 01:09:48 +02:00
return self
2014-09-24 18:25:41 +02:00
def verify(self, message, sig):
assert sig == b"\x9a\x87$"
class MockClock(object):
now = 1000
2014-12-10 20:24:12 +01:00
def __init__(self):
# list of lists of [absolute_time, callback, expired] in no particular
# order
2014-12-10 20:24:12 +01:00
self.timers = []
def time(self):
return self.now
def time_msec(self):
return self.time() * 1000
2014-12-10 20:24:12 +01:00
def call_later(self, delay, callback):
current_context = LoggingContext.current_context()
def wrapped_callback():
LoggingContext.thread_local.current_context = current_context
callback()
t = [self.now + delay, wrapped_callback, False]
self.timers.append(t)
return t
2014-12-10 20:24:12 +01:00
2015-05-13 17:54:02 +02:00
def looping_call(self, function, interval):
pass
2014-12-10 20:24:12 +01:00
def cancel_call_later(self, timer):
if timer[2]:
raise Exception("Cannot cancel an expired timer")
timer[2] = True
self.timers = [t for t in self.timers if t != timer]
2014-12-10 20:24:12 +01:00
2014-08-13 20:17:30 +02:00
# For unit testing
def advance_time(self, secs):
self.now += secs
2014-12-10 20:24:12 +01:00
timers = self.timers
self.timers = []
for t in timers:
time, callback, expired = t
if expired:
raise Exception("Timer already expired")
2014-12-10 20:24:12 +01:00
if self.now >= time:
t[2] = True
2014-12-10 20:24:12 +01:00
callback()
else:
self.timers.append(t)
2014-12-10 20:24:12 +01:00
2015-11-10 16:51:40 +01:00
def advance_time_msec(self, ms):
self.advance_time(ms / 1000.)
class SQLiteMemoryDbPool(ConnectionPool, object):
def __init__(self):
super(SQLiteMemoryDbPool, self).__init__(
"sqlite3", ":memory:",
cp_min=1,
cp_max=1,
)
def prepare(self):
engine = create_engine("sqlite3")
return self.runWithConnection(
lambda conn: prepare_database(conn, engine)
)
2014-08-12 16:10:52 +02:00
class MemoryDataStore(object):
Room = namedtuple(
"Room",
["room_id", "is_public", "creator"]
)
2014-08-12 16:10:52 +02:00
def __init__(self):
self.tokens_to_users = {}
self.paths_to_content = {}
2014-08-12 16:10:52 +02:00
self.members = {}
self.rooms = {}
self.current_state = {}
self.events = []
2014-08-12 16:10:52 +02:00
class Snapshot(namedtuple("Snapshot", "room_id user_id membership_state")):
def fill_out_prev_events(self, event):
pass
def snapshot_room(self, room_id, user_id, state_type=None, state_key=None):
return self.Snapshot(
room_id, user_id, self.get_room_member(user_id, room_id)
)
2014-08-12 16:10:52 +02:00
def register(self, user_id, token, password_hash):
if user_id in self.tokens_to_users.values():
raise StoreError(400, "User in use.")
self.tokens_to_users[token] = user_id
def get_user_by_access_token(self, token):
2014-08-12 16:10:52 +02:00
try:
return {
"name": self.tokens_to_users[token],
}
2014-08-12 16:10:52 +02:00
except:
raise StoreError(400, "User does not exist.")
def get_room(self, room_id):
try:
return self.rooms[room_id]
except:
return None
def store_room(self, room_id, room_creator_user_id, is_public):
if room_id in self.rooms:
raise StoreError(409, "Conflicting room!")
room = MemoryDataStore.Room(
room_id=room_id,
is_public=is_public,
creator=room_creator_user_id
)
2014-08-12 16:10:52 +02:00
self.rooms[room_id] = room
def get_room_member(self, user_id, room_id):
return self.members.get(room_id, {}).get(user_id)
2014-08-12 16:10:52 +02:00
def get_room_members(self, room_id, membership=None):
if membership:
return [
v for k, v in self.members.get(room_id, {}).items()
if v.membership == membership
]
else:
return self.members.get(room_id, {}).values()
2014-08-12 16:10:52 +02:00
def get_rooms_for_user_where_membership_is(self, user_id, membership_list):
return [
self.members[r].get(user_id) for r in self.members
if user_id in self.members[r] and
self.members[r][user_id].membership in membership_list
]
2014-08-12 16:10:52 +02:00
def get_room_events_stream(self, user_id=None, from_key=None, to_key=None,
2015-11-02 16:31:57 +01:00
limit=0, with_feedback=False):
2014-08-12 16:10:52 +02:00
return ([], from_key) # TODO
def get_joined_hosts_for_room(self, room_id):
return defer.succeed([])
def persist_event(self, event):
2014-12-16 12:29:05 +01:00
if event.type == EventTypes.Member:
room_id = event.room_id
2014-08-26 16:54:25 +02:00
user = event.state_key
membership = event.membership
self.members.setdefault(room_id, {})[user] = event
if hasattr(event, "state_key"):
key = (event.room_id, event.type, event.state_key)
self.current_state[key] = event
self.events.append(event)
def get_current_state(self, room_id, event_type=None, state_key=""):
if event_type:
key = (room_id, event_type, state_key)
2014-08-26 16:54:25 +02:00
if self.current_state.get(key):
return [self.current_state.get(key)]
return None
2014-08-12 16:10:52 +02:00
else:
return [
e for e in self.current_state
if e[0] == room_id
]
2014-08-12 16:10:52 +02:00
def set_presence_state(self, user_localpart, state):
return defer.succeed({"state": 0})
def get_presence_list(self, user_localpart, accepted):
return []
def get_room_events_max_id(self):
return "s0" # TODO (erikj)
2014-09-01 20:57:17 +02:00
def get_send_event_level(self, room_id):
return defer.succeed(0)
def get_power_level(self, room_id, user_id):
return defer.succeed(0)
def get_add_state_level(self, room_id):
return defer.succeed(0)
def get_room_join_rule(self, room_id):
# TODO (erikj): This should be configurable
return defer.succeed("invite")
2014-09-02 12:03:03 +02:00
def get_ops_levels(self, room_id):
2014-09-24 12:17:43 +02:00
return defer.succeed((5, 5, 5))
2014-09-02 12:03:03 +02:00
def insert_client_ip(self, user, access_token, ip, user_agent):
return defer.succeed(None)
2014-09-02 12:03:03 +02:00
2014-09-01 20:57:17 +02:00
def _format_call(args, kwargs):
return ", ".join(
2014-08-26 16:54:25 +02:00
["%r" % (a) for a in args] +
["%s=%r" % (k, v) for k, v in kwargs.items()]
)
class DeferredMockCallable(object):
"""A callable instance that stores a set of pending call expectations and
return values for them. It allows a unit test to assert that the given set
of function calls are eventually made, by awaiting on them to be called.
"""
def __init__(self):
self.expectations = []
self.calls = []
def __call__(self, *args, **kwargs):
self.calls.append((args, kwargs))
if not self.expectations:
raise ValueError("%r has no pending calls to handle call(%s)" % (
self, _format_call(args, kwargs))
)
for (call, result, d) in self.expectations:
if args == call[1] and kwargs == call[2]:
d.callback(None)
return result
failure = AssertionError("Was not expecting call(%s)" %
_format_call(args, kwargs)
)
for _, _, d in self.expectations:
try:
d.errback(failure)
except:
pass
raise failure
def expect_call_and_return(self, call, result):
self.expectations.append((call, result, defer.Deferred()))
@defer.inlineCallbacks
def await_calls(self, timeout=1000):
deferred = defer.DeferredList(
[d for _, _, d in self.expectations],
fireOnOneErrback=True
)
timer = reactor.callLater(
timeout/1000,
deferred.errback,
AssertionError(
"%d pending calls left: %s"% (
len([e for e in self.expectations if not e[2].called]),
[e for e in self.expectations if not e[2].called]
)
)
)
yield deferred
timer.cancel()
self.calls = []
def assert_had_no_calls(self):
if self.calls:
calls = self.calls
self.calls = []
raise AssertionError("Expected not to received any calls, got:\n" +
"\n".join([
"call(%s)" % _format_call(c[0], c[1]) for c in calls
])
)