Source code for umbra.preferences

#!/usr/bin/env python
# -*- coding: utf-8 -*-

"""
**preferences.py**

**Platform:**
	Windows, Linux, Mac Os X.

**Description:**
	| This module is the main **Umbra** package module.
	| It defines various classes, methods and definitions to run, maintain and exit the Application.
	| The main Application object is the :class:`Umbra` class.

**Others:**

"""

#**********************************************************************************************************************
#***	Future imports.
#**********************************************************************************************************************
from __future__ import unicode_literals

#**********************************************************************************************************************
#***	External imports.
#**********************************************************************************************************************
import os
from PyQt4.QtCore import QSettings
from PyQt4.QtCore import QVariant

#**********************************************************************************************************************
#***	Internal imports.
#**********************************************************************************************************************
import foundations.exceptions
import foundations.verbose
import umbra.ui.common
from umbra.globals.uiConstants import UiConstants

#**********************************************************************************************************************
#***	Module attributes.
#**********************************************************************************************************************
__author__ = "Thomas Mansencal"
__copyright__ = "Copyright (C) 2008 - 2013 - Thomas Mansencal"
__license__ = "GPL V3.0 - http://www.gnu.org/licenses/"
__maintainer__ = "Thomas Mansencal"
__email__ = "thomas.mansencal@gmail.com"
__status__ = "Production"

__all__ = ["LOGGER", "Preferences"]

LOGGER = foundations.verbose.installLogger()

#**********************************************************************************************************************
#***	Module classes and definitions.
#**********************************************************************************************************************
[docs]class Preferences(object): """ | This class provides methods to manipulate Application preferences / settings. | Those are stored and retrieved using a `QSettings <http://doc.qt.nokia.com/qsettings.html>`_ class. """ def __init__(self, file=None): """ .. Sphinx: Statements updated for auto-documentation purpose. :param file: Current preferences file path. ( String ) """ LOGGER.debug("> Initializing '{0}()' class.".format(self.__class__.__name__)) # --- Setting class attributes. --- self.__file = None self.file = file self.__settings = QSettings(self.__file, QSettings.IniFormat) if self.__file is not None else QSettings() self.__defaultSettings = None self.__defaultLayoutsSettings = None # --- Initializing preferences. --- self.__getDefaultSettings() self.__getDefaultLayoutsSettings() #****************************************************************************************************************** #*** Attributes properties. #****************************************************************************************************************** @property def file(self): """ This method is the property for **self.__file** attribute. :return: self.__file. ( String ) """ return self.__file @file.setter #*** Sphinx: Decorator commented for auto-documentation purpose. @foundations.exceptions.handleExceptions(AssertionError) def file(self, value): """ This method is the setter method for **self.__file** attribute. :param value: Attribute value. ( String ) """ if value is not None: assert type(value) is unicode, "'{0}' attribute: '{1}' type is not 'unicode'!".format( "file", value) self.__file = value @file.deleter #*** Sphinx: Decorator commented for auto-documentation purpose. @foundations.exceptions.handleExceptions(foundations.exceptions.ProgrammingError)
[docs] def file(self): """ This method is the deleter method for **self.__file** attribute. """ raise foundations.exceptions.ProgrammingError( "{0} | '{1}' attribute is not deletable!".format(self.__class__.__name__, "file"))
@property def settings(self): """ This method is the property for **self.__settings** attribute. :return: self.__settings. ( QSettings ) """ return self.__settings @settings.setter #*** Sphinx: Decorator commented for auto-documentation purpose. @foundations.exceptions.handleExceptions(foundations.exceptions.ProgrammingError) def settings(self, value): """ This method is the setter method for **self.__settings** attribute. :param value: Attribute value. ( QSettings ) """ raise foundations.exceptions.ProgrammingError( "{0} | '{1}' attribute is read only!".format(self.__class__.__name__, "settings")) @settings.deleter #*** Sphinx: Decorator commented for auto-documentation purpose. @foundations.exceptions.handleExceptions(foundations.exceptions.ProgrammingError)
[docs] def settings(self): """ This method is the deleter method for **self.__settings** attribute. """ raise foundations.exceptions.ProgrammingError( "{0} | '{1}' attribute is not deletable!".format(self.__class__.__name__, "settings"))
@property def defaultSettings(self): """ This method is the property for **self.__defaultSettings** attribute. :return: self.__defaultSettings. ( QSettings ) """ return self.__defaultSettings @defaultSettings.setter #*** Sphinx: Decorator commented for auto-documentation purpose. @foundations.exceptions.handleExceptions(foundations.exceptions.ProgrammingError) def defaultSettings(self, value): """ This method is the setter method for **self.__defaultSettings** attribute. :param value: Attribute value. ( QSettings ) """ raise foundations.exceptions.ProgrammingError( "{0} | '{1}' attribute is read only!".format(self.__class__.__name__, "defaultSettings")) @defaultSettings.deleter #*** Sphinx: Decorator commented for auto-documentation purpose. @foundations.exceptions.handleExceptions(foundations.exceptions.ProgrammingError)
[docs] def defaultSettings(self): """ This method is the deleter method for **self.__defaultSettings** attribute. """ raise foundations.exceptions.ProgrammingError( "{0} | '{1}' attribute is not deletable!".format(self.__class__.__name__, "defaultSettings"))
@property def defaultLayoutsSettings(self): """ This method is the property for **self.__defaultLayoutsSettings** attribute. :return: self.__defaultLayoutsSettings. ( QSettings ) """ return self.__defaultLayoutsSettings @defaultLayoutsSettings.setter #*** Sphinx: Decorator commented for auto-documentation purpose. @foundations.exceptions.handleExceptions(foundations.exceptions.ProgrammingError) def defaultLayoutsSettings(self, value): """ This method is the setter method for **self.__defaultLayoutsSettings** attribute. :param value: Attribute value. ( QSettings ) """ raise foundations.exceptions.ProgrammingError( "{0} | '{1}' attribute is read only!".format(self.__class__.__name__, "defaultLayoutsSettings")) @defaultLayoutsSettings.deleter #*** Sphinx: Decorator commented for auto-documentation purpose. @foundations.exceptions.handleExceptions(foundations.exceptions.ProgrammingError)
[docs] def defaultLayoutsSettings(self): """ This method is the deleter method for **self.__defaultLayoutsSettings** attribute. """ raise foundations.exceptions.ProgrammingError( "{0} | '{1}' attribute is not deletable!".format(self.__class__.__name__, "defaultLayoutsSettings")) #****************************************************************************************************************** #*** Class methods. #******************************************************************************************************************
[docs] def setKey(self, section, key, value): """ This method stores given key in settings file. :param section: Current section to save the key into. ( String ) :param key: Current key to save. ( String ) :param value: Current key value to save. ( Object ) """ LOGGER.debug("> Saving '{0}' in '{1}' section with value: '{2}' in settings file.".format( key, section, foundations.strings.toString(value))) self.__settings.beginGroup(section) self.__settings.setValue(key , QVariant(value)) self.__settings.endGroup()
[docs] def getKey(self, section, key): """ This method gets key value from settings file. :param section: Current section to retrieve key from. ( String ) :param key: Current key to retrieve. ( String ) :return: Current key value. ( Object ) """ LOGGER.debug("> Retrieving '{0}' in '{1}' section.".format(key, section)) self.__settings.beginGroup(section) value = self.__settings.value(key) LOGGER.debug("> Key value: '{0}'.".format(value)) self.__settings.endGroup() return value
def __getDefaultSettings(self): """ This method gets the default settings. """ LOGGER.debug("> Accessing '{0}' default settings file!".format(UiConstants.settingsFile)) self.__defaultSettings = QSettings(umbra.ui.common.getResourcePath(UiConstants.settingsFile), QSettings.IniFormat) def __getDefaultLayoutsSettings(self): """ This method gets the default layouts settings. """ LOGGER.debug("> Accessing '{0}' default layouts settings file!".format(UiConstants.layoutsFile)) self.__defaultLayoutsSettings = QSettings(umbra.ui.common.getResourcePath(UiConstants.layoutsFile), QSettings.IniFormat)
[docs] def setDefaultPreferences(self): """ This method defines the default settings file content. :return: Method success. ( Boolean ) """ LOGGER.debug("> Initializing default settings!") for key in self.__defaultSettings.allKeys(): self.__settings.setValue(key, self.__defaultSettings.value(key)) self.setDefaultLayouts() return True
[docs] def setDefaultLayouts(self, ignoredLayouts=None): """ This method sets the default layouts in the preferences file. :param ignoredLayouts: Ignored layouts. ( Tuple / List ) :return: Method success. ( Boolean ) """ for key in self.__defaultLayoutsSettings.allKeys(): if ignoredLayouts: if tuple((layout for layout in ignoredLayouts if layout in key)): continue self.__settings.setValue(key, self.__defaultLayoutsSettings.value(key)) return True