forked from openlp/openlp
389 lines
17 KiB
Python
389 lines
17 KiB
Python
# -*- coding: utf-8 -*-
|
|
# vim: autoindent shiftwidth=4 expandtab textwidth=120 tabstop=4 softtabstop=4
|
|
|
|
###############################################################################
|
|
# OpenLP - Open Source Lyrics Projection #
|
|
# --------------------------------------------------------------------------- #
|
|
# Copyright (c) 2008-2015 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 #
|
|
###############################################################################
|
|
|
|
"""
|
|
The :mod:`core` module provides all core application functions
|
|
|
|
All the core functions of the OpenLP application including the GUI, settings,
|
|
logging and a plugin framework are contained within the openlp.core module.
|
|
"""
|
|
|
|
import os
|
|
import sys
|
|
import logging
|
|
from optparse import OptionParser
|
|
from traceback import format_exception
|
|
import shutil
|
|
import time
|
|
from PyQt4 import QtCore, QtGui
|
|
|
|
from openlp.core.common import Registry, OpenLPMixin, AppLocation, Settings, UiStrings, check_directory_exists, \
|
|
is_macosx, is_win, translate
|
|
from openlp.core.lib import ScreenList
|
|
from openlp.core.resources import qInitResources
|
|
from openlp.core.ui.mainwindow import MainWindow
|
|
from openlp.core.ui.firsttimelanguageform import FirstTimeLanguageForm
|
|
from openlp.core.ui.firsttimeform import FirstTimeForm
|
|
from openlp.core.ui.exceptionform import ExceptionForm
|
|
from openlp.core.ui import SplashScreen
|
|
from openlp.core.utils import LanguageManager, VersionThread, get_application_version
|
|
|
|
|
|
__all__ = ['OpenLP', 'main']
|
|
|
|
|
|
log = logging.getLogger()
|
|
|
|
WIN_REPAIR_STYLESHEET = """
|
|
QMainWindow::separator
|
|
{
|
|
border: none;
|
|
}
|
|
|
|
QDockWidget::title
|
|
{
|
|
border: 1px solid palette(dark);
|
|
padding-left: 5px;
|
|
padding-top: 2px;
|
|
margin: 1px 0;
|
|
}
|
|
|
|
QToolBar
|
|
{
|
|
border: none;
|
|
margin: 0;
|
|
padding: 0;
|
|
}
|
|
"""
|
|
|
|
|
|
class OpenLP(OpenLPMixin, QtGui.QApplication):
|
|
"""
|
|
The core application class. This class inherits from Qt's QApplication
|
|
class in order to provide the core of the application.
|
|
"""
|
|
|
|
args = []
|
|
|
|
def exec_(self):
|
|
"""
|
|
Override exec method to allow the shared memory to be released on exit
|
|
"""
|
|
self.is_event_loop_active = True
|
|
result = QtGui.QApplication.exec_()
|
|
self.shared_memory.detach()
|
|
return result
|
|
|
|
def run(self, args):
|
|
"""
|
|
Run the OpenLP application.
|
|
|
|
:param args: Some Args
|
|
"""
|
|
self.is_event_loop_active = False
|
|
# On Windows, the args passed into the constructor are ignored. Not very handy, so set the ones we want to use.
|
|
# On Linux and FreeBSD, in order to set the WM_CLASS property for X11, we pass "OpenLP" in as a command line
|
|
# argument. This interferes with files being passed in as command line arguments, so we remove it from the list.
|
|
if 'OpenLP' in args:
|
|
args.remove('OpenLP')
|
|
self.args.extend(args)
|
|
# Decide how many screens we have and their size
|
|
screens = ScreenList.create(self.desktop())
|
|
# First time checks in settings
|
|
has_run_wizard = Settings().value('core/has run wizard')
|
|
if not has_run_wizard:
|
|
ftw = FirstTimeForm()
|
|
ftw.initialize(screens)
|
|
if ftw.exec_() == QtGui.QDialog.Accepted:
|
|
Settings().setValue('core/has run wizard', True)
|
|
elif ftw.was_cancelled:
|
|
QtCore.QCoreApplication.exit()
|
|
sys.exit()
|
|
# Correct stylesheet bugs
|
|
application_stylesheet = ''
|
|
if not Settings().value('advanced/alternate rows'):
|
|
base_color = self.palette().color(QtGui.QPalette.Active, QtGui.QPalette.Base)
|
|
alternate_rows_repair_stylesheet = \
|
|
'QTableWidget, QListWidget, QTreeWidget {alternate-background-color: ' + base_color.name() + ';}\n'
|
|
application_stylesheet += alternate_rows_repair_stylesheet
|
|
if is_win():
|
|
application_stylesheet += WIN_REPAIR_STYLESHEET
|
|
if application_stylesheet:
|
|
self.setStyleSheet(application_stylesheet)
|
|
show_splash = Settings().value('core/show splash')
|
|
if show_splash:
|
|
self.splash = SplashScreen()
|
|
self.splash.show()
|
|
# make sure Qt really display the splash screen
|
|
self.processEvents()
|
|
# Check if OpenLP has been upgrade and if a backup of data should be created
|
|
self.backup_on_upgrade(has_run_wizard)
|
|
# start the main app window
|
|
self.main_window = MainWindow()
|
|
Registry().execute('bootstrap_initialise')
|
|
Registry().execute('bootstrap_post_set_up')
|
|
Registry().initialise = False
|
|
self.main_window.show()
|
|
if show_splash:
|
|
# now kill the splashscreen
|
|
self.splash.finish(self.main_window)
|
|
log.debug('Splashscreen closed')
|
|
# make sure Qt really display the splash screen
|
|
self.processEvents()
|
|
self.main_window.repaint()
|
|
self.processEvents()
|
|
if not has_run_wizard:
|
|
self.main_window.first_time()
|
|
update_check = Settings().value('core/update check')
|
|
if update_check:
|
|
version = VersionThread(self.main_window)
|
|
version.start()
|
|
self.main_window.is_display_blank()
|
|
self.main_window.app_startup()
|
|
return self.exec_()
|
|
|
|
def is_already_running(self):
|
|
"""
|
|
Look to see if OpenLP is already running and ask if a 2nd instance is to be started.
|
|
"""
|
|
self.shared_memory = QtCore.QSharedMemory('OpenLP')
|
|
if self.shared_memory.attach():
|
|
status = QtGui.QMessageBox.critical(None, UiStrings().Error, UiStrings().OpenLPStart,
|
|
QtGui.QMessageBox.StandardButtons(QtGui.QMessageBox.Yes |
|
|
QtGui.QMessageBox.No))
|
|
if status == QtGui.QMessageBox.No:
|
|
return True
|
|
return False
|
|
else:
|
|
self.shared_memory.create(1)
|
|
return False
|
|
|
|
def hook_exception(self, exc_type, value, traceback):
|
|
"""
|
|
Add an exception hook so that any uncaught exceptions are displayed in this window rather than somewhere where
|
|
users cannot see it and cannot report when we encounter these problems.
|
|
|
|
:param exc_type: The class of exception.
|
|
:param value: The actual exception object.
|
|
:param traceback: A traceback object with the details of where the exception occurred.
|
|
"""
|
|
# We can't log.exception here because the last exception no longer exists, we're actually busy handling it.
|
|
log.critical(''.join(format_exception(exc_type, value, traceback)))
|
|
if not hasattr(self, 'exception_form'):
|
|
self.exception_form = ExceptionForm()
|
|
self.exception_form.exception_text_edit.setPlainText(''.join(format_exception(exc_type, value, traceback)))
|
|
self.set_normal_cursor()
|
|
self.exception_form.exec_()
|
|
|
|
def backup_on_upgrade(self, has_run_wizard):
|
|
"""
|
|
Check if OpenLP has been upgraded, and ask if a backup of data should be made
|
|
|
|
:param has_run_wizard: OpenLP has been run before
|
|
"""
|
|
data_version = Settings().value('core/application version')
|
|
openlp_version = get_application_version()['version']
|
|
# New installation, no need to create backup
|
|
if not has_run_wizard:
|
|
Settings().setValue('core/application version', openlp_version)
|
|
# If data_version is different from the current version ask if we should backup the data folder
|
|
elif data_version != openlp_version:
|
|
if QtGui.QMessageBox.question(None, translate('OpenLP', 'Backup'),
|
|
translate('OpenLP', 'OpenLP has been upgraded, '
|
|
'do you want to create a backup of OpenLPs data folder?'),
|
|
QtGui.QMessageBox.Yes | QtGui.QMessageBox.No,
|
|
QtGui.QMessageBox.Yes) == QtGui.QMessageBox.Yes:
|
|
# Create copy of data folder
|
|
data_folder_path = AppLocation.get_data_path()
|
|
timestamp = time.strftime("%Y%m%d-%H%M%S")
|
|
data_folder_backup_path = data_folder_path + '-' + timestamp
|
|
try:
|
|
shutil.copytree(data_folder_path, data_folder_backup_path)
|
|
except OSError:
|
|
QtGui.QMessageBox.warning(None, translate('OpenLP', 'Backup'),
|
|
translate('OpenLP', 'Backup of the data folder failed!'))
|
|
return
|
|
QtGui.QMessageBox.information(None, translate('OpenLP', 'Backup'),
|
|
translate('OpenLP', 'A backup of the data folder has been created at %s')
|
|
% data_folder_backup_path)
|
|
# Update the version in the settings
|
|
Settings().setValue('core/application version', openlp_version)
|
|
|
|
def process_events(self):
|
|
"""
|
|
Wrapper to make ProcessEvents visible and named correctly
|
|
"""
|
|
self.processEvents()
|
|
|
|
def set_busy_cursor(self):
|
|
"""
|
|
Sets the Busy Cursor for the Application
|
|
"""
|
|
self.setOverrideCursor(QtCore.Qt.BusyCursor)
|
|
self.processEvents()
|
|
|
|
def set_normal_cursor(self):
|
|
"""
|
|
Sets the Normal Cursor for the Application
|
|
"""
|
|
self.restoreOverrideCursor()
|
|
self.processEvents()
|
|
|
|
def event(self, event):
|
|
"""
|
|
Enables platform specific event handling i.e. direct file opening on OS X
|
|
|
|
:param event: The event
|
|
"""
|
|
if event.type() == QtCore.QEvent.FileOpen:
|
|
file_name = event.file()
|
|
log.debug('Got open file event for %s!', file_name)
|
|
self.args.insert(0, file_name)
|
|
return True
|
|
# Mac OS X should restore app window when user clicked on the OpenLP icon
|
|
# in the Dock bar. However, OpenLP consists of multiple windows and this
|
|
# does not work. This workaround fixes that.
|
|
# The main OpenLP window is restored when it was previously minimized.
|
|
elif event.type() == QtCore.QEvent.ApplicationActivate:
|
|
if is_macosx() and hasattr(self, 'main_window'):
|
|
if self.main_window.isMinimized():
|
|
# Copied from QWidget.setWindowState() docs on how to restore and activate a minimized window
|
|
# while preserving its maximized and/or full-screen state.
|
|
self.main_window.setWindowState(self.main_window.windowState() & ~QtCore.Qt.WindowMinimized |
|
|
QtCore.Qt.WindowActive)
|
|
return True
|
|
return QtGui.QApplication.event(self, event)
|
|
|
|
|
|
def parse_options(args):
|
|
"""
|
|
Parse the command line arguments
|
|
|
|
:param args: list of command line arguments
|
|
:return: a tuple of parsed options of type optparse.Value and a list of remaining argsZ
|
|
"""
|
|
# Set up command line options.
|
|
usage = 'Usage: %prog [options] [qt-options]'
|
|
parser = OptionParser(usage=usage)
|
|
parser.add_option('-e', '--no-error-form', dest='no_error_form', action='store_true',
|
|
help='Disable the error notification form.')
|
|
parser.add_option('-l', '--log-level', dest='loglevel', default='warning', metavar='LEVEL',
|
|
help='Set logging to LEVEL level. Valid values are "debug", "info", "warning".')
|
|
parser.add_option('-p', '--portable', dest='portable', action='store_true',
|
|
help='Specify if this should be run as a portable app, off a USB flash drive (not implemented).')
|
|
parser.add_option('-d', '--dev-version', dest='dev_version', action='store_true',
|
|
help='Ignore the version file and pull the version directly from Bazaar')
|
|
parser.add_option('-s', '--style', dest='style', help='Set the Qt4 style (passed directly to Qt4).')
|
|
# Parse command line options and deal with them. Use args supplied pragmatically if possible.
|
|
return parser.parse_args(args) if args else parser.parse_args()
|
|
|
|
|
|
def set_up_logging(log_path):
|
|
"""
|
|
Setup our logging using log_path
|
|
|
|
:param log_path: the path
|
|
"""
|
|
check_directory_exists(log_path, True)
|
|
filename = os.path.join(log_path, 'openlp.log')
|
|
logfile = logging.FileHandler(filename, 'w', encoding="UTF-8")
|
|
logfile.setFormatter(logging.Formatter('%(asctime)s %(name)-55s %(levelname)-8s %(message)s'))
|
|
log.addHandler(logfile)
|
|
if log.isEnabledFor(logging.DEBUG):
|
|
print('Logging to: %s' % filename)
|
|
|
|
|
|
def main(args=None):
|
|
"""
|
|
The main function which parses command line options and then runs
|
|
|
|
:param args: Some args
|
|
"""
|
|
(options, args) = parse_options(args)
|
|
qt_args = []
|
|
if options.loglevel.lower() in ['d', 'debug']:
|
|
log.setLevel(logging.DEBUG)
|
|
elif options.loglevel.lower() in ['w', 'warning']:
|
|
log.setLevel(logging.WARNING)
|
|
else:
|
|
log.setLevel(logging.INFO)
|
|
if options.style:
|
|
qt_args.extend(['-style', options.style])
|
|
# Throw the rest of the arguments at Qt, just in case.
|
|
qt_args.extend(args)
|
|
# Bug #1018855: Set the WM_CLASS property in X11
|
|
if not is_win() and not is_macosx():
|
|
qt_args.append('OpenLP')
|
|
# Initialise the resources
|
|
qInitResources()
|
|
# Now create and actually run the application.
|
|
application = OpenLP(qt_args)
|
|
application.setOrganizationName('OpenLP')
|
|
application.setOrganizationDomain('openlp.org')
|
|
if options.portable:
|
|
application.setApplicationName('OpenLPPortable')
|
|
Settings.setDefaultFormat(Settings.IniFormat)
|
|
# Get location OpenLPPortable.ini
|
|
application_path = AppLocation.get_directory(AppLocation.AppDir)
|
|
set_up_logging(os.path.abspath(os.path.join(application_path, '..', '..', 'Other')))
|
|
log.info('Running portable')
|
|
portable_settings_file = os.path.abspath(os.path.join(application_path, '..', '..', 'Data', 'OpenLP.ini'))
|
|
# Make this our settings file
|
|
log.info('INI file: %s', portable_settings_file)
|
|
Settings.set_filename(portable_settings_file)
|
|
portable_settings = Settings()
|
|
# Set our data path
|
|
data_path = os.path.abspath(os.path.join(application_path, '..', '..', 'Data',))
|
|
log.info('Data path: %s', data_path)
|
|
# Point to our data path
|
|
portable_settings.setValue('advanced/data path', data_path)
|
|
portable_settings.setValue('advanced/is portable', True)
|
|
portable_settings.sync()
|
|
else:
|
|
application.setApplicationName('OpenLP')
|
|
set_up_logging(AppLocation.get_directory(AppLocation.CacheDir))
|
|
Registry.create()
|
|
Registry().register('application', application)
|
|
application.setApplicationVersion(get_application_version()['version'])
|
|
# Instance check
|
|
if application.is_already_running():
|
|
sys.exit()
|
|
# Remove/convert obsolete settings.
|
|
Settings().remove_obsolete_settings()
|
|
# First time checks in settings
|
|
if not Settings().value('core/has run wizard'):
|
|
if not FirstTimeLanguageForm().exec_():
|
|
# if cancel then stop processing
|
|
sys.exit()
|
|
# i18n Set Language
|
|
language = LanguageManager.get_language()
|
|
application_translator, default_translator = LanguageManager.get_translator(language)
|
|
if not application_translator.isEmpty():
|
|
application.installTranslator(application_translator)
|
|
if not default_translator.isEmpty():
|
|
application.installTranslator(default_translator)
|
|
else:
|
|
log.debug('Could not find default_translator.')
|
|
if not options.no_error_form:
|
|
sys.excepthook = application.hook_exception
|
|
sys.exit(application.run(qt_args))
|