# -*- coding: utf-8 -*- # vim: autoindent shiftwidth=4 expandtab textwidth=120 tabstop=4 softtabstop=4 ############################################################################### # OpenLP - Open Source Lyrics Projection # # --------------------------------------------------------------------------- # # Copyright (c) 2008-2017 OpenLP Developers # # --------------------------------------------------------------------------- # # 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; version 2 of the License. # # # # 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, write to the Free Software Foundation, Inc., 59 # # Temple Place, Suite 330, Boston, MA 02111-1307 USA # ############################################################################### import os import sys from unittest import TestCase, skip from unittest.mock import MagicMock, patch from PyQt5 import QtCore, QtWidgets from openlp.core.app import OpenLP, parse_options from openlp.core.common.settings import Settings TEST_PATH = os.path.abspath(os.path.join(os.path.dirname(__file__), '..', 'resources')) def test_parse_options_basic(): """ Test the parse options process works """ # GIVEN: a a set of system arguments. sys.argv[1:] = [] # WHEN: We we parse them to expand to options args = parse_options(None) # THEN: the following fields will have been extracted. assert args.dev_version is False, 'The dev_version flag should be False' assert args.loglevel == 'warning', 'The log level should be set to warning' assert args.no_error_form is False, 'The no_error_form should be set to False' assert args.portable is False, 'The portable flag should be set to false' assert args.style is None, 'There are no style flags to be processed' assert args.rargs == [], 'The service file should be blank' def test_parse_options_debug(): """ Test the parse options process works for debug only """ # GIVEN: a a set of system arguments. sys.argv[1:] = ['-l debug'] # WHEN: We we parse them to expand to options args = parse_options(None) # THEN: the following fields will have been extracted. assert args.dev_version is False, 'The dev_version flag should be False' assert args.loglevel == ' debug', 'The log level should be set to debug' assert args.no_error_form is False, 'The no_error_form should be set to False' assert args.portable is False, 'The portable flag should be set to false' assert args.style is None, 'There are no style flags to be processed' assert args.rargs == [], 'The service file should be blank' def test_parse_options_debug_and_portable(): """ Test the parse options process works for debug and portable """ # GIVEN: a a set of system arguments. sys.argv[1:] = ['--portable'] # WHEN: We we parse them to expand to options args = parse_options(None) # THEN: the following fields will have been extracted. assert args.dev_version is False, 'The dev_version flag should be False' assert args.loglevel == 'warning', 'The log level should be set to warning' assert args.no_error_form is False, 'The no_error_form should be set to False' assert args.portable is True, 'The portable flag should be set to true' assert args.style is None, 'There are no style flags to be processed' assert args.rargs == [], 'The service file should be blank' def test_parse_options_all_no_file(): """ Test the parse options process works with two options """ # GIVEN: a a set of system arguments. sys.argv[1:] = ['-l debug', '-d'] # WHEN: We we parse them to expand to options args = parse_options(None) # THEN: the following fields will have been extracted. assert args.dev_version is True, 'The dev_version flag should be True' assert args.loglevel == ' debug', 'The log level should be set to debug' assert args.no_error_form is False, 'The no_error_form should be set to False' assert args.portable is False, 'The portable flag should be set to false' assert args.style is None, 'There are no style flags to be processed' assert args.rargs == [], 'The service file should be blank' def test_parse_options_file(): """ Test the parse options process works with a file """ # GIVEN: a a set of system arguments. sys.argv[1:] = ['dummy_temp'] # WHEN: We we parse them to expand to options args = parse_options(None) # THEN: the following fields will have been extracted. assert args.dev_version is False, 'The dev_version flag should be False' assert args.loglevel == 'warning', 'The log level should be set to warning' assert args.no_error_form is False, 'The no_error_form should be set to False' assert args.portable is False, 'The portable flag should be set to false' assert args.style is None, 'There are no style flags to be processed' assert args.rargs == 'dummy_temp', 'The service file should not be blank' def test_parse_options_file_and_debug(): """ Test the parse options process works with a file and the debug log level """ # GIVEN: a a set of system arguments. sys.argv[1:] = ['-l debug', 'dummy_temp'] # WHEN: We we parse them to expand to options args = parse_options(None) # THEN: the following fields will have been extracted. assert args.dev_version is False, 'The dev_version flag should be False' assert args.loglevel == ' debug', 'The log level should be set to debug' assert args.no_error_form is False, 'The no_error_form should be set to False' assert args.portable is False, 'The portable flag should be set to false' assert args.style is None, 'There are no style flags to be processed' assert args.rargs == 'dummy_temp', 'The service file should not be blank' @skip('Figure out why this is causing a segfault') class TestOpenLP(TestCase): """ Test the OpenLP app class """ def setUp(self): self.build_settings() self.qapplication_patcher = patch('openlp.core.app.QtGui.QApplication') self.mocked_qapplication = self.qapplication_patcher.start() self.openlp = OpenLP([]) def tearDown(self): self.qapplication_patcher.stop() self.destroy_settings() del self.openlp self.openlp = None def test_exec(self): """ Test the exec method """ # GIVEN: An app self.openlp.shared_memory = MagicMock() self.mocked_qapplication.exec.return_value = False # WHEN: exec() is called result = self.openlp.exec() # THEN: The right things should be called assert self.openlp.is_event_loop_active is True self.mocked_qapplication.exec.assert_called_once_with() self.openlp.shared_memory.detach.assert_called_once_with() assert result is False @patch('openlp.core.app.QtCore.QSharedMemory') def test_is_already_running_not_running(self, MockedSharedMemory): """ Test the is_already_running() method when OpenLP is NOT running """ # GIVEN: An OpenLP app and some mocks mocked_shared_memory = MagicMock() mocked_shared_memory.attach.return_value = False MockedSharedMemory.return_value = mocked_shared_memory # WHEN: is_already_running() is called result = self.openlp.is_already_running() # THEN: The result should be false MockedSharedMemory.assert_called_once_with('OpenLP') mocked_shared_memory.attach.assert_called_once_with() mocked_shared_memory.create.assert_called_once_with(1) assert result is False @patch('openlp.core.app.QtWidgets.QMessageBox.critical') @patch('openlp.core.app.QtWidgets.QMessageBox.StandardButtons') @patch('openlp.core.app.QtCore.QSharedMemory') def test_is_already_running_is_running_continue(self, MockedSharedMemory, MockedStandardButtons, mocked_critical): """ Test the is_already_running() method when OpenLP IS running and the user chooses to continue """ # GIVEN: An OpenLP app and some mocks mocked_shared_memory = MagicMock() mocked_shared_memory.attach.return_value = True MockedSharedMemory.return_value = mocked_shared_memory MockedStandardButtons.return_value = 0 mocked_critical.return_value = QtWidgets.QMessageBox.Yes # WHEN: is_already_running() is called result = self.openlp.is_already_running() # THEN: The result should be false MockedSharedMemory.assert_called_once_with('OpenLP') mocked_shared_memory.attach.assert_called_once_with() MockedStandardButtons.assert_called_once_with(QtWidgets.QMessageBox.Yes | QtWidgets.QMessageBox.No) mocked_critical.assert_called_once_with(None, 'Error', 'OpenLP is already running. Do you wish to continue?', 0) assert result is False @patch('openlp.core.app.QtWidgets.QMessageBox.critical') @patch('openlp.core.app.QtWidgets.QMessageBox.StandardButtons') @patch('openlp.core.app.QtCore.QSharedMemory') def test_is_already_running_is_running_stop(self, MockedSharedMemory, MockedStandardButtons, mocked_critical): """ Test the is_already_running() method when OpenLP IS running and the user chooses to stop """ # GIVEN: An OpenLP app and some mocks mocked_shared_memory = MagicMock() mocked_shared_memory.attach.return_value = True MockedSharedMemory.return_value = mocked_shared_memory MockedStandardButtons.return_value = 0 mocked_critical.return_value = QtWidgets.QMessageBox.No # WHEN: is_already_running() is called result = self.openlp.is_already_running() # THEN: The result should be false MockedSharedMemory.assert_called_once_with('OpenLP') mocked_shared_memory.attach.assert_called_once_with() MockedStandardButtons.assert_called_once_with(QtWidgets.QMessageBox.Yes | QtWidgets.QMessageBox.No) mocked_critical.assert_called_once_with(None, 'Error', 'OpenLP is already running. Do you wish to continue?', 0) assert result is True def test_process_events(self): """ Test that the app.process_events() method simply calls the Qt method """ # GIVEN: An app # WHEN: process_events() is called with patch.object(self.openlp, 'processEvents') as mocked_processEvents: self.openlp.process_events() # THEN: processEvents was called mocked_processEvents.assert_called_once_with() def test_set_busy_cursor(self): """ Test that the set_busy_cursor() method sets the cursor """ # GIVEN: An app # WHEN: set_busy_cursor() is called with patch.object(self.openlp, 'setOverrideCursor') as mocked_setOverrideCursor, \ patch.object(self.openlp, 'processEvents') as mocked_processEvents: self.openlp.set_busy_cursor() # THEN: The cursor should have been set mocked_setOverrideCursor.assert_called_once_with(QtCore.Qt.BusyCursor) mocked_processEvents.assert_called_once_with() def test_set_normal_cursor(self): """ Test that the set_normal_cursor() method resets the cursor """ # GIVEN: An app # WHEN: set_normal_cursor() is called with patch.object(self.openlp, 'restoreOverrideCursor') as mocked_restoreOverrideCursor, \ patch.object(self.openlp, 'processEvents') as mocked_processEvents: self.openlp.set_normal_cursor() # THEN: The cursor should have been set mocked_restoreOverrideCursor.assert_called_once_with() mocked_processEvents.assert_called_once_with() def test_event(self): """ Test the reimplemented event method """ # GIVEN: A file path and a QEvent. file_path = os.path.join(TEST_PATH, 'church.jpg') mocked_file_method = MagicMock(return_value=file_path) event = QtCore.QEvent(QtCore.QEvent.FileOpen) event.file = mocked_file_method # WHEN: Call the vent method. result = self.openlp.event(event) # THEN: The path should be inserted. self.assertTrue(result, "The method should have returned True.") mocked_file_method.assert_called_once_with() self.assertEqual(self.openlp.args[0], file_path, "The path should be in args.") @patch('openlp.core.app.is_macosx') def test_application_activate_event(self, mocked_is_macosx): """ Test that clicking on the dock icon on Mac OS X restores the main window if it is minimized """ # GIVEN: Mac OS X and an ApplicationActivate event mocked_is_macosx.return_value = True event = MagicMock() event.type.return_value = QtCore.QEvent.ApplicationActivate mocked_main_window = MagicMock() self.openlp.main_window = mocked_main_window # WHEN: The icon in the dock is clicked result = self.openlp.event(event) # THEN: self.assertTrue(result, "The method should have returned True.") # self.assertFalse(self.openlp.main_window.isMinimized()) @patch('openlp.core.app.get_version') @patch('openlp.core.app.QtWidgets.QMessageBox.question') def test_backup_on_upgrade_first_install(self, mocked_question, mocked_get_version): """ Test that we don't try to backup on a new install """ # GIVEN: Mocked data version and OpenLP version which are the same old_install = False MOCKED_VERSION = { 'full': '2.2.0-bzr000', 'version': '2.2.0', 'build': 'bzr000' } Settings().setValue('core/application version', '2.2.0') mocked_get_version.return_value = MOCKED_VERSION mocked_question.return_value = QtWidgets.QMessageBox.No # WHEN: We check if a backup should be created self.openlp.backup_on_upgrade(old_install, False) # THEN: It should not ask if we want to create a backup self.assertEqual(Settings().value('core/application version'), '2.2.0', 'Version should be the same!') self.assertEqual(mocked_question.call_count, 0, 'No question should have been asked!') @patch('openlp.core.app.get_version') @patch('openlp.core.app.QtWidgets.QMessageBox.question') def test_backup_on_upgrade(self, mocked_question, mocked_get_version): """ Test that we try to backup on a new install """ # GIVEN: Mocked data version and OpenLP version which are different old_install = True MOCKED_VERSION = { 'full': '2.2.0-bzr000', 'version': '2.2.0', 'build': 'bzr000' } Settings().setValue('core/application version', '2.0.5') self.openlp.splash = MagicMock() self.openlp.splash.isVisible.return_value = True mocked_get_version.return_value = MOCKED_VERSION mocked_question.return_value = QtWidgets.QMessageBox.No # WHEN: We check if a backup should be created self.openlp.backup_on_upgrade(old_install, True) # THEN: It should ask if we want to create a backup self.assertEqual(Settings().value('core/application version'), '2.2.0', 'Version should be upgraded!') self.assertEqual(mocked_question.call_count, 1, 'A question should have been asked!') self.openlp.splash.hide.assert_called_once_with() self.openlp.splash.show.assert_called_once_with()