Fix doxygen documentation.
[bertos.git] / 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     @property
89     def project(self):
90         """
91         Returns the BProject instance.
92         """
93         return QApplication.instance().project
94     
95     ####
96     
97     ## QSettings interaction methods ##
98
99     def settingsStore(self, key, value):
100         """
101         Stores the given value in the QSettings associated with the given key.
102         """
103         QApplication.instance().settings.setValue(QString(key), value)
104     
105     def settingsRetrieve(self, key):
106         """
107         Retrieves the value associated to key in the QSettings. Note that this
108         Value is a QVariant and neet to be converted in a standard type.
109         """
110         return QApplication.instance().settings.value(QString(key), QVariant())
111
112     def plugins(self):
113         """
114         Returns the list of actived plugins.
115         """
116         return qvariant_converter.getStringList(self.settingsRetrieve("plugins"))
117
118     def setPlugins(self, plugins):
119         """
120         Stores the given list of actived plugins.
121         """
122         self.settingsStore("plugins", qvariant_converter.convertStringList(plugins))
123     
124     def versions(self):
125         """
126         Returns the version list from the QSettings.
127         """
128         return qvariant_converter.getStringList(self.settingsRetrieve("versions"))
129     
130     def setVersions(self, versions):
131         """
132         Stores the given versions in the QSettings.
133         """
134         self.settingsStore("versions", qvariant_converter.convertStringList(versions))
135         
136     def searchDirList(self):
137         """
138         Returns the search dir list from the QSettings.
139         """
140         return qvariant_converter.getStringList(self.settingsRetrieve("search_dir_list"))
141     
142     def setSearchDirList(self, search_dir_list):
143         """
144         Stores the search dir list in the QSettings.
145         """
146         self.settingsStore("search_dir_list", qvariant_converter.convertStringList(search_dir_list))
147     
148     def pathSearch(self):
149         """
150         Returns the value of path search from the QSettings.
151         """
152         return qvariant_converter.getBool(self.settingsRetrieve("path_search"))
153     
154     def setPathSearch(self, path_search):
155         """
156         Stores the path search value in the QSettings.
157         """
158         self.settingsStore("path_search", qvariant_converter.convertBool(path_search))
159     
160     def toolchains(self):
161         """
162         Returns the toolchains stored in the QSettings.
163         """
164         return qvariant_converter.getBoolDict(self.settingsRetrieve("toolchains"))
165
166     def setToolchains(self, toolchains):
167         """
168         Stores the toolchains in the QSettings.
169         """
170         self.settingsStore("toolchains", qvariant_converter.convertBoolDict(toolchains))
171     
172     def defaultFolder(self):
173         """
174         Returns the default save folder stored in the QSettings.
175         """
176         return qvariant_converter.getString(self.settingsRetrieve("folder"))
177     
178     def setDefaultFolder(self, folder):
179         """
180         Stores the default save folder in the QSettings.
181         """
182         self.settingsStore("folder", qvariant_converter.convertString(folder))
183
184     ####
185     
186     ## Methodo to be implemented in child classes when needed ##
187     
188     def reloadData(self, previous_id=None):
189         """
190         Method called before the page is loaded. The pages that need to use this
191         method have to implement it.
192         """
193         pass
194     
195     def setupUi(self):
196         """
197         Method called automatically during the initialization of the wizard page.
198         It set up the interface. Pages that need to use this method have to
199         implement it.
200         """
201         pass
202     
203     def connectSignals(self):
204         """
205         Method called automatically during the initialization of the wizard page.
206         It connects the signals and the slots. The pages that need to use this
207         method have to implement it.
208         """
209         pass
210     
211     ####