From 51b9f62307caa8f4eb465c49997889125a1f116d Mon Sep 17 00:00:00 2001 From: Liam Young Date: Fri, 8 Jul 2016 12:35:52 +0100 Subject: [PATCH] Add unit tests --- .gitignore | 2 + .testr.conf | 8 + requirements.txt | 4 +- {charm => src}/config.yaml | 0 {charm => src}/layer.yaml | 0 .../lib/charm/openstack/designate_bind.py | 28 +- {charm => src}/metadata.yaml | 0 .../reactive/designate_bind_handlers.py | 0 {charm => src}/templates/named.conf | 0 {charm => src}/templates/named.conf.options | 0 {charm => src}/templates/rndc.key | 0 test-requirements.txt | 7 + tox.ini | 29 +- unit_tests/__init__.py | 56 +++ unit_tests/__init__.pyc | Bin 0 -> 1290 bytes unit_tests/test_designate_bind_handlers.py | 225 +++++++++ unit_tests/test_designate_handlers.pyc | Bin 0 -> 6567 bytes ...test_lib_charm_openstack_designate_bind.py | 443 ++++++++++++++++++ 18 files changed, 784 insertions(+), 18 deletions(-) create mode 100644 .testr.conf rename {charm => src}/config.yaml (100%) rename {charm => src}/layer.yaml (100%) rename {charm => src}/lib/charm/openstack/designate_bind.py (97%) rename {charm => src}/metadata.yaml (100%) rename {charm => src}/reactive/designate_bind_handlers.py (100%) rename {charm => src}/templates/named.conf (100%) rename {charm => src}/templates/named.conf.options (100%) rename {charm => src}/templates/rndc.key (100%) create mode 100644 test-requirements.txt create mode 100644 unit_tests/__init__.py create mode 100644 unit_tests/__init__.pyc create mode 100644 unit_tests/test_designate_bind_handlers.py create mode 100644 unit_tests/test_designate_handlers.pyc create mode 100644 unit_tests/test_lib_charm_openstack_designate_bind.py diff --git a/.gitignore b/.gitignore index 3be251e..62ff2fa 100644 --- a/.gitignore +++ b/.gitignore @@ -3,3 +3,5 @@ tmp build layers interfaces +__pycache__ +.testrepository diff --git a/.testr.conf b/.testr.conf new file mode 100644 index 0000000..801646b --- /dev/null +++ b/.testr.conf @@ -0,0 +1,8 @@ +[DEFAULT] +test_command=OS_STDOUT_CAPTURE=${OS_STDOUT_CAPTURE:-1} \ + OS_STDERR_CAPTURE=${OS_STDERR_CAPTURE:-1} \ + OS_TEST_TIMEOUT=${OS_TEST_TIMEOUT:-60} \ + ${PYTHON:-python} -m subunit.run discover -t ./ ./unit_tests $LISTOPT $IDOPTION + +test_id_option=--load-list $IDFILE +test_list_option=--list diff --git a/requirements.txt b/requirements.txt index 1deddba..39e3263 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,3 +1,5 @@ +# Requirements to build the charm charm-tools -flake8 ruamel.yaml==0.10.12 +simplejson +flake8 diff --git a/charm/config.yaml b/src/config.yaml similarity index 100% rename from charm/config.yaml rename to src/config.yaml diff --git a/charm/layer.yaml b/src/layer.yaml similarity index 100% rename from charm/layer.yaml rename to src/layer.yaml diff --git a/charm/lib/charm/openstack/designate_bind.py b/src/lib/charm/openstack/designate_bind.py similarity index 97% rename from charm/lib/charm/openstack/designate_bind.py rename to src/lib/charm/openstack/designate_bind.py index 9e34a35..51664ca 100644 --- a/charm/lib/charm/openstack/designate_bind.py +++ b/src/lib/charm/openstack/designate_bind.py @@ -19,7 +19,7 @@ LEADERDB_SYNC_SRC_KEY = 'sync_src' LEADERDB_SYNC_TIME_KEY = 'sync_time' CLUSTER_SYNC_KEY = 'sync_request' WWW_DIR = '/var/www/html' -ZONE_DIR = '/var/cache/bind/' +ZONE_DIR = '/var/cache/bind' def install(): @@ -311,6 +311,18 @@ class DesignateBindCharm(openstack_charm.OpenStackCharm): cmd.extend(zone_files) subprocess.check_call(cmd, cwd=ZONE_DIR) + def setup_sync_dir(self, sync_time): + sync_dir = '{}/zone-syncs'.format(WWW_DIR, sync_time) + try: + os.mkdir(sync_dir, 0o755) + except FileExistsError: + os.chmod(sync_dir, 0o755) + + def create_sync_src_info_file(self): + unit_name = hookenv.local_unit().replace('/', '_') + touch_file = '{}/juju-zone-src-{}'.format(ZONE_DIR, unit_name) + open(touch_file, 'w+').close() + def setup_sync(self): """Setup a sync target @@ -321,14 +333,8 @@ class DesignateBindCharm(openstack_charm.OpenStackCharm): """ hookenv.log('Setting up zone info for collection', level=hookenv.DEBUG) sync_time = str(time.time()) - sync_dir = '{}/zone-syncs'.format(WWW_DIR, sync_time) - try: - os.mkdir(sync_dir, 0o755) - except FileExistsError: - os.chmod(sync_dir, 0o755) - unit_name = hookenv.local_unit().replace('/', '_') - touch_file = '{}/juju-zone-src-{}'.format(ZONE_DIR, unit_name) - open(touch_file, 'w+').close() + sync_dir = self.setup_sync_dir(sync_time) + self.create_sync_src_info_file() # FIXME Try freezing DNS rather than stopping bind self.service_control('stop', ['bind9']) tar_file = '{}/{}.tar.gz'.format(sync_dir, sync_time) @@ -348,7 +354,7 @@ class DesignateBindCharm(openstack_charm.OpenStackCharm): 'start': host.service_start, 'restart': host.service_restart, } - for service in self.services: + for service in services: cmds[cmd](service) def request_sync(self, hacluster): @@ -373,6 +379,7 @@ class DesignateBindCharm(openstack_charm.OpenStackCharm): :param target_dir: Place file in this directory :returns: None """ + print("{} {}".format(url, target_dir)) cmd = ['wget', url, '--retry-connrefused', '-t', '10'] subprocess.check_call(cmd, cwd=target_dir) @@ -388,6 +395,7 @@ class DesignateBindCharm(openstack_charm.OpenStackCharm): :returns: None """ + request_time = None if cluster_relation: request_time = cluster_relation.retrieve_local(CLUSTER_SYNC_KEY) sync_time = DesignateBindCharm.get_sync_time() diff --git a/charm/metadata.yaml b/src/metadata.yaml similarity index 100% rename from charm/metadata.yaml rename to src/metadata.yaml diff --git a/charm/reactive/designate_bind_handlers.py b/src/reactive/designate_bind_handlers.py similarity index 100% rename from charm/reactive/designate_bind_handlers.py rename to src/reactive/designate_bind_handlers.py diff --git a/charm/templates/named.conf b/src/templates/named.conf similarity index 100% rename from charm/templates/named.conf rename to src/templates/named.conf diff --git a/charm/templates/named.conf.options b/src/templates/named.conf.options similarity index 100% rename from charm/templates/named.conf.options rename to src/templates/named.conf.options diff --git a/charm/templates/rndc.key b/src/templates/rndc.key similarity index 100% rename from charm/templates/rndc.key rename to src/templates/rndc.key diff --git a/test-requirements.txt b/test-requirements.txt new file mode 100644 index 0000000..41b4231 --- /dev/null +++ b/test-requirements.txt @@ -0,0 +1,7 @@ +# Unit test requirements +flake8>=2.2.4,<=2.4.1 +os-testr>=0.4.1 +charms.reactive +mock>=1.2 +coverage>=3.6 +git+https://github.com/gnuoy/charms.openstack.git@bug/general#egg=charms.openstack diff --git a/tox.ini b/tox.ini index 15f69d9..615ecfc 100644 --- a/tox.ini +++ b/tox.ini @@ -1,8 +1,10 @@ [tox] skipsdist = True -envlist = generate +envlist = pep8,py34,py35 +skip_missing_interpreters = True [testenv] +basepython = python2.7 setenv = VIRTUAL_ENV={envdir} PYTHONHASHSEED=0 TERM=linux @@ -13,16 +15,29 @@ passenv = http_proxy https_proxy install_command = pip install {opts} {packages} deps = - -r{toxinidir}/requirements.txt + -r{toxinidir}/requirements.txt -[testenv:generate] -basepython = python2.7 +[testenv:build] commands = - charm build --log-level DEBUG -o {toxinidir}/build charm + charm-build --log-level DEBUG -o {toxinidir}/build src [testenv:venv] commands = {posargs} -[testenv:lint] +[testenv:pep8] +commands = flake8 {posargs} src/reactive src/lib unit_tests + +[testenv:py27] basepython = python2.7 -commands = flake8 {posargs} charm/reactive +deps = -r{toxinidir}/test-requirements.txt +commands = ostestr {posargs} + +[testenv:py34] +basepython = python3.4 +deps = -r{toxinidir}/test-requirements.txt +commands = ostestr {posargs} + +[testenv:py35] +basepython = python3.5 +deps = -r{toxinidir}/test-requirements.txt +commands = ostestr {posargs} diff --git a/unit_tests/__init__.py b/unit_tests/__init__.py new file mode 100644 index 0000000..604856b --- /dev/null +++ b/unit_tests/__init__.py @@ -0,0 +1,56 @@ +# Copyright 2016 Canonical 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. + +import sys +import mock + +sys.path.append('src') +sys.path.append('src/lib') + +# Mock out charmhelpers so that we can test without it. +# also stops sideeffects from occuring. +charmhelpers = mock.MagicMock() +sys.modules['charmhelpers'] = charmhelpers +sys.modules['charmhelpers.core'] = charmhelpers.core +sys.modules['charmhelpers.core.hookenv'] = charmhelpers.core.hookenv +sys.modules['charmhelpers.core.decorators'] = charmhelpers.core.decorators +sys.modules['charmhelpers.core.host'] = charmhelpers.core.host +sys.modules['charmhelpers.core.unitdata'] = charmhelpers.core.unitdata +sys.modules['charmhelpers.core.templating'] = charmhelpers.core.templating +sys.modules['charmhelpers.contrib'] = charmhelpers.contrib +sys.modules['charmhelpers.contrib.openstack'] = charmhelpers.contrib.openstack +sys.modules['charmhelpers.contrib.openstack.utils'] = ( + charmhelpers.contrib.openstack.utils) +sys.modules['charmhelpers.contrib.openstack.templating'] = ( + charmhelpers.contrib.openstack.templating) +sys.modules['charmhelpers.contrib.network'] = charmhelpers.contrib.network +sys.modules['charmhelpers.contrib.network.ip'] = ( + charmhelpers.contrib.network.ip) +sys.modules['charmhelpers.fetch'] = charmhelpers.fetch +sys.modules['charmhelpers.cli'] = charmhelpers.cli +sys.modules['charmhelpers.contrib.hahelpers'] = charmhelpers.contrib.hahelpers +sys.modules['charmhelpers.contrib.hahelpers.cluster'] = ( + charmhelpers.contrib.hahelpers.cluster) + + +def _fake_retry(num_retries, base_delay=0, exc_type=Exception): + def _retry_on_exception_inner_1(f): + def _retry_on_exception_inner_2(*args, **kwargs): + return f(*args, **kwargs) + return _retry_on_exception_inner_2 + return _retry_on_exception_inner_1 + +mock.patch( + 'charmhelpers.core.decorators.retry_on_exception', + _fake_retry).start() diff --git a/unit_tests/__init__.pyc b/unit_tests/__init__.pyc new file mode 100644 index 0000000000000000000000000000000000000000..009b374214d1b92cf4f912f417761d0ba5ceec9c GIT binary patch literal 1290 zcmaiz&5qMB5XbHGyPIy)cBuqHa6zbC5^=8(FR&cofV7t?o0!IFzLc4Qmg_zQ56T0; z*ojS4T5Xyp{{K8Poe#J7dp3=J{rnoS_Uh65BYmOfjKy?wmN9l`*PPvPCKyW{miAce zut(1LKiz9IXK9~3lHY&{y2*UV;y&AwNJmBwj84Y}4K11&G_q)F(Ac6YgC-4fjh-5v z&J4Qhp!C{Mw@YofnWb}Mc-=v%XXw143!}Y8FO6PUua!Z|4oYtfU9l~-`pf2qdN2Rb z^$FD|ppIbFyn{^Mqf6^33F|x&StV+K#R>4EvKH|C9QBj3Jc!~utS{^W!i%$8$3kKp zVhAtKZllPnEJRuCL8af#kJ2fymiO@L!iHZ~q5uq|1H5_C#6P0U0Ny=q*h%S3&N?N( z5cs345Aga@xYodz6)aC}z6p#H@J?}*$;+iCp_$s-|NNRZ`PRgbvLm3VH_ynlISLPe zeG+*Y9rU6KF~K2`u%aHuIHBcjxR=o_S$w9yFGF>7@-jYVqVZLSL&Nqc=r~CUh-0!e zW5%iSwL{eo?Hu)w*pcBtd8wIbo3>x*5S5kQ)NRt~Q)jfZt*{B(R!JUgV;}IImO)bH zf)0I{2Uv%)2x0+pUxX+EmFNzsCJ1&rsl?8&9&`=crrZy6iU2C2%U#FgUf<<2?(tRo Np_Q|C*6K-AslUaBOFIAn literal 0 HcmV?d00001 diff --git a/unit_tests/test_designate_bind_handlers.py b/unit_tests/test_designate_bind_handlers.py new file mode 100644 index 0000000..8956c6e --- /dev/null +++ b/unit_tests/test_designate_bind_handlers.py @@ -0,0 +1,225 @@ +from __future__ import absolute_import +from __future__ import print_function + +import unittest + +import mock + +import reactive.designate_bind_handlers as handlers + + +_when_args = {} +_when_not_args = {} + + +def mock_hook_factory(d): + + 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. + try: + d[f.__name__].append(dict(args=args, kwargs=kwargs)) + except KeyError: + d[f.__name__] = [dict(args=args, kwargs=kwargs)] + return f + return inner + return mock_hook + + +class TestDesignateHandlers(unittest.TestCase): + + @classmethod + def setUpClass(cls): + cls._patched_when = mock.patch('charms.reactive.when', + mock_hook_factory(_when_args)) + cls._patched_when_started = cls._patched_when.start() + cls._patched_when_not = mock.patch('charms.reactive.when_not', + mock_hook_factory(_when_not_args)) + cls._patched_when_not_started = cls._patched_when_not.start() + # force requires to rerun the mock_hook decorator: + # try except is Python2/Python3 compatibility as Python3 has moved + # reload to importlib. + try: + reload(handlers) + except NameError: + import importlib + importlib.reload(handlers) + + @classmethod + def tearDownClass(cls): + cls._patched_when.stop() + cls._patched_when_started = None + cls._patched_when = None + cls._patched_when_not.stop() + cls._patched_when_not_started = None + cls._patched_when_not = None + # and fix any breakage we did to the module + try: + reload(handlers) + except NameError: + import importlib + importlib.reload(handlers) + + def setUp(self): + self._patches = {} + self._patches_start = {} + + def tearDown(self): + for k, v in self._patches.items(): + v.stop() + setattr(self, k, None) + self._patches = None + self._patches_start = None + + def patch(self, obj, attr, return_value=None): + mocked = mock.patch.object(obj, attr) + self._patches[attr] = mocked + started = mocked.start() + started.return_value = return_value + self._patches_start[attr] = started + setattr(self, attr, started) + + 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. + when_patterns = { + 'setup_sync_target_alone': [('installed', )], + 'send_info': [ + ('dns-backend.related', ), + ('rndckey.available', ), + ], + 'config_changed': [ + ('dns-backend.related', ), + ('rndckey.available', ), + ], + 'update_zones_from_peer': [ + ('cluster.connected', ), + ('sync.request.sent', ), + ], + 'check_zone_status': [ + ('cluster.connected', ), + ('installed', ), + ], + 'process_sync_requests': [ + ('cluster.connected', ), + ('zones.initialised', ), + ], + } + when_not_patterns = { + 'install_packages': [('installed', )], + 'setup_secret': [('rndckey.available', )], + 'update_zones_from_peer': [('zones.initialised', )], + 'setup_sync_target_alone': [ + ('cluster.connected', ), + ('zones.initialised', ), + ('sync.request.sent', ), + ], + 'check_zone_status': [ + ('zones.initialised', ), + ('sync.request.sent', ), + ], + } + # check the when hooks are attached to the expected functions + for t, p in [(_when_args, when_patterns), + (_when_not_args, when_not_patterns)]: + for f, args in t.items(): + # check that function is in patterns + self.assertTrue(f in p.keys()) + # check that the lists are equal + l = [a['args'] for a in args] + self.assertEqual(l, p[f]) + + def test_install_packages(self): + self.patch(handlers.designate_bind, 'install') + self.patch(handlers.designate_bind, 'set_apparmor') + self.patch(handlers.reactive, 'set_state') + handlers.install_packages() + self.install.assert_called_once_with() + self.set_apparmor.assert_called_once_with() + self.set_state.assert_called_once_with('installed') + + def test_setup_secret(self): + self.patch(handlers.designate_bind, 'init_rndckey') + self.patch(handlers.reactive, 'set_state') + self.init_rndckey.return_value = None + handlers.setup_secret() + self.assertFalse(self.set_state.called) + self.init_rndckey.return_value = 'secret' + handlers.setup_secret() + self.set_state.assert_called_with('rndckey.available') + + def test_setup_info(self): + dnsclient = mock.MagicMock() + self.patch(handlers.designate_bind, 'get_rndc_secret') + self.patch(handlers.designate_bind, 'get_rndc_algorithm') + self.get_rndc_secret.return_value = 'secret' + self.get_rndc_algorithm.return_value = 'hmac-md5' + handlers.send_info(dnsclient) + dnsclient.send_rndckey_info.assert_called_once_with( + 'secret', + 'hmac-md5') + + def test_config_changed(self): + self.patch(handlers.designate_bind, 'set_apparmor') + self.patch(handlers.designate_bind, 'render_all_configs') + handlers.config_changed('arg1', 'arg2') + self.set_apparmor.assert_called_once_with() + self.render_all_configs.assert_called_once_with(('arg1', 'arg2', )) + + def test_setup_sync_target_alone(self): + self.patch(handlers.hookenv, 'is_leader') + self.patch(handlers.designate_bind, 'setup_sync') + self.patch(handlers.reactive, 'set_state') + self.is_leader.return_value = False + handlers.setup_sync_target_alone() + self.assertFalse(self.setup_sync.called) + self.assertFalse(self.set_state.called) + self.is_leader.return_value = True + handlers.setup_sync_target_alone() + self.setup_sync.assert_called_once_with() + self.set_state.assert_called_once_with('zones.initialised') + + def test_update_zones_from_peer(self): + self.patch(handlers.designate_bind, 'retrieve_zones') + handlers.update_zones_from_peer('hacluster') + self.retrieve_zones.assert_called_once_with('hacluster') + + def test_check_zone_status(self): + self.patch(handlers.hookenv, 'is_leader') + self.patch(handlers.reactive, 'set_state') + self.patch(handlers.designate_bind, 'get_sync_time') + self.patch(handlers.designate_bind, 'retrieve_zones') + self.patch(handlers.designate_bind, 'setup_sync') + self.patch(handlers.designate_bind, 'request_sync') + # Leader test: Retrieve sync + self.is_leader.return_value = True + self.get_sync_time.return_value = 100 + handlers.check_zone_status('hacluster') + self.retrieve_zones.assert_called_once_with() + self.retrieve_zones.reset_mock() + # Leader test: Setup sync + self.is_leader.return_value = True + self.get_sync_time.return_value = None + handlers.check_zone_status('hacluster') + self.assertFalse(self.retrieve_zones.called) + self.setup_sync.assert_called_once_with() + self.set_state.assert_called_once_with('zones.initialised') + # Non-Leader test + self.is_leader.return_value = False + handlers.check_zone_status('hacluster') + self.request_sync.assert_called_once_with('hacluster') + + def test_process_sync_requests(self): + self.patch(handlers.hookenv, 'is_leader') + self.patch(handlers.designate_bind, 'process_requests') + self.is_leader.return_value = False + handlers.process_sync_requests('hacluster') + self.assertFalse(self.process_requests.called) + self.process_requests.reset_mock() + self.is_leader.return_value = True + handlers.process_sync_requests('hacluster') + self.process_requests.assert_called_once_with('hacluster') diff --git a/unit_tests/test_designate_handlers.pyc b/unit_tests/test_designate_handlers.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5d70fdb75dbc8e1618482623b1d12dfc655bbd7f GIT binary patch literal 6567 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