synapse/tests/utils.py

679 lines
21 KiB
Python
Raw Normal View History

# -*- coding: utf-8 -*-
2016-01-07 05:26:29 +01:00
# Copyright 2014-2016 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.
2018-08-13 08:47:46 +02:00
import atexit
import hashlib
2018-08-13 08:47:46 +02:00
import os
import time
2018-08-13 08:47:46 +02:00
import uuid
import warnings
from inspect import getcallargs
2014-08-12 16:10:52 +02:00
from mock import Mock, patch
2018-07-09 08:09:20 +02:00
from six.moves.urllib import parse as urlparse
from twisted.internet import defer, reactor
2019-01-24 10:28:16 +01:00
from synapse.api.constants import EventTypes, RoomVersions
from synapse.api.errors import CodeMessageException, cs_error
from synapse.config.server import ServerConfig
from synapse.federation.transport import server as federation_server
from synapse.http.server import HttpServer
from synapse.server import HomeServer
2018-09-03 18:21:48 +02:00
from synapse.storage import DataStore
from synapse.storage.engines import PostgresEngine, create_engine
2018-08-13 08:47:46 +02:00
from synapse.storage.prepare_database import (
_get_or_create_schema_state,
_setup_new_database,
prepare_database,
)
from synapse.util.logcontext import LoggingContext
from synapse.util.ratelimitutils import FederationRateLimiter
# set this to True to run the tests against postgres instead of sqlite.
2018-08-13 08:47:46 +02:00
USE_POSTGRES_FOR_TESTS = os.environ.get("SYNAPSE_POSTGRES", False)
2018-09-03 18:21:48 +02:00
LEAVE_DB = os.environ.get("SYNAPSE_LEAVE_DB", False)
POSTGRES_USER = os.environ.get("SYNAPSE_POSTGRES_USER", None)
POSTGRES_HOST = os.environ.get("SYNAPSE_POSTGRES_HOST", None)
POSTGRES_PASSWORD = os.environ.get("SYNAPSE_POSTGRES_PASSWORD", None)
2018-08-13 08:47:46 +02:00
POSTGRES_BASE_DB = "_synapse_unit_tests_base_%s" % (os.getpid(),)
def setupdb():
# If we're using PostgreSQL, set up the db once
if USE_POSTGRES_FOR_TESTS:
pgconfig = {
"name": "psycopg2",
"args": {
"database": POSTGRES_BASE_DB,
"user": POSTGRES_USER,
"host": POSTGRES_HOST,
"password": POSTGRES_PASSWORD,
2018-08-13 08:47:46 +02:00
"cp_min": 1,
"cp_max": 5,
},
}
config = Mock()
config.password_providers = []
config.database_config = pgconfig
db_engine = create_engine(pgconfig)
db_conn = db_engine.module.connect(
user=POSTGRES_USER, host=POSTGRES_HOST, password=POSTGRES_PASSWORD
)
2018-08-13 08:47:46 +02:00
db_conn.autocommit = True
cur = db_conn.cursor()
cur.execute("DROP DATABASE IF EXISTS %s;" % (POSTGRES_BASE_DB,))
cur.execute("CREATE DATABASE %s;" % (POSTGRES_BASE_DB,))
cur.close()
db_conn.close()
# Set up in the db
db_conn = db_engine.module.connect(
database=POSTGRES_BASE_DB,
user=POSTGRES_USER,
host=POSTGRES_HOST,
password=POSTGRES_PASSWORD,
2018-08-13 08:47:46 +02:00
)
cur = db_conn.cursor()
_get_or_create_schema_state(cur, db_engine)
_setup_new_database(cur, db_engine)
db_conn.commit()
cur.close()
db_conn.close()
def _cleanup():
db_conn = db_engine.module.connect(
user=POSTGRES_USER, host=POSTGRES_HOST, password=POSTGRES_PASSWORD
)
2018-08-13 08:47:46 +02:00
db_conn.autocommit = True
cur = db_conn.cursor()
cur.execute("DROP DATABASE IF EXISTS %s;" % (POSTGRES_BASE_DB,))
cur.close()
db_conn.close()
atexit.register(_cleanup)
2018-10-01 16:11:58 +02:00
def default_config(name):
"""
Create a reasonable test config.
"""
config = Mock()
config.signing_key = [MockKey()]
config.event_cache_size = 1
config.enable_registration = True
config.macaroon_secret_key = "not even a little secret"
config.expire_access_token = False
config.server_name = name
config.trusted_third_party_id_servers = []
config.room_invite_state_types = []
config.password_providers = []
config.worker_replication_url = ""
config.worker_app = None
config.email_enable_notifs = False
config.block_non_admin_invites = False
config.federation_domain_whitelist = None
config.federation_rc_reject_limit = 10
config.federation_rc_sleep_limit = 10
config.federation_rc_sleep_delay = 100
config.federation_rc_concurrent = 10
config.filter_timeline_limit = 5000
config.user_directory_search_all_users = False
config.user_consent_server_notice_content = None
config.block_events_without_consent_error = None
config.user_consent_at_registration = False
config.user_consent_policy_name = "Privacy Policy"
2018-10-01 16:11:58 +02:00
config.media_storage_providers = []
config.autocreate_auto_join_rooms = True
2018-10-01 16:11:58 +02:00
config.auto_join_rooms = []
config.limit_usage_by_mau = False
config.hs_disabled = False
config.hs_disabled_message = ""
config.hs_disabled_limit_type = ""
config.max_mau_value = 50
config.mau_trial_days = 0
config.mau_stats_only = False
2018-10-01 16:11:58 +02:00
config.mau_limits_reserved_threepids = []
config.admin_contact = None
config.rc_messages_per_second = 10000
config.rc_message_burst_count = 10000
config.rc_registration_request_burst_count = 3.0
config.rc_registration_requests_per_second = 0.17
config.saml2_enabled = False
config.public_baseurl = None
config.default_identity_server = None
2019-02-27 15:24:45 +01:00
config.key_refresh_interval = 24 * 60 * 60 * 1000
config.old_signing_keys = {}
config.tls_fingerprints = []
config.use_frozen_dicts = False
2018-10-01 16:11:58 +02:00
# we need a sane default_room_version, otherwise attempts to create rooms will
# fail.
config.default_room_version = "1"
# disable user directory updates, because they get done in the
# background, which upsets the test runner.
config.update_user_directory = False
def is_threepid_reserved(threepid):
return ServerConfig.is_threepid_reserved(
config.mau_limits_reserved_threepids, threepid
)
2018-10-01 16:11:58 +02:00
config.is_threepid_reserved.side_effect = is_threepid_reserved
return config
2018-08-28 18:21:05 +02:00
class TestHomeServer(HomeServer):
DATASTORE_CLASS = DataStore
@defer.inlineCallbacks
2018-08-10 15:54:09 +02:00
def setup_test_homeserver(
2018-09-06 18:58:18 +02:00
cleanup_func,
name="test",
datastore=None,
config=None,
reactor=None,
homeserverToUse=TestHomeServer,
**kargs
2018-08-10 15:54:09 +02:00
):
2018-08-13 08:47:46 +02:00
"""
Setup a homeserver suitable for running tests against. Keyword arguments
are passed to the Homeserver constructor.
If no datastore is supplied, one is created and given to the homeserver.
Args:
cleanup_func : The function used to register a cleanup routine for
after the test.
Calling this method directly is deprecated: you should instead derive from
HomeserverTestCase.
"""
if reactor is None:
from twisted.internet import reactor
if config is None:
2018-10-01 16:11:58 +02:00
config = default_config(name)
config.ldap_enabled = False
2016-02-11 15:10:00 +01:00
if "clock" not in kargs:
kargs["clock"] = MockClock()
if USE_POSTGRES_FOR_TESTS:
2018-08-13 08:47:46 +02:00
test_db = "synapse_test_%s" % uuid.uuid4().hex
config.database_config = {
"name": "psycopg2",
"args": {
"database": test_db,
"host": POSTGRES_HOST,
"password": POSTGRES_PASSWORD,
"user": POSTGRES_USER,
"cp_min": 1,
"cp_max": 5,
},
}
else:
config.database_config = {
"name": "sqlite3",
2018-08-10 15:54:09 +02:00
"args": {"database": ":memory:", "cp_min": 1, "cp_max": 1},
}
db_engine = create_engine(config.database_config)
2018-08-13 08:47:46 +02:00
# Create the database before we actually try and connect to it, based off
# the template database we generate in setupdb()
if datastore is None and isinstance(db_engine, PostgresEngine):
db_conn = db_engine.module.connect(
database=POSTGRES_BASE_DB,
user=POSTGRES_USER,
host=POSTGRES_HOST,
password=POSTGRES_PASSWORD,
2018-08-13 08:47:46 +02:00
)
db_conn.autocommit = True
cur = db_conn.cursor()
cur.execute("DROP DATABASE IF EXISTS %s;" % (test_db,))
cur.execute(
"CREATE DATABASE %s WITH TEMPLATE %s;" % (test_db, POSTGRES_BASE_DB)
)
cur.close()
db_conn.close()
# we need to configure the connection pool to run the on_new_connection
# function, so that we can test code that uses custom sqlite functions
# (like rank).
config.database_config["args"]["cp_openfun"] = db_engine.on_new_connection
if datastore is None:
hs = homeserverToUse(
2018-08-10 15:54:09 +02:00
name,
config=config,
db_config=config.database_config,
version_string="Synapse/tests",
database_engine=db_engine,
room_list_handler=object(),
2016-11-21 12:53:02 +01:00
tls_server_context_factory=Mock(),
2018-06-24 22:38:43 +02:00
tls_client_options_factory=Mock(),
reactor=reactor,
**kargs
)
2018-08-13 08:47:46 +02:00
# Prepare the DB on SQLite -- PostgreSQL is a copy of an already up to
# date db
if not isinstance(db_engine, PostgresEngine):
db_conn = hs.get_db_conn()
yield prepare_database(db_conn, db_engine, config)
db_conn.commit()
db_conn.close()
else:
# We need to do cleanup on PostgreSQL
def cleanup():
import psycopg2
2018-08-13 08:47:46 +02:00
# Close all the db pools
hs.get_db_pool().close()
dropped = False
2018-08-13 08:47:46 +02:00
# Drop the test database
db_conn = db_engine.module.connect(
database=POSTGRES_BASE_DB,
user=POSTGRES_USER,
host=POSTGRES_HOST,
password=POSTGRES_PASSWORD,
2018-08-13 08:47:46 +02:00
)
db_conn.autocommit = True
cur = db_conn.cursor()
# Try a few times to drop the DB. Some things may hold on to the
# database for a few more seconds due to flakiness, preventing
# us from dropping it when the test is over. If we can't drop
# it, warn and move on.
for x in range(5):
try:
cur.execute("DROP DATABASE IF EXISTS %s;" % (test_db,))
db_conn.commit()
dropped = True
except psycopg2.OperationalError as e:
warnings.warn(
"Couldn't drop old db: " + str(e), category=UserWarning
)
time.sleep(0.5)
2018-08-13 08:47:46 +02:00
cur.close()
db_conn.close()
if not dropped:
warnings.warn("Failed to drop old DB.", category=UserWarning)
2018-09-03 18:21:48 +02:00
if not LEAVE_DB:
# Register the cleanup hook
cleanup_func(cleanup)
2018-08-13 08:47:46 +02:00
2016-01-27 18:25:07 +01:00
hs.setup()
else:
hs = homeserverToUse(
2018-08-10 15:54:09 +02:00
name,
db_pool=None,
datastore=datastore,
config=config,
version_string="Synapse/tests",
database_engine=db_engine,
room_list_handler=object(),
2016-11-21 12:53:02 +01:00
tls_server_context_factory=Mock(),
2018-06-24 22:38:43 +02:00
tls_client_options_factory=Mock(),
reactor=reactor,
**kargs
)
# bcrypt is far too slow to be doing in unit tests
2016-06-02 14:31:45 +02:00
# Need to let the HS build an auth handler and then mess with it
# because AuthHandler's constructor requires the HS, so we can't make one
# beforehand and pass it in to the HS's constructor (chicken / egg)
2018-08-09 04:22:01 +02:00
hs.get_auth_handler().hash = lambda p: hashlib.md5(p.encode('utf8')).hexdigest()
2018-08-10 15:54:09 +02:00
hs.get_auth_handler().validate_hash = (
lambda p, h: hashlib.md5(p.encode('utf8')).hexdigest() == h
)
2016-01-26 14:52:29 +01:00
fed = kargs.get("resource_for_federation", None)
if fed:
register_federation_servlets(hs, fed)
2016-01-26 14:52:29 +01:00
defer.returnValue(hs)
def register_federation_servlets(hs, resource):
federation_server.register_servlets(
hs,
resource=resource,
authenticator=federation_server.Authenticator(hs),
ratelimiter=FederationRateLimiter(
hs.get_clock(),
window_size=hs.config.federation_rc_window_size,
sleep_limit=hs.config.federation_rc_sleep_limit,
sleep_msec=hs.config.federation_rc_sleep_delay,
reject_limit=hs.config.federation_rc_reject_limit,
concurrent_requests=hs.config.federation_rc_concurrent,
),
)
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
2016-09-12 11:46:02 +02:00
def mock_getRawHeaders(headers=None):
headers = headers if headers is not None else {}
def getRawHeaders(name, default=None):
return headers.get(name, default)
return getRawHeaders
# 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(b"GET", path, None)
2014-08-12 16:10:52 +02:00
@patch('twisted.web.http.Request')
@defer.inlineCallbacks
def trigger(
2018-09-06 18:58:18 +02:00
self, http_method, path, content, mock_request, federation_auth_origin=None
):
2014-08-12 16:10:52 +02:00
""" 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.
federation_auth_origin (bytes|None): domain to authenticate as, for federation
2014-08-12 16:10:52 +02:00
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
2018-08-09 04:22:01 +02:00
mock_request.method = http_method.encode('ascii')
mock_request.uri = path.encode('ascii')
2015-06-12 18:17:29 +02:00
mock_request.getClientIP.return_value = "-"
2016-09-12 11:46:02 +02:00
headers = {}
if federation_auth_origin is not None:
headers[b"Authorization"] = [
2018-09-06 18:58:18 +02:00
b"X-Matrix origin=%s,key=,sig=" % (federation_auth_origin,)
]
2016-09-12 11:46:02 +02:00
mock_request.requestHeaders.getRawHeaders = mock_getRawHeaders(headers)
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 Exception:
2014-08-12 16:10:52 +02:00
pass
if isinstance(path, bytes):
path = path.decode('utf8')
2014-08-12 16:10:52 +02:00
for (method, pattern, func) in self.callbacks:
if http_method != method:
continue
matcher = pattern.match(path)
if matcher:
try:
2018-08-10 15:54:09 +02:00
args = [urlparse.unquote(u) for u in matcher.groups()]
(code, response) = yield func(mock_request, *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, code=e.errcode)))
2014-08-12 16:10:52 +02:00
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$"
2019-02-27 15:24:45 +01:00
def encode(self):
return b"<fake_encoded_key>"
2014-09-24 18:25:41 +02:00
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 = []
2016-09-23 14:56:14 +02:00
self.loopers = []
2014-12-10 20:24:12 +01:00
def time(self):
return self.now
def time_msec(self):
return self.time() * 1000
2016-02-15 18:10:40 +01:00
def call_later(self, delay, callback, *args, **kwargs):
2014-12-10 20:24:12 +01:00
current_context = LoggingContext.current_context()
def wrapped_callback():
LoggingContext.thread_local.current_context = current_context
2016-02-15 18:10:40 +01:00
callback(*args, **kwargs)
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):
self.loopers.append([function, interval / 1000.0, self.now])
2015-05-13 17:54:02 +02:00
def cancel_call_later(self, timer, ignore_errs=False):
if timer[2]:
if not ignore_errs:
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
2016-09-23 14:56:14 +02:00
for looped in self.loopers:
func, interval, last = looped
if last + interval < self.now:
func()
looped[2] = self.now
2015-11-10 16:51:40 +01:00
def advance_time_msec(self, ms):
self.advance_time(ms / 1000.0)
2015-11-10 16:51:40 +01:00
2016-12-09 17:48:48 +01:00
def time_bound_deferred(self, d, *args, **kwargs):
# We don't bother timing things out for now.
return d
def _format_call(args, kwargs):
return ", ".join(
2018-08-10 15:54:09 +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:
2018-08-10 15:54:09 +02:00
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
2018-08-10 15:54:09 +02:00
failure = AssertionError(
"Was not expecting call(%s)" % (_format_call(args, kwargs))
)
for _, _, d in self.expectations:
try:
d.errback(failure)
except Exception:
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(
2018-08-10 15:54:09 +02:00
[d for _, _, d in self.expectations], fireOnOneErrback=True
)
timer = reactor.callLater(
2016-02-19 16:34:38 +01:00
timeout / 1000,
deferred.errback,
2018-08-10 15:54:09 +02:00
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 = []
2016-02-19 16:34:38 +01:00
raise AssertionError(
2018-08-10 15:54:09 +02:00
"Expected not to received any calls, got:\n"
+ "\n".join(["call(%s)" % _format_call(c[0], c[1]) for c in calls])
)
2018-08-09 15:33:49 +02:00
@defer.inlineCallbacks
def create_room(hs, room_id, creator_id):
"""Creates and persist a creation event for the given room
Args:
hs
room_id (str)
creator_id (str)
"""
store = hs.get_datastore()
event_builder_factory = hs.get_event_builder_factory()
event_creation_handler = hs.get_event_creation_handler()
2018-09-06 18:58:18 +02:00
builder = event_builder_factory.new(
2019-01-24 10:28:16 +01:00
RoomVersions.V1,
2018-09-06 18:58:18 +02:00
{
"type": EventTypes.Create,
"state_key": "",
"sender": creator_id,
"room_id": room_id,
"content": {},
},
2018-08-09 15:33:49 +02:00
)
2018-09-06 18:58:18 +02:00
event, context = yield event_creation_handler.create_new_client_event(builder)
2018-08-09 15:33:49 +02:00
yield store.persist_event(event, context)