blob: 744f9274d1b0649baa71227bff67ec66a585e420 [file] [log] [blame]
# Copyright (c) 2019 AT&T Intellectual Property.
# Copyright (c) 2018-2022 Nokia.
#
# 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.
#
# This source code is part of the near-RT RIC (RAN Intelligent Controller)
# platform project (RICP).
#
from unittest.mock import patch, Mock, MagicMock, call, ANY
import pytest
from redis import exceptions as redis_exceptions
import ricsdl.backend
from ricsdl.backend.redis import (RedisBackendLock, _map_to_sdl_exception)
from ricsdl.configuration import _Configuration
from ricsdl.configuration import DbBackendType
import ricsdl.exceptions
EVENT_SEPARATOR = "___"
def get_test_sdl_standby_config():
return _Configuration.Params(db_host='service-ricplt-dbaas-tcp-cluster-0.ricplt',
db_ports=['6379'],
db_sentinel_ports=[],
db_sentinel_master_names=[],
db_cluster_addrs=['service-ricplt-dbaas-tcp-cluster-0.ricplt'],
db_type=DbBackendType.REDIS)
def get_test_sdl_sentinel_config():
return _Configuration.Params(db_host='service-ricplt-dbaas-tcp-cluster-0.ricplt',
db_ports=['6379'],
db_sentinel_ports=['26379'],
db_sentinel_master_names=['dbaasmaster'],
db_cluster_addrs=['service-ricplt-dbaas-tcp-cluster-0.ricplt'],
db_type=DbBackendType.REDIS)
def get_test_sdl_sentinel_cluster_config():
return _Configuration.Params(db_host='service-ricplt-dbaas-tcp-cluster-0.ricplt',
db_ports=['6379','6380'],
db_sentinel_ports=['26379','26380'],
db_sentinel_master_names=['dbaasmaster-cluster-0','dbaasmaster-cluster-1'],
db_cluster_addrs=['service-ricplt-dbaas-tcp-cluster-0.ricplt','service-ricplt-dbaas-tcp-cluster-1.ricplt'],
db_type=DbBackendType.REDIS)
@pytest.fixture()
def redis_backend_common_fixture(request):
request.cls.ns = 'some-ns'
request.cls.dl_redis = [b'1', b'2']
request.cls.dm = {'a': b'1', 'b': b'2'}
request.cls.dm_redis = {'{some-ns},a': b'1', '{some-ns},b': b'2'}
request.cls.dm_redis_flat = ['{some-ns},a', b'1', '{some-ns},b', b'2']
request.cls.key = 'a'
request.cls.key_redis = '{some-ns},a'
request.cls.keys = ['a', 'b']
request.cls.keys_redis = ['{some-ns},a', '{some-ns},b']
request.cls.data = b'123'
request.cls.old_data = b'1'
request.cls.new_data = b'3'
request.cls.keypattern = r'[Aa]bc-\[1\].?-*'
request.cls.keypattern_redis = r'{some-ns},[Aa]bc-\[1\].?-*'
request.cls.matchedkeys = ['Abc-[1].0-def', 'abc-[1].1-ghi']
request.cls.matchedkeys_redis = [b'{some-ns},Abc-[1].0-def',
b'{some-ns},abc-[1].1-ghi']
request.cls.matcheddata_redis = [b'10', b'11']
request.cls.matchedkeydata = {'Abc-[1].0-def': b'10',
'abc-[1].1-ghi': b'11'}
request.cls.group = 'some-group'
request.cls.group_redis = '{some-ns},some-group'
request.cls.groupmembers = set([b'm1', b'm2'])
request.cls.groupmember = b'm1'
request.cls.channels = ['ch1', 'ch2']
request.cls.channels_and_events = {'ch1': ['ev1'], 'ch2': ['ev2', 'ev3']}
request.cls.channels_and_events_redis = ['{some-ns},ch1', 'ev1',
'{some-ns},ch2', 'ev2' + EVENT_SEPARATOR + 'ev3']
yield
@pytest.fixture(params=['standalone', 'sentinel', 'sentinel_cluster'])
def redis_backend_fixture(request, redis_backend_common_fixture):
request.cls.configuration = Mock()
request.cls.configuration.get_event_separator.return_value = EVENT_SEPARATOR
request.cls.test_backend_type = request.param
if request.param == 'standalone':
cfg = get_test_sdl_standby_config()
request.cls.configuration.get_params.return_value = cfg
with patch('ricsdl.backend.redis.Redis') as mock_redis, patch(
'ricsdl.backend.redis.PubSub') as mock_pubsub, patch(
'threading.Thread') as mock_thread:
db = ricsdl.backend.get_backend_instance(request.cls.configuration)
request.cls.mock_redis = mock_redis.return_value
request.cls.mock_pubsub = mock_pubsub.return_value
request.cls.mock_pubsub_thread = mock_thread.return_value
request.cls.mock_pubsub_thread.is_alive.return_value = False
request.cls.db = db
mock_redis.assert_called_once_with(db=0, host=cfg.db_host, max_connections=20, port=cfg.db_ports[0])
mock_pubsub.assert_called_once_with(EVENT_SEPARATOR, request.cls.mock_redis.connection_pool,
ignore_subscribe_messages=True)
assert request.cls.mock_redis.set_response_callback.call_count == 2
assert request.cls.mock_redis.set_response_callback.call_args_list == [call('SETIE', ANY), call('DELIE', ANY)]
elif request.param == 'sentinel':
cfg = get_test_sdl_sentinel_config()
request.cls.configuration.get_params.return_value = cfg
with patch('ricsdl.backend.redis.Sentinel') as mock_sentinel, patch(
'ricsdl.backend.redis.PubSub') as mock_pubsub, patch(
'threading.Thread') as mock_thread:
db = ricsdl.backend.get_backend_instance(request.cls.configuration)
request.cls.mock_redis = mock_sentinel.return_value.master_for.return_value
request.cls.mock_pubsub = mock_pubsub.return_value
request.cls.mock_pubsub_thread = mock_thread.return_value
request.cls.mock_pubsub_thread.is_alive.return_value = False
request.cls.db = db
mock_sentinel.assert_called_once_with([(cfg.db_host, cfg.db_sentinel_ports[0])])
mock_sentinel.master_for.called_once_with(cfg.db_sentinel_master_names[0])
mock_pubsub.assert_called_once_with(EVENT_SEPARATOR, request.cls.mock_redis.connection_pool,
ignore_subscribe_messages=True)
assert request.cls.mock_redis.set_response_callback.call_count == 2
assert request.cls.mock_redis.set_response_callback.call_args_list == [call('SETIE', ANY), call('DELIE', ANY)]
elif request.param == 'sentinel_cluster':
cfg = get_test_sdl_sentinel_cluster_config()
request.cls.configuration.get_params.return_value = cfg
with patch('ricsdl.backend.redis.Sentinel') as mock_sentinel, patch(
'ricsdl.backend.redis.PubSub') as mock_pubsub, patch(
'threading.Thread') as mock_thread:
db = ricsdl.backend.get_backend_instance(request.cls.configuration)
request.cls.mock_redis = mock_sentinel.return_value.master_for.return_value
request.cls.mock_pubsub = mock_pubsub.return_value
request.cls.mock_pubsub_thread = mock_thread.return_value
request.cls.mock_pubsub_thread.is_alive.return_value = False
request.cls.db = db
assert mock_sentinel.call_count == 2
mock_sentinel.assert_has_calls([
call([('service-ricplt-dbaas-tcp-cluster-0.ricplt', '26379')]),
call([('service-ricplt-dbaas-tcp-cluster-1.ricplt', '26380')]),
], any_order=True)
assert mock_sentinel.return_value.master_for.call_count == 2
mock_sentinel.return_value.master_for.assert_has_calls(
[call('dbaasmaster-cluster-0'), call('dbaasmaster-cluster-1')], any_order=True,
)
assert mock_pubsub.call_count == 2
mock_pubsub.assert_has_calls([
call(EVENT_SEPARATOR, request.cls.mock_redis.connection_pool, ignore_subscribe_messages=True),
call(EVENT_SEPARATOR, request.cls.mock_redis.connection_pool, ignore_subscribe_messages=True),
])
assert request.cls.mock_redis.set_response_callback.call_count == 4
assert request.cls.mock_redis.set_response_callback.call_args_list == [
call('SETIE', ANY), call('DELIE', ANY),
call('SETIE', ANY), call('DELIE', ANY),
]
else:
raise NotImplementedError
yield
@pytest.mark.usefixtures('redis_backend_fixture')
class TestRedisBackend:
def test_is_connected_function_success(self):
self.mock_redis.ping.return_value = True
ret = self.db.is_connected()
if self.test_backend_type == 'sentinel_cluster':
assert self.mock_redis.ping.call_count == 2
else:
assert self.mock_redis.ping.call_count == 1
assert ret is True
def test_is_connected_function_returns_false_if_ping_fails(self):
self.mock_redis.ping.return_value = False
ret = self.db.is_connected()
self.mock_redis.ping.assert_called_once()
assert ret is False
def test_is_connected_function_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.ping.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.is_connected()
def test_set_function_success(self):
self.db.set(self.ns, self.dm)
self.mock_redis.mset.assert_called_once_with(self.dm_redis)
def test_set_function_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.mset.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.set(self.ns, self.dm)
def test_set_if_function_success(self):
self.mock_redis.execute_command.return_value = True
ret = self.db.set_if(self.ns, self.key, self.old_data, self.new_data)
self.mock_redis.execute_command.assert_called_once_with('SETIE', self.key_redis,
self.new_data, self.old_data)
assert ret is True
def test_set_if_function_returns_false_if_existing_key_value_not_expected(self):
self.mock_redis.execute_command.return_value = False
ret = self.db.set_if(self.ns, self.key, self.old_data, self.new_data)
self.mock_redis.execute_command.assert_called_once_with('SETIE', self.key_redis,
self.new_data, self.old_data)
assert ret is False
def test_set_if_function_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.execute_command.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.set_if(self.ns, self.key, self.old_data, self.new_data)
def test_set_if_not_exists_function_success(self):
self.mock_redis.setnx.return_value = True
ret = self.db.set_if_not_exists(self.ns, self.key, self.new_data)
self.mock_redis.setnx.assert_called_once_with(self.key_redis, self.new_data)
assert ret is True
def test_set_if_not_exists_function_returns_false_if_key_already_exists(self):
self.mock_redis.setnx.return_value = False
ret = self.db.set_if_not_exists(self.ns, self.key, self.new_data)
self.mock_redis.setnx.assert_called_once_with(self.key_redis, self.new_data)
assert ret is False
def test_set_if_not_exists_function_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.setnx.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.set_if_not_exists(self.ns, self.key, self.new_data)
def test_get_function_success(self):
self.mock_redis.mget.return_value = self.dl_redis
ret = self.db.get(self.ns, self.keys)
self.mock_redis.mget.assert_called_once_with(self.keys_redis)
assert ret == self.dm
def test_get_function_returns_empty_dict_when_no_key_values_exist(self):
self.mock_redis.mget.return_value = [None, None]
ret = self.db.get(self.ns, self.keys)
self.mock_redis.mget.assert_called_once_with(self.keys_redis)
assert ret == dict()
def test_get_function_returns_dict_only_with_found_key_values_when_some_keys_exist(self):
self.mock_redis.mget.return_value = [self.data, None]
ret = self.db.get(self.ns, self.keys)
self.mock_redis.mget.assert_called_once_with(self.keys_redis)
assert ret == {self.key: self.data}
def test_get_function_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.mget.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.get(self.ns, self.keys)
def test_find_keys_function_success(self):
self.mock_redis.keys.return_value = self.matchedkeys_redis
ret = self.db.find_keys(self.ns, self.keypattern)
self.mock_redis.keys.assert_called_once_with(self.keypattern_redis)
assert ret == self.matchedkeys
def test_find_keys_function_returns_empty_list_when_no_matching_keys_found(self):
self.mock_redis.keys.return_value = []
ret = self.db.find_keys(self.ns, self.keypattern)
self.mock_redis.keys.assert_called_once_with(self.keypattern_redis)
assert ret == []
def test_find_keys_function_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.keys.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.find_keys(self.ns, self.keypattern)
def test_find_keys_function_can_raise_exception_when_redis_key_convert_to_string_fails(self):
# Redis returns an illegal key, which conversion to string fails
corrupt_redis_key = b'\x81'
self.mock_redis.keys.return_value = [corrupt_redis_key]
with pytest.raises(ricsdl.exceptions.RejectedByBackend) as excinfo:
self.db.find_keys(self.ns, self.keypattern)
assert f"Namespace {self.ns} key:{corrupt_redis_key} "
"has no namespace prefix" in str(excinfo.value)
def test_find_keys_function_can_raise_exception_when_redis_key_is_without_prefix(self):
# Redis returns an illegal key, which doesn't have comma separated namespace prefix
corrupt_redis_key = 'some-corrupt-key'
self.mock_redis.keys.return_value = [f'{corrupt_redis_key}'.encode()]
with pytest.raises(ricsdl.exceptions.RejectedByBackend) as excinfo:
self.db.find_keys(self.ns, self.keypattern)
assert f"Namespace {self.ns} key:{corrupt_redis_key} "
"has no namespace prefix" in str(excinfo.value)
def test_find_and_get_function_success(self):
self.mock_redis.keys.return_value = self.matchedkeys_redis
self.mock_redis.mget.return_value = self.matcheddata_redis
ret = self.db.find_and_get(self.ns, self.keypattern)
self.mock_redis.keys.assert_called_once_with(self.keypattern_redis)
self.mock_redis.mget.assert_called_once_with([i.decode() for i in self.matchedkeys_redis])
assert ret == self.matchedkeydata
def test_find_and_get_function_returns_empty_dict_when_no_matching_keys_exist(self):
self.mock_redis.keys.return_value = list()
ret = self.db.find_and_get(self.ns, self.keypattern)
self.mock_redis.keys.assert_called_once_with(self.keypattern_redis)
assert not self.mock_redis.mget.called
assert ret == dict()
def test_find_and_get_function_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.keys.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.find_and_get(self.ns, self.keypattern)
def test_find_and_get_function_can_raise_exception_when_redis_key_convert_to_string_fails(self):
# Redis returns an illegal key, which conversion to string fails
corrupt_redis_key = b'\x81'
self.mock_redis.keys.return_value = [corrupt_redis_key]
with pytest.raises(ricsdl.exceptions.RejectedByBackend) as excinfo:
self.db.find_and_get(self.ns, self.keypattern)
assert f"Namespace {self.ns} key:{corrupt_redis_key} "
"has no namespace prefix" in str(excinfo.value)
def test_find_and_get_function_can_raise_exception_when_redis_key_is_without_prefix(self):
# Redis returns an illegal key, which doesn't have comma separated namespace prefix
corrupt_redis_key = 'some-corrupt-key'
self.mock_redis.keys.return_value = [f'{corrupt_redis_key}'.encode()]
with pytest.raises(ricsdl.exceptions.RejectedByBackend) as excinfo:
self.db.find_and_get(self.ns, self.keypattern)
assert f"Namespace {self.ns} key:{corrupt_redis_key} "
"has no namespace prefix" in str(excinfo.value)
def test_remove_function_success(self):
self.db.remove(self.ns, self.keys)
self.mock_redis.delete.assert_called_once_with(*self.keys_redis)
def test_remove_function_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.delete.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.remove(self.ns, self.keys)
def test_remove_if_function_success(self):
self.mock_redis.execute_command.return_value = True
ret = self.db.remove_if(self.ns, self.key, self.new_data)
self.mock_redis.execute_command.assert_called_once_with('DELIE', self.key_redis,
self.new_data)
assert ret is True
def test_remove_if_function_returns_false_if_data_does_not_match(self):
self.mock_redis.execute_command.return_value = False
ret = self.db.remove_if(self.ns, self.key, self.new_data)
self.mock_redis.execute_command.assert_called_once_with('DELIE', self.key_redis,
self.new_data)
assert ret is False
def test_remove_if_function_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.execute_command.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.remove_if(self.ns, self.key, self.new_data)
def test_add_member_function_success(self):
self.db.add_member(self.ns, self.group, self.groupmembers)
self.mock_redis.sadd.assert_called_once_with(self.group_redis, *self.groupmembers)
def test_add_member_function_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.sadd.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.add_member(self.ns, self.group, self.groupmembers)
def test_remove_member_function_success(self):
self.db.remove_member(self.ns, self.group, self.groupmembers)
self.mock_redis.srem.assert_called_once_with(self.group_redis, *self.groupmembers)
def test_remove_member_function_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.srem.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.remove_member(self.ns, self.group, self.groupmembers)
def test_remove_group_function_success(self):
self.db.remove_group(self.ns, self.group)
self.mock_redis.delete.assert_called_once_with(self.group_redis)
def test_remove_group_function_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.delete.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.remove_group(self.ns, self.group)
def test_get_members_function_success(self):
self.mock_redis.smembers.return_value = self.groupmembers
ret = self.db.get_members(self.ns, self.group)
self.mock_redis.smembers.assert_called_once_with(self.group_redis)
assert ret is self.groupmembers
def test_get_members_function_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.smembers.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.get_members(self.ns, self.group)
def test_is_member_function_success(self):
self.mock_redis.sismember.return_value = True
ret = self.db.is_member(self.ns, self.group, self.groupmember)
self.mock_redis.sismember.assert_called_once_with(self.group_redis, self.groupmember)
assert ret is True
def test_is_member_function_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.sismember.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.is_member(self.ns, self.group, self.groupmember)
def test_group_size_function_success(self):
self.mock_redis.scard.return_value = 100
ret = self.db.group_size(self.ns, self.group)
self.mock_redis.scard.assert_called_once_with(self.group_redis)
assert ret == 100
def test_group_size_function_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.scard.side_effect = redis_exceptions.ResponseError('Some redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.group_size(self.ns, self.group)
def test_set_and_publish_success(self):
self.db.set_and_publish(self.ns, self.channels_and_events, self.dm)
self.mock_redis.execute_command.assert_called_once_with('MSETMPUB', len(self.dm),
len(self.channels_and_events),
*self.dm_redis_flat,
*self.channels_and_events_redis)
def test_set_and_publish_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.execute_command.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.set_and_publish(self.ns, self.channels_and_events, self.dm)
def test_set_if_and_publish_success(self):
self.mock_redis.execute_command.return_value = b"OK"
ret = self.db.set_if_and_publish(self.ns, self.channels_and_events, self.key, self.old_data,
self.new_data)
self.mock_redis.execute_command.assert_called_once_with('SETIEMPUB', self.key_redis,
self.new_data, self.old_data,
*self.channels_and_events_redis)
assert ret is True
def test_set_if_and_publish_returns_false_if_existing_key_value_not_expected(self):
self.mock_redis.execute_command.return_value = None
ret = self.db.set_if_and_publish(self.ns, self.channels_and_events, self.key, self.old_data,
self.new_data)
self.mock_redis.execute_command.assert_called_once_with('SETIEMPUB', self.key_redis,
self.new_data, self.old_data,
*self.channels_and_events_redis)
assert ret is False
def test_set_if_and_publish_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.execute_command.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.set_if_and_publish(self.ns, self.channels_and_events, self.key, self.old_data,
self.new_data)
def test_set_if_not_exists_and_publish_success(self):
self.mock_redis.execute_command.return_value = b"OK"
ret = self.db.set_if_not_exists_and_publish(self.ns, self.channels_and_events, self.key,
self.new_data)
self.mock_redis.execute_command.assert_called_once_with('SETNXMPUB', self.key_redis,
self.new_data,
*self.channels_and_events_redis)
assert ret is True
def test_set_if_not_exists_and_publish_returns_false_if_key_already_exists(self):
self.mock_redis.execute_command.return_value = None
ret = self.db.set_if_not_exists_and_publish(self.ns, self.channels_and_events, self.key,
self.new_data)
self.mock_redis.execute_command.assert_called_once_with('SETNXMPUB', self.key_redis,
self.new_data,
*self.channels_and_events_redis)
assert ret is False
def set_if_not_exists_and_publish_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.execute_command.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.set_if_not_exists_and_publish(self.ns, self.channels_and_events, self.key,
self.new_data)
def test_remove_and_publish_success(self):
self.db.remove_and_publish(self.ns, self.channels_and_events, self.key)
self.mock_redis.execute_command.assert_called_once_with('DELMPUB', len(self.key),
len(self.channels_and_events),
self.key_redis,
*self.channels_and_events_redis)
def test_remove_if_and_publish_success(self):
self.mock_redis.execute_command.return_value = 1
ret = self.db.remove_if_and_publish(self.ns, self.channels_and_events, self.key,
self.new_data)
self.mock_redis.execute_command.assert_called_once_with('DELIEMPUB', self.key_redis,
self.new_data,
*self.channels_and_events_redis)
assert ret is True
def test_remove_if_and_publish_returns_false_if_data_does_not_match(self):
self.mock_redis.execute_command.return_value = 0
ret = self.db.remove_if_and_publish(self.ns, self.channels_and_events, self.key,
self.new_data)
self.mock_redis.execute_command.assert_called_once_with('DELIEMPUB', self.key_redis,
self.new_data,
*self.channels_and_events_redis)
assert ret is False
def test_remove_if_and_publish_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.execute_command.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.remove_if_and_publish(self.ns, self.channels_and_events, self.key,
self.new_data)
def test_remove_all_and_publish_success(self):
self.mock_redis.keys.return_value = ['{some-ns},a']
self.db.remove_all_and_publish(self.ns, self.channels_and_events)
self.mock_redis.keys.assert_called_once()
self.mock_redis.execute_command.assert_called_once_with('DELMPUB', len(self.key),
len(self.channels_and_events),
self.key_redis,
*self.channels_and_events_redis)
def test_remove_all_and_publish_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis.execute_command.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.remove_all_and_publish(self.ns, self.channels_and_events)
def test_subscribe_channel_success(self):
cb = Mock()
self.db.subscribe_channel(self.ns, cb, self.channels)
for channel in self.channels:
self.mock_pubsub.subscribe.assert_any_call(**{f'{{some-ns}},{channel}': cb})
def test_subscribe_channel_with_thread_success(self):
cb = Mock()
# Call first start_event_listener() to enable run_in_thread flag. When subscribe_channel()
# is called thread is started if the flag is enabled. In real-life scenario it's highly
# advisable at first to subscribe to some events by calling subscribe_channel() and only
# after it start threads by calling start_event_listener().
self.db.start_event_listener()
self.db.subscribe_channel(self.ns, cb, self.channels)
self.mock_pubsub.run_in_thread.assert_called_once_with(daemon=True, sleep_time=0.001)
def test_subscribe_can_map_redis_exception_to_sdl_exeception(self):
self.mock_pubsub.subscribe.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.subscribe_channel(self.ns, Mock(), self.channels)
def test_unsubscribe_channel_success(self):
self.db.unsubscribe_channel(self.ns, [self.channels[0]])
self.mock_pubsub.unsubscribe.assert_called_with('{some-ns},ch1')
def test_unsubscribe_channel_can_map_redis_exception_to_sdl_exeception(self):
self.mock_pubsub.unsubscribe.side_effect = redis_exceptions.ResponseError('redis error!')
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.unsubscribe_channel(self.ns, [self.channels[0]])
def test_subscribe_and_start_event_listener(self):
self.mock_redis.pubsub_channels.return_value = self.channels_and_events_redis
self.db.subscribe_channel(self.ns, Mock(), self.channels)
self.db.start_event_listener()
if self.test_backend_type == 'sentinel_cluster':
assert self.mock_redis.pubsub_channels.call_count == 2
assert self.mock_pubsub.run_in_thread.call_count == 2
self.mock_pubsub.run_in_thread.assert_has_calls([
call(daemon=True, sleep_time=0.001),
call(daemon=True, sleep_time=0.001),
])
else:
self.mock_redis.pubsub_channels.assert_called_once()
self.mock_pubsub.run_in_thread.assert_called_once_with(daemon=True, sleep_time=0.001)
def test_start_event_listener_fail(self):
self.mock_pubsub_thread.is_alive.return_value = True
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.start_event_listener()
def test_handle_events_success(self):
self.db.handle_events()
self.db.handle_events()
self.db.handle_events()
self.db.handle_events()
assert self.mock_pubsub.get_message.call_count == 4
def test_handle_events_fail_if_subsub_thread_alive(self):
self.mock_pubsub_thread.is_alive.return_value = True
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.handle_events()
def test_handle_events_fail_if_event_listener_already_running(self):
self.db.start_event_listener()
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
self.db.handle_events()
def test_handle_events_ignores_message_handling_redis_runtime_exception(self):
self.mock_pubsub.get_message.side_effect = RuntimeError()
self.db.handle_events()
self.mock_pubsub.get_message.assert_called_once()
def test_get_redis_connection_function_success(self):
ret = self.db.get_redis_connection(self.ns)
assert ret is self.mock_redis
def test_redis_backend_object_string_representation(self):
str_out = str(self.db)
assert str_out is not None
def test_namespace_hash_algorithm_stays_unaltered(self):
ret_hash = self.db._RedisBackend__get_hash('sdltoolns')
assert ret_hash == 2897969051
def test_standalone_redis_init_exception_is_mapped_to_sdl_exeception():
mock_cfg = Mock()
cfg_params = get_test_sdl_standby_config()
mock_cfg.get_params.return_value = cfg_params
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
with patch('ricsdl.backend.redis.Redis') as mock_redis:
mock_redis.side_effect = redis_exceptions.ResponseError('redis error!')
ricsdl.backend.get_backend_instance(mock_cfg)
def test_standalone_pubsub_init_exception_is_mapped_to_sdl_exeception():
mock_cfg = Mock()
cfg_params = get_test_sdl_standby_config()
mock_cfg.get_params.return_value = cfg_params
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
with patch('ricsdl.backend.redis.Redis') as mock_redis, patch(
'ricsdl.backend.redis.PubSub') as mock_pubsub:
mock_pubsub.side_effect = redis_exceptions.ResponseError('redis error!')
ricsdl.backend.get_backend_instance(mock_cfg)
def test_sentinel_redis_init_exception_is_mapped_to_sdl_exeception():
mock_cfg = Mock()
cfg_params = get_test_sdl_sentinel_config()
mock_cfg.get_params.return_value = cfg_params
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
with patch('ricsdl.backend.redis.Sentinel') as mock_sentinel:
mock_sentinel.side_effect = redis_exceptions.ResponseError('redis error!')
ricsdl.backend.get_backend_instance(mock_cfg)
def test_sentinel_pubsub_init_exception_is_mapped_to_sdl_exeception():
mock_cfg = Mock()
cfg_params = get_test_sdl_sentinel_config()
mock_cfg.get_params.return_value = cfg_params
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
with patch('ricsdl.backend.redis.Sentinel') as mock_sentinel, patch(
'ricsdl.backend.redis.PubSub') as mock_pubsub:
mock_pubsub.side_effect = redis_exceptions.ResponseError('redis error!')
ricsdl.backend.get_backend_instance(mock_cfg)
def test_sentinel_master_for_exception_is_mapped_to_sdl_exeception():
mock_cfg = Mock()
cfg_params = get_test_sdl_sentinel_config()
mock_cfg.get_params.return_value = cfg_params
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
with patch('ricsdl.backend.redis.Sentinel') as mock_sentinel, patch(
'ricsdl.backend.redis.PubSub') as mock_pubsub:
mock_sentinel.return_value.master_for.side_effect = redis_exceptions.ResponseError('redis error!')
ricsdl.backend.get_backend_instance(mock_cfg)
def test_sentinel_cluster_redis_init_exception_is_mapped_to_sdl_exeception():
mock_cfg = Mock()
cfg_params = get_test_sdl_sentinel_cluster_config()
mock_cfg.get_params.return_value = cfg_params
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
with patch('ricsdl.backend.redis.Sentinel') as mock_sentinel:
mock_sentinel.side_effect = redis_exceptions.ResponseError('redis error!')
ricsdl.backend.get_backend_instance(mock_cfg)
def test_sentinel_cluster_pubsub_init_exception_is_mapped_to_sdl_exeception():
mock_cfg = Mock()
cfg_params = get_test_sdl_sentinel_cluster_config()
mock_cfg.get_params.return_value = cfg_params
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
with patch('ricsdl.backend.redis.Sentinel') as mock_sentinel, patch(
'ricsdl.backend.redis.PubSub') as mock_pubsub:
mock_pubsub.side_effect = redis_exceptions.ResponseError('redis error!')
ricsdl.backend.get_backend_instance(mock_cfg)
def test_sentinel_cluster_master_for_exception_is_mapped_to_sdl_exeception():
mock_cfg = Mock()
cfg_params = get_test_sdl_sentinel_cluster_config()
mock_cfg.get_params.return_value = cfg_params
with pytest.raises(ricsdl.exceptions.RejectedByBackend):
with patch('ricsdl.backend.redis.Sentinel') as mock_sentinel, patch(
'ricsdl.backend.redis.PubSub') as mock_pubsub:
mock_sentinel.return_value.master_for.side_effect = redis_exceptions.ResponseError('redis error!')
ricsdl.backend.get_backend_instance(mock_cfg)
class MockRedisLock:
def __init__(self, redis, name, timeout=None, sleep=0.1,
blocking=True, blocking_timeout=None, thread_local=True):
self.redis = redis
self.name = name
self.timeout = timeout
self.sleep = sleep
self.blocking = blocking
self.blocking_timeout = blocking_timeout
self.thread_local = bool(thread_local)
@pytest.fixture(scope="module")
def mock_redis_lock():
def _mock_redis_lock(name, timeout=None, sleep=0.1,
blocking=True, blocking_timeout=None, thread_local=True):
return MockRedisLock(name, timeout, sleep, blocking, blocking_timeout, thread_local)
return _mock_redis_lock
@pytest.fixture()
def redis_backend_lock_fixture(request, mock_redis_lock):
request.cls.ns = 'some-ns'
request.cls.lockname = 'some-lock-name'
request.cls.lockname_redis = '{some-ns},some-lock-name'
request.cls.expiration = 10
request.cls.retry_interval = 0.1
request.cls.retry_timeout = 1
request.cls.mock_lua_get_validity_time = Mock()
request.cls.mock_lua_get_validity_time.return_value = 2000
request.cls.mock_redis = Mock()
request.cls.mock_redis.register_script = Mock()
request.cls.mock_redis.register_script.return_value = request.cls.mock_lua_get_validity_time
mocked_dbbackend = Mock()
mocked_dbbackend.get_redis_connection.return_value = request.cls.mock_redis
request.cls.configuration = Mock()
mock_conf_params = _Configuration.Params(db_host=None,
db_ports=None,
db_sentinel_ports=None,
db_sentinel_master_names=None,
db_cluster_addrs=None,
db_type=DbBackendType.REDIS)
request.cls.configuration.get_params.return_value = mock_conf_params
with patch('ricsdl.backend.redis.Lock') as mock_redis_lock:
lock = ricsdl.backend.get_backend_lock_instance(request.cls.configuration,
request.cls.ns, request.cls.lockname,
request.cls.expiration, mocked_dbbackend)
request.cls.mock_redis_lock = mock_redis_lock.return_value
request.cls.lock = lock
yield
RedisBackendLock.lua_get_validity_time = None
@pytest.mark.usefixtures('redis_backend_lock_fixture')
class TestRedisBackendLock:
def test_acquire_function_success(self):
self.mock_redis_lock.acquire.return_value = True
ret = self.lock.acquire(self.retry_interval, self.retry_timeout)
self.mock_redis_lock.acquire.assert_called_once_with(blocking_timeout=self.retry_timeout)
assert ret is True
def test_acquire_function_returns_false_if_lock_is_not_acquired(self):
self.mock_redis_lock.acquire.return_value = False
ret = self.lock.acquire(self.retry_interval, self.retry_timeout)
self.mock_redis_lock.acquire.assert_called_once_with(blocking_timeout=self.retry_timeout)
assert ret is False
def test_acquire_function_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis_lock.acquire.side_effect = redis_exceptions.LockError('redis lock error!')
with pytest.raises(ricsdl.exceptions.BackendError):
self.lock.acquire(self.retry_interval, self.retry_timeout)
def test_release_function_success(self):
self.lock.release()
self.mock_redis_lock.release.assert_called_once()
def test_release_function_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis_lock.release.side_effect = redis_exceptions.LockError('redis lock error!')
with pytest.raises(ricsdl.exceptions.BackendError):
self.lock.release()
def test_refresh_function_success(self):
self.lock.refresh()
self.mock_redis_lock.reacquire.assert_called_once()
def test_refresh_function_can_map_redis_exception_to_sdl_exception(self):
self.mock_redis_lock.reacquire.side_effect = redis_exceptions.LockError('redis lock error!')
with pytest.raises(ricsdl.exceptions.BackendError):
self.lock.refresh()
def test_get_validity_time_function_success(self):
self.mock_redis_lock.name = self.lockname_redis
self.mock_redis_lock.local.token = 123
ret = self.lock.get_validity_time()
self.mock_lua_get_validity_time.assert_called_once_with(
keys=[self.lockname_redis], args=[123], client=self.mock_redis)
assert ret == 2
def test_get_validity_time_function_second_fraction_success(self):
self.mock_redis_lock.name = self.lockname_redis
self.mock_redis_lock.local.token = 123
self.mock_lua_get_validity_time.return_value = 234
ret = self.lock.get_validity_time()
self.mock_lua_get_validity_time.assert_called_once_with(
keys=[self.lockname_redis], args=[123], client=self.mock_redis)
assert ret == 0.234
def test_get_validity_time_function_can_raise_exception_if_lock_is_unlocked(self):
self.mock_redis_lock.name = self.lockname_redis
self.mock_redis_lock.local.token = None
with pytest.raises(ricsdl.exceptions.RejectedByBackend) as excinfo:
self.lock.get_validity_time()
assert f"Cannot get validity time of an unlocked lock {self.lockname}" in str(excinfo.value)
def test_get_validity_time_function_can_raise_exception_if_lua_script_fails(self):
self.mock_redis_lock.name = self.lockname_redis
self.mock_redis_lock.local.token = 123
self.mock_lua_get_validity_time.return_value = -10
with pytest.raises(ricsdl.exceptions.RejectedByBackend) as excinfo:
self.lock.get_validity_time()
assert f"Getting validity time of a lock {self.lockname} failed with error code: -10" in str(excinfo.value)
def test_redis_backend_lock_object_string_representation(self):
expected_lock_info = {'lock DB type': 'Redis',
'lock namespace': 'some-ns',
'lock name': 'some-lock-name',
'lock status': 'locked'}
assert str(self.lock) == str(expected_lock_info)
def test_redis_backend_lock_object_string_representation_can_catch_redis_exception(self):
self.mock_redis_lock.owned.side_effect = redis_exceptions.LockError('redis lock error!')
expected_lock_info = {'lock DB type': 'Redis',
'lock namespace': 'some-ns',
'lock name': 'some-lock-name',
'lock status': 'Error: redis lock error!'}
assert str(self.lock) == str(expected_lock_info)
def test_redis_response_error_exception_is_mapped_to_rejected_by_backend_sdl_exception():
with pytest.raises(ricsdl.exceptions.RejectedByBackend) as excinfo:
with _map_to_sdl_exception():
raise redis_exceptions.ResponseError('Some redis error!')
assert "SDL backend rejected the request: Some redis error!" in str(excinfo.value)
def test_redis_connection_error_exception_is_mapped_to_not_connected_sdl_exception():
with pytest.raises(ricsdl.exceptions.NotConnected) as excinfo:
with _map_to_sdl_exception():
raise redis_exceptions.ConnectionError('Some redis error!')
assert "SDL not connected to backend: Some redis error!" in str(excinfo.value)
def test_rest_redis_exceptions_are_mapped_to_backend_error_sdl_exception():
with pytest.raises(ricsdl.exceptions.BackendError) as excinfo:
with _map_to_sdl_exception():
raise redis_exceptions.RedisError('Some redis error!')
assert "SDL backend failed to process the request: Some redis error!" in str(excinfo.value)
def test_system_error_exceptions_are_not_mapped_to_any_sdl_exception():
with pytest.raises(SystemExit):
with _map_to_sdl_exception():
raise SystemExit('Fatal error')
class TestRedisClient:
@classmethod
def setup_class(cls):
cls.pubsub = ricsdl.backend.redis.PubSub(EVENT_SEPARATOR, Mock())
cls.pubsub.channels = {b'{some-ns},ch1': Mock()}
def test_handle_pubsub_message(self):
assert self.pubsub.handle_message([b'message', b'{some-ns},ch1', b'cbn']) == ('ch1', ['cbn'])
self.pubsub.channels.get(b'{some-ns},ch1').assert_called_once_with('ch1', ['cbn'])