forked from openlp/openlp
366 lines
16 KiB
Python
366 lines
16 KiB
Python
# -*- 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()
|