From: duplo <duplo@38d2e660-2303-0410-9eaa-f027e97ec537>
Date: Wed, 21 Jan 2009 09:21:17 +0000 (+0000)
Subject: Add commento for the module info retrieve and format functions
X-Git-Tag: 2.1.0~492
X-Git-Url: https://codewiz.org/gitweb?a=commitdiff_plain;ds=inline;h=0670557698b1a21af4415c4f1e539e57e6c3921c;p=bertos.git

Add commento for the module info retrieve and format functions

git-svn-id: https://src.develer.com/svnoss/bertos/trunk@2190 38d2e660-2303-0410-9eaa-f027e97ec537
---

diff --git a/wizard/bertos_utils.py b/wizard/bertos_utils.py
index de259710..5c6bf3c1 100644
--- a/wizard/bertos_utils.py
+++ b/wizard/bertos_utils.py
@@ -95,6 +95,9 @@ def getInfos(definition):
     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:
@@ -104,10 +107,18 @@ def getDefinitionBlocks(text):
     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 loadModuleInfos(path):
+    """
+    Return the module configurations found in the given path as a dict with the name as key
+    and a list of tuple as value. The tuple have the format (name, value, description).
+    """
     moduleInfos = {}
     for definition in findDefinitions(const.MODULE_CONFIGURATION, path):
         moduleName = definition[0].replace("cfg_", "").replace(".h", "")