Add a function that strip the wizard informations from the comment, and return the...

[bertos.git] / wizard / bertos_utils.py

diff --git a/wizard/bertos_utils.py b/wizard/bertos_utils.py
index 2f755c38af8576c31dbc96c03d5b8032f6d1b0b8..e8033d7d8e564815a949781a5cc3a915c1a2e66b 100644 (file)
--- a/wizard/bertos_utils.py
+++ b/wizard/bertos_utils.py
@@ -41,7 +41,7 @@ def findToolchains(pathList):
         for toolchain in glob.glob(element+ "/" + const.GCC_NAME):
             if not os.path.islink(toolchain):
                 toolchains.append(toolchain)
-    return toolchains
+    return list(set(toolchains))
 
 def getToolchainInfo(output):
     info = {}
@@ -93,3 +93,55 @@ def getInfos(definition):
     D["DEFINITION_PATH"] = definition[1] + "/" + definition[0]
     del D["include"]
     return D
+
+def getDefinitionBlocks(text):
+    """
+    Take a text and return a list of tuple (description, name-value).
+    """
+    block = []
+    block_tmp = re.findall(r"/\*{2}\s*([^*]*\*(?:[^/*][^*]*\*+)*)/\s*#define\s+((?:[^/]*?/?)+)\s*?(?:/{2,3}[^<].*?)?$", text, re.MULTILINE)
+    for comment, define in block_tmp:
+        block.append((" ".join(re.findall(r"^\s*\*?\s*(.*?)\s*?(?:/{2}.*?)?$", comment, re.MULTILINE)).strip(), define))
+    block += re.findall(r"/{3}\s*([^<].*?)\s*#define\s+((?:[^/]*?/?)+)\s*?(?:/{2,3}[^<].*?)?$", text, re.MULTILINE)
+    block += [(comment, define) for define, comment in re.findall(r"#define\s*(.*?)\s*/{3}<\s*(.+?)\s*?(?:/{2,3}[^<].*?)?$", text, re.MULTILINE)]
+    return block
+
+def formatModuleNameValue(text):
+    """
+    Take the given string and return a tuple with the name of the parameter in the first position
+    and the value in the second.
+    """
+    block = re.findall("\s*([^\s]+)\s*(.+?)\s*$", text, re.MULTILINE)
+    return block[0]
+
+def getDescriptionInformations(text):
+    """
+    Take the doxygen comment and strip the wizard informations, returning the tuple
+    (comment, wizard_informations)
+    """
+    informations = {}
+    index = text.find("$WIZARD")
+    if index != -1:
+        exec(text[index + 1:])
+        informations.update(WIZARD)
+    return text[:index].strip(), informations
+        
+
+def loadModuleInfos(path):
+    """
+    Return the module configurations found in the given path as a dict with the name as key
+    and a dict as value. The value dict has the parameter name as key and has "value" and "description"
+    fields.
+    """
+    moduleInfos = {}
+    for definition in findDefinitions(const.MODULE_CONFIGURATION, path):
+        moduleName = definition[0].replace("cfg_", "").replace(".h", "")
+        moduleInfos[moduleName] = {}
+        for comment, define in getDefinitionBlocks(open(definition[1] + "/" + definition[0], "r").read()):
+            name, value = formatModuleNameValue(define)
+            description, informations = getDescriptionInformations(comment)
+            moduleInfos[moduleName][name] = {}
+            moduleInfos[moduleName][name]["value"] = value
+            moduleInfos[moduleName][name]["description"] = description
+            moduleInfos[moduleName][name]["informations"] = informations
+    return moduleInfos