Add comment for each method and class

[bertos.git] / wizard / BCpuPage.py

diff --git a/wizard/BCpuPage.py b/wizard/BCpuPage.py
index 05657337d6c0004f7b535c2684dbc3a3f7d7e102..702248a8e02c67c3175d1b8f0bc61b1139478e66 100644 (file)
--- a/wizard/BCpuPage.py
+++ b/wizard/BCpuPage.py
@@ -12,53 +12,92 @@
 
 from BWizardPage import *
 import bertos_utils
+import qvariant_converter
+
+from const import *
 
 class BCpuPage(BWizardPage):
+    """
+    Page of the wizard that permits to choose the cpu from the supported ones.
+    """
     
     def __init__(self):
-        BWizardPage.__init__(self, "cpu_select.ui")
+        BWizardPage.__init__(self, UI_LOCATION + "/cpu_select.ui")
         self.setTitle(self.tr("Select the CPU"))
         self._connectSignals()
         self._setupUi()
     
     def _populateCpuList(self):
+        """
+        Fills the cpu list.
+        """
         self.pageContent.cpuList.clear()
-        infos = bertos_utils.loadCpuInfos(self._projectInfoRetrieve("SOURCES_PATH"))
+        self.pageContent.cpuList.setCurrentItem(None)
+        infos = bertos_utils.loadCpuInfos(self._project())
         for cpu in infos:
             item = QListWidgetItem(cpu["CPU_NAME"])
-            # The CPU_DESC field in the cpu definition is a list of string, so we need to 
-            # store it as a QStringList in a QVariant
-            item.setData(Qt.UserRole, QVariant(QStringList(cpu["CPU_DESC"])))
+            item.setData(Qt.UserRole, qvariant_converter.convertDict(cpu))
             self.pageContent.cpuList.addItem(item)
     
     def _connectSignals(self):
+        """
+        Connects the signals with the related slots.
+        """
         self.connect(self.pageContent.cpuList, SIGNAL("itemSelectionChanged()"), self.rowChanged)
     
     def _selectItem(self, cpu):
+        """
+        Selects the given cpu from the list.
+        """
         elements = self.pageContent.cpuList.findItems(cpu, Qt.MatchCaseSensitive)
         if len(elements) == 1:
             self.pageContent.cpuList.setCurrentItem(elements[0])
     
     def _setupUi(self):
+        """
+        Sets up the user interface.
+        """
+        self.pageContent.cpuList.setSortingEnabled(True)
         self.pageContent.descriptionLabel.setVisible(False)
+        self.pageContent.descriptionLabel.setText("")
     
     def reloadData(self):
+        """
+        Overload of the BWizardPage reloadData method.
+        """
+        QApplication.instance().setOverrideCursor(Qt.WaitCursor)
+        bertos_utils.loadSourceTree(self._project())
         self._populateCpuList()
-        cpuName = self._projectInfoRetrieve("CPU_NAME")
-        if not cpuName is None:
-            self._selectItem(cpuName)
+        cpu_name = self._projectInfoRetrieve("CPU_NAME")
+        self._setupUi()
+        if not cpu_name is None:
+            self._selectItem(cpu_name)
+        QApplication.instance().restoreOverrideCursor()
+        self.emit(SIGNAL("completeChanged()"))
     
     def isComplete(self):
+        """
+        Overload of the QWizardPage isComplete method.
+        """
         if self.pageContent.cpuList.currentRow() != -1:
-            self._projectInfoStore("CPU_NAME", self.pageContent.cpuList.currentItem().text())
+            infos = qvariant_converter.getDict(self.pageContent.cpuList.currentItem().data(Qt.UserRole))
+            for key, value in infos.items():
+                if type(CPU_DEF[key]) == list:
+                    infos[key] = qvariant_converter.getStringList(value)
+                if type(CPU_DEF[key]) == str or type(CPU_DEF) == unicode:
+                    infos[key] = qvariant_converter.getString(value)
+            self._projectInfoStore("CPU_INFOS", infos)
+            self._projectInfoStore("CPU_NAME", unicode(self.pageContent.cpuList.currentItem().text()))
             return True
         else:
             return False
         
     def rowChanged(self):
-        description = self.pageContent.cpuList.currentItem().data(Qt.UserRole).toStringList()
-        # We need to convert the list of QString in a list of unicode
-        description =  [unicode(line) for line in description]
+        """
+        Slot called when the user select an entry from the cpu list.
+        """
+        description = qvariant_converter.getDict(self.pageContent.cpuList.currentItem().data(Qt.UserRole))["CPU_DESC"]
+        description = qvariant_converter.getStringList(description)
         self.pageContent.descriptionLabel.setText("<br>".join(description))
         self.pageContent.descriptionLabel.setVisible(True)
         self.emit(SIGNAL("completeChanged()"))