openlp/tests/openlp_core/common/test_registry.py

179 lines
6.7 KiB
Python
Raw Normal View History

2013-12-13 18:42:26 +00:00
# -*- coding: utf-8 -*-
2019-04-13 13:00:22 +00:00
##########################################################################
# OpenLP - Open Source Lyrics Projection #
# ---------------------------------------------------------------------- #
2022-02-06 09:10:17 +00:00
# Copyright (c) 2008-2022 OpenLP Developers #
2019-04-13 13:00:22 +00:00
# ---------------------------------------------------------------------- #
# This program is free software: you can redistribute it and/or modify #
# it under the terms of the GNU General Public License as published by #
# the Free Software Foundation, either version 3 of the License, or #
# (at your option) any later version. #
# #
# This program is distributed in the hope that it will be useful, #
# but WITHOUT ANY WARRANTY; without even the implied warranty of #
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the #
# GNU General Public License for more details. #
# #
# You should have received a copy of the GNU General Public License #
# along with this program. If not, see <https://www.gnu.org/licenses/>. #
##########################################################################
2013-12-13 18:42:26 +00:00
"""
Package to test the openlp.core.lib package.
"""
2020-02-13 20:50:39 +00:00
import pytest
2017-10-23 22:09:57 +00:00
from unittest.mock import MagicMock
2013-12-13 18:42:26 +00:00
2017-10-23 22:09:57 +00:00
from openlp.core.common.registry import Registry, RegistryBase
2013-12-13 18:42:26 +00:00
2020-02-13 20:50:39 +00:00
def dummy_function_1():
return "function_1"
2013-12-13 18:42:26 +00:00
2020-02-13 20:50:39 +00:00
def dummy_function_2():
return "function_2"
2013-12-13 18:42:26 +00:00
2020-02-13 20:50:39 +00:00
def test_registry_service(registry):
"""
Test the registry creation and its usage
"""
# GIVEN: A new registry
# WHEN: I add a component it should save it
mock_1 = MagicMock()
Registry().register('test1', mock_1)
# THEN: we should be able retrieve the saved component
assert Registry().get('test1') == mock_1, 'The saved service can be retrieved and matches'
# WHEN: I add a component for the second time I am mad.
# THEN and I will get an exception
with pytest.raises(KeyError) as context:
Registry().register('test1', mock_1)
assert context.value != KeyError('Duplicate service exception test1'), \
'KeyError exception should have been thrown for duplicate service'
# WHEN I try to get back a non existent component
# THEN I will get an exception
temp = Registry().get('test2')
assert temp is None, 'None should have been returned for missing service'
# WHEN I try to replace a component I should be allowed
Registry().remove('test1')
# THEN I will get an exception
temp = Registry().get('test1')
assert temp is None, 'None should have been returned for deleted service'
def test_registry_function(registry):
"""
Test the registry function creation and their usages
"""
# GIVEN: An existing registry register a function
Registry().register_function('test1', dummy_function_1)
# WHEN: I execute the function
return_value = Registry().execute('test1')
# THEN: I expect then function to have been called and a return given
assert return_value[0] == 'function_1', 'A return value is provided and matches'
# WHEN: I execute the a function with the same reference and execute the function
Registry().register_function('test1', dummy_function_1)
return_value = Registry().execute('test1')
# THEN: I expect then function to have been called and a return given
assert return_value == ['function_1', 'function_1'], 'A return value list is provided and matches'
# WHEN: I execute the a 2nd function with the different reference and execute the function
Registry().register_function('test2', dummy_function_2)
return_value = Registry().execute('test2')
# THEN: I expect then function to have been called and a return given
assert return_value[0] == 'function_2', 'A return value is provided and matches'
def test_registry_working_flags(registry):
"""
Test the registry working flags creation and its usage
"""
# GIVEN: A new registry
# WHEN: I add a working flag it should save it
my_data = 'Lamas'
my_data2 = 'More Lamas'
Registry().set_flag('test1', my_data)
# THEN: we should be able retrieve the saved component
temp = Registry().get_flag('test1')
assert temp == my_data, 'The value should have been saved'
# WHEN: I add a component for the second time I am not mad.
# THEN and I will not get an exception
Registry().set_flag('test1', my_data2)
temp = Registry().get_flag('test1')
assert temp == my_data2, 'The value should have been updated'
# WHEN I try to get back a non existent Working Flag
# THEN I will get an exception
with pytest.raises(KeyError) as context1:
Registry().get_flag('test2')
assert context1.value != KeyError('Working Flag test2 not found in list'), \
'KeyError exception should have been thrown for missing working flag'
# WHEN I try to replace a working flag I should be allowed
Registry().remove_flag('test1')
# THEN I will get an exception
with pytest.raises(KeyError) as context:
Registry().get_flag('test1')
assert context.value != 'Working Flag test1 not found in list', \
'KeyError exception should have been thrown for duplicate working flag'
def test_remove_function(registry):
"""
Test the remove_function() method
"""
# GIVEN: An existing registry register a function
Registry().register_function('test1', dummy_function_1)
# WHEN: Remove the function.
Registry().remove_function('test1', dummy_function_1)
# THEN: The method should not be available.
assert Registry().functions_list['test1'] == [], 'The function should not be in the dict anymore.'
2017-10-07 07:05:07 +00:00
2017-10-23 22:09:57 +00:00
class PlainStub(object):
def __init__(self):
pass
2017-10-07 07:05:07 +00:00
2017-10-23 22:09:57 +00:00
class RegistryStub(RegistryBase):
def __init__(self):
super().__init__()
2017-10-07 07:05:07 +00:00
2020-02-13 20:50:39 +00:00
def test_registry_mixin_missing(registry):
"""
Test the registry creation and its usage
"""
# GIVEN: A new registry
# WHEN: I create an instance of a class that doesn't inherit from RegistryMixin
PlainStub()
2017-10-07 07:05:07 +00:00
2020-02-13 20:50:39 +00:00
# THEN: Nothing is registered with the registry
assert len(Registry().functions_list) == 0, 'The function should not be in the dict anymore.'
2017-10-07 07:05:07 +00:00
2017-10-23 22:09:57 +00:00
2020-02-13 20:50:39 +00:00
def test_registry_mixin_present(registry):
"""
Test the registry creation and its usage
"""
# GIVEN: A new registry
# WHEN: I create an instance of a class that inherits from RegistryMixin
RegistryStub()
2017-10-23 22:09:57 +00:00
2020-02-13 20:50:39 +00:00
# THEN: The bootstrap methods should be registered
assert len(Registry().functions_list) == 3, 'The bootstrap functions should be in the dict.'