Files
charm-interface-mysql-shared/unit_tests/test_requires.py
Hervé Beraud f90f8c6edc Use unittest.mock instead of mock
The mock third party library was needed for mock support in py2
runtimes. Since we now only support py36 and later, we can use the
standard lib unittest.mock module instead.

Note that https://github.com/openstack/charms.openstack is used during tests
and he need `mock`, unfortunatelly it doesn't declare `mock` in its
requirements so it retrieve mock from other charm project (cross dependency).
So we depend on charms.openstack first and when
Ib1ed5b598a52375e29e247db9ab4786df5b6d142 will be merged then CI
will pass without errors.

Depends-On: Ib1ed5b598a52375e29e247db9ab4786df5b6d142
Change-Id: I69e03a14ab370bd6870e4325627e7be86fe2a53f
2021-12-15 10:09:45 +00:00

304 lines
12 KiB
Python

# 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.
import unittest
from unittest import mock
import requires
_hook_args = {}
def mock_hook(*args, **kwargs):
def inner(f):
# remember what we were passed. Note that we can't actually determine
# the class we're attached to, as the decorator only gets the function.
_hook_args[f.__name__] = dict(args=args, kwargs=kwargs)
return f
return inner
class TestMySQLSharedRequires(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls._patched_hook = mock.patch('charms.reactive.hook', mock_hook)
cls._patched_hook_started = cls._patched_hook.start()
# force requires to rerun the mock_hook decorator:
# try except is Python2/Python3 compatibility as Python3 has moved
# reload to importlib.
try:
reload(requires)
except NameError:
import importlib
importlib.reload(requires)
@classmethod
def tearDownClass(cls):
cls._patched_hook.stop()
cls._patched_hook_started = None
cls._patched_hook = None
# and fix any breakage we did to the module
try:
reload(requires)
except NameError:
import importlib
importlib.reload(requires)
def setUp(self):
self._patches = {}
self._patches_start = {}
self._rel_ids = ["mysql-shared:3"]
self._remote_data = {}
self._local_data = {}
self._conversation = mock.MagicMock()
self._conversation.relation_ids = self._rel_ids
self._conversation.scope = requires.scopes.GLOBAL
self._conversation.get_remote.side_effect = self.get_fake_remote_data
self._conversation.get_local.side_effect = self.get_fake_local_data
# The Relation object
self.mysql_shared = requires.MySQLSharedRequires(
'mysql-shared', [self._conversation])
self.patch_mysql_shared('conversations', [self._conversation])
self.patch_mysql_shared('set_remote')
self.patch_mysql_shared('set_local')
self.patch_mysql_shared('set_state')
self.patch_mysql_shared('remove_state')
self.patch_mysql_shared('db_host', "10.5.0.21")
self.patch_mysql_shared('wait_timeout', 90)
def tearDown(self):
self.mysql_shared = None
for k, v in self._patches.items():
v.stop()
setattr(self, k, None)
self._patches = None
self._patches_start = None
def patch_mysql_shared(self, attr, return_value=None):
mocked = mock.patch.object(self.mysql_shared, attr)
self._patches[attr] = mocked
started = mocked.start()
started.return_value = return_value
self._patches_start[attr] = started
setattr(self, attr, started)
def get_fake_remote_data(self, key, default=None):
return self._remote_data.get(key) or default
def get_fake_local_data(self, key, default=None):
return self._local_data.get(key) or default
def test_registered_hooks(self):
# test that the hooks actually registered the relation expressions that
# are meaningful for this interface: this is to handle regressions.
# The keys are the function names that the hook attaches to.
hook_patterns = {
'joined': ('{requires:mysql-shared}-relation-joined',),
'changed': ('{requires:mysql-shared}-relation-changed',),
'departed': (
'{requires:mysql-shared}-relation-{broken,departed}',)}
for k, v in _hook_args.items():
self.assertEqual(hook_patterns[k], v['args'])
def test_changed_available(self):
self.patch_mysql_shared('unit_allowed_all_dbs', True)
self.patch_mysql_shared('base_data_complete', True)
self.patch_mysql_shared('access_network_data_complete', True)
self.patch_mysql_shared('ssl_data_complete', True)
_calls = [
mock.call("{relation_name}.available"),
mock.call("{relation_name}.available.access_network"),
mock.call("{relation_name}.available.ssl")]
self.mysql_shared.changed()
self.set_state.assert_has_calls(_calls)
def test_changed_not_available(self):
self.patch_mysql_shared('base_data_complete', False)
self.patch_mysql_shared('access_network_data_complete', False)
self.patch_mysql_shared('ssl_data_complete', False)
self.mysql_shared.changed()
self.set_state.assert_not_called()
def test_joined(self):
self.mysql_shared.joined()
self.set_state.assert_called_once_with('{relation_name}.connected')
def test_departed(self):
self.mysql_shared.departed()
_calls = [
mock.call("{relation_name}.available"),
mock.call("{relation_name}.available.access_network"),
mock.call("{relation_name}.available.ssl")]
self.remove_state.assert_has_calls(_calls)
def test_base_data_complete(self):
self._remote_data = {"password": "1234",
"allowed_units": "unit/1"}
assert self.mysql_shared.base_data_complete() is True
self.db_host.return_value = None
assert self.mysql_shared.base_data_complete() is False
def test_base_data_complete_prefixed(self):
self._local_data = {"prefixes": ["myprefix"]}
self._remote_data = {"myprefix_password": "1234",
"myprefix_allowed_units": "unit/1"}
assert self.mysql_shared.base_data_complete() is True
self.db_host.return_value = None
assert self.mysql_shared.base_data_complete() is False
def test_shared_db_data_complete_wait_timeout(self):
self._local_data = {"prefixes": ["myprefix"]}
self._remote_data = {"myprefix_password": "1234",
"myprefix_allowed_units": "unit/1"}
# Wait timeout is an optional value and should not affect data complete
self.wait_timeout.return_value = None
assert self.mysql_shared.base_data_complete() is True
self.wait_timeout.return_value = 90
assert self.mysql_shared.base_data_complete() is True
def test_base_data_incomplete(self):
assert self.mysql_shared.base_data_complete() is False
def test_access_network_data_incomplete(self):
self.patch_mysql_shared('access_network', "10.92.3.0/24")
assert self.mysql_shared.access_network_data_complete() is True
self.access_network.return_value = None
assert self.mysql_shared.access_network_data_complete() is False
def test_ssl_data_incomplete(self):
self.patch_mysql_shared('ssl_ca', "Certificate Authority")
self.patch_mysql_shared('ssl_cert', "somecert")
self.patch_mysql_shared('ssl_key', "somekey")
assert self.mysql_shared.ssl_data_complete() is True
self.ssl_ca.return_value = None
assert self.mysql_shared.ssl_data_complete() is False
def test_local_accessors(self):
_prefix = "myprefix"
_value = "value"
_tests = {
"database": self.mysql_shared.database,
"username": self.mysql_shared.username,
"hostname": self.mysql_shared.hostname}
# Not set
for key, test in _tests.items():
self.assertEqual(test(), None)
# Unprefixed
for key, test in _tests.items():
self._local_data = {key: _value}
self.assertEqual(test(), _value)
# Prefixed
self._local_data = {"prefixes": [_prefix]}
for key, test in _tests.items():
self._local_data["{}_{}".format(_prefix, key)] = _value
self.assertEqual(test(prefix=_prefix), _value)
def test_remote_accessors(self):
_prefix = "myprefix"
_value = "value"
_tests = {
"password": self.mysql_shared.password,
"allowed_units": self.mysql_shared.allowed_units}
# Not set
for key, test in _tests.items():
self.assertEqual(test(), None)
# Unprefixed
for key, test in _tests.items():
self._remote_data = {key: _value}
self.assertEqual(test(), _value)
# Prefixed
self._local_data = {"prefixes": [_prefix]}
for key, test in _tests.items():
self._remote_data = {"{}_{}".format(_prefix, key): _value}
self.assertEqual(test(prefix=_prefix), _value)
def test_configure(self):
_db = "db"
_user = "user"
_host = "host"
_prefix = None
self.mysql_shared.configure(_db, _user, _host, prefix=_prefix)
self.set_remote.assert_called_once_with(
database=_db, username=_user, hostname=_host)
self.set_local.assert_called_once_with(
database=_db, username=_user, hostname=_host)
def test_configure_prefixed(self):
self.patch_mysql_shared('set_prefix')
_db = "db"
_user = "user"
_host = "host"
_prefix = "prefix"
_expected = {
"{}_database".format(_prefix): _db,
"{}_username".format(_prefix): _user,
"{}_hostname".format(_prefix): _host}
self.mysql_shared.configure(_db, _user, _host, prefix=_prefix)
self.set_remote.assert_called_once_with(**_expected)
self.set_local.assert_called_once_with(**_expected)
self.set_prefix.assert_called_once()
def test_get_prefix(self):
_prefix = "prefix"
self._local_data = {"prefixes": [_prefix]}
self.assertEqual(
self.mysql_shared.get_prefixes(), [_prefix])
def test_set_prefix(self):
# First
_prefix = "prefix"
self.mysql_shared.set_prefix(_prefix)
self.set_local.assert_called_once_with("prefixes", [_prefix])
# More than one
self.set_local.reset_mock()
self._local_data = {"prefixes": [_prefix]}
_second = "secondprefix"
self.mysql_shared.set_prefix(_second)
self.set_local.assert_called_once_with("prefixes", [_prefix, _second])
@mock.patch.object(requires.hookenv, 'log')
@mock.patch.object(requires.hookenv, 'local_unit')
def test_unit_allowed_db(self, local_unit, log):
self._remote_data = {'allowed_units': 'unit/1 unit/3'}
local_unit.return_value = 'unit/1'
self.assertTrue(self.mysql_shared.unit_allowed_db())
local_unit.return_value = 'unit/2'
self.assertFalse(self.mysql_shared.unit_allowed_db())
@mock.patch.object(requires.hookenv, 'log')
@mock.patch.object(requires.hookenv, 'local_unit')
def test_unit_allowed_db_prefix(self, local_unit, log):
self._remote_data = {'bob_allowed_units': 'unit/1 unit/3'}
local_unit.return_value = 'unit/1'
self.assertTrue(self.mysql_shared.unit_allowed_db(prefix='bob'))
self.assertFalse(self.mysql_shared.unit_allowed_db())
self.assertFalse(self.mysql_shared.unit_allowed_db(prefix='flump'))
@mock.patch.object(requires.hookenv, 'log')
@mock.patch.object(requires.hookenv, 'local_unit')
def test_unit_allowed_all_dbs(self, local_unit, log):
local_unit.return_value = 'unit/1'
self._local_data = {"prefixes": ['prefix1', 'prefix2']}
self._remote_data = {'prefix1_allowed_units': 'unit/1 unit/3'}
self.assertFalse(self.mysql_shared.unit_allowed_all_dbs())
self._remote_data = {
'prefix1_allowed_units': 'unit/1 unit/3',
'prefix2_allowed_units': 'unit/1 unit/3'}
self.assertTrue(self.mysql_shared.unit_allowed_all_dbs())