wizard/BWizardPage.py

   1 #!/usr/bin/env python
   2 # encoding: utf-8
   3 #
   4 # This file is part of BeRTOS.
   5 #
   6 # Bertos is free software; you can redistribute it and/or modify
   7 # it under the terms of the GNU General Public License as published by
   8 # the Free Software Foundation; either version 2 of the License, or
   9 # (at your option) any later version.
  10 #
  11 # This program is distributed in the hope that it will be useful,
  12 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 # GNU General Public License for more details.
  15 #
  16 # You should have received a copy of the GNU General Public License
  17 # along with this program; if not, write to the Free Software
  18 # Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  19 #
  20 # As a special exception, you may use this file as part of a free software
  21 # library without restriction.  Specifically, if other files instantiate
  22 # templates or use macros or inline functions from this file, or you compile
  23 # this file and link it with other files to produce an executable, this
  24 # file does not by itself cause the resulting executable to be covered by
  25 # the GNU General Public License.  This exception does not however
  26 # invalidate any other reasons why the executable file might be covered by
  27 # the GNU General Public License.
  28 #
  29 # Copyright 2008 Develer S.r.l. (http://www.develer.com/)
  30 #
  31 # $Id$
  32 #
  33 # Author: Lorenzo Berni <duplo@develer.com>
  34 #
  35
  36 import os
  37
  38 from PyQt4.QtCore import *
  39 from PyQt4.QtGui import *
  40 from PyQt4 import uic
  41
  42 import qvariant_converter
  43
  44 import const
  45
  46 class BWizardPage(QWizardPage):
  47     """
  48     Base class for all the wizard pages. It has the utility method used in all
  49     the pages. A wizard page class need to extend this class.
  50     """
  51
  52     def __init__(self, wizardGui, parent = None):
  53         QWizardPage.__init__(self, parent)
  54         self.pageContent = uic.loadUi(os.path.join(const.DATA_DIR, wizardGui), None)
  55         layout = QVBoxLayout()
  56         layout.addWidget(self.pageContent)
  57         self.setLayout(layout)
  58         self.setupUi()
  59         self.connectSignals()
  60
  61     def exceptionOccurred(self, message):
  62         """
  63         Simple message box showing method.
  64         """
  65         QMessageBox.critical(self, self.tr("Error occurred"), message, QMessageBox.Ok, QMessageBox.NoButton)
  66
  67     def showMessage(self, title, message):
  68         """
  69         Show an information message box with title and message.
  70         """
  71         QMessageBox.information(self, title, message)
  72
  73     ## BProject interaction methods ##
  74
  75     def setProjectInfo(self, key, value):
  76         """
  77         Stores the given value in the BProject class associating it with the given
  78         key.
  79         """
  80         QApplication.instance().project.setInfo(key, value)
  81
  82     def projectInfo(self, key):
  83         """
  84         Retrieves the information associated with the given key.
  85         """
  86         return QApplication.instance().project.info(key)
  87
  88     def project(self):
  89         """
  90         Returns the BProject instance.
  91         """
  92         return QApplication.instance().project
  93
  94     ####
  95
  96     ## QSettings interaction methods ##
  97
  98     def settingsStore(self, key, value):
  99         """
 100         Stores the given value in the QSettings associated with the given key.
 101         """
 102         QApplication.instance().settings.setValue(QString(key), value)
 103
 104     def settingsRetrieve(self, key):
 105         """
 106         Retrieves the value associated to key in the QSettings. Note that this
 107         Value is a QVariant and neet to be converted in a standard type.
 108         """
 109         return QApplication.instance().settings.value(QString(key), QVariant())
 110
 111     def versions(self):
 112         """
 113         Returns the version list from the QSettings.
 114         """
 115         return qvariant_converter.getStringList(self.settingsRetrieve("versions"))
 116
 117     def setVersions(self, versions):
 118         """
 119         Stores the given versions in the QSettings.
 120         """
 121         self.settingsStore("versions", qvariant_converter.convertStringList(versions))
 122
 123     def searchDirList(self):
 124         """
 125         Returns the search dir list from the QSettings.
 126         """
 127         return qvariant_converter.getStringList(self.settingsRetrieve("search_dir_list"))
 128
 129     def setSearchDirList(self, search_dir_list):
 130         """
 131         Stores the search dir list in the QSettings.
 132         """
 133         self.settingsStore("search_dir_list", qvariant_converter.convertStringList(search_dir_list))
 134
 135     def pathSearch(self):
 136         """
 137         Returns the value of path search from the QSettings.
 138         """
 139         return qvariant_converter.getBool(self.settingsRetrieve("path_search"))
 140
 141     def setPathSearch(self, path_search):
 142         """
 143         Stores the path search value in the QSettings.
 144         """
 145         self.settingsStore("path_search", qvariant_converter.convertBool(path_search))
 146
 147     def toolchains(self):
 148         """
 149         Returns the toolchains stored in the QSettings.
 150         """
 151         return qvariant_converter.getBoolDict(self.settingsRetrieve("toolchains"))
 152
 153     def setToolchains(self, toolchains):
 154         """
 155         Stores the toolchains in the QSettings.
 156         """
 157         self.settingsStore("toolchains", qvariant_converter.convertBoolDict(toolchains))
 158
 159     def defaultFolder(self):
 160         """
 161         Returns the default save folder stored in the QSettings.
 162         """
 163         return qvariant_converter.getString(self.settingsRetrieve("folder"))
 164
 165     def setDefaultFolder(self, folder):
 166         """
 167         Stores the default save folder in the QSettings.
 168         """
 169         self.settingsStore("folder", qvariant_converter.convertString(folder))
 170
 171     ####
 172
 173     ## Methodo to be implemented in child classes when needed ##
 174
 175     def reloadData(self):
 176         """
 177         Method called before the page is loaded. The pages that need to use this
 178         method have to implement it.
 179         """
 180         pass
 181
 182     def setupUi(self):
 183         """
 184         Method called automatically during the initialization of the wizard page.
 185         It set up the interface. Pages that need to use this method have to
 186         implement it.
 187         """
 188         pass
 189
 190     def connectSignals(self):
 191         """
 192         Method called automatically during the initialization of the wizard page.
 193         It connects the signals and the slots. The pages that need to use this
 194         method have to implement it.
 195         """
 196         pass
 197
 198     ####