#249 - Front-End Intermediate Code Enhancement

Verified code for all four modules `fe_ic...py`.
Still many bugs to fix.
Next step: inherit from `Utils.Trees` package modules.

src/FrontEnd/IntermediateCode/fe_icblock.py

@@ -38,7 +38,6 @@ def __init__(self) -> None:  ##, parent:FEICNode=None):
         Constructor.
         '''
         super().__init__( [] )  ## content is an empty list (of FEICNode-s)
-        ##self.parent = parent
 
     #-------------------------------------------------------------------------
     def __iadd__(self, ic_node: FEICNode):

src/FrontEnd/IntermediateCode/fe_icleaf.py

@@ -28,15 +28,15 @@
 #=============================================================================
 class FEICLeaf( FEICNode ):
     """
-    Class description.
+    Class of leaves in Intermediate Code trees.
     """    
     #-------------------------------------------------------------------------
     def __init__(self, content) -> None:
         '''
         Constructor.
         
         Args:
-            content: a reference to the content opf this leaf
+            content: a reference to the content of this leaf.
         '''
         super().__init__( content )
 
@@ -58,8 +58,8 @@ def __next__(self):
     #-------------------------------------------------------------------------
     def walk(self) -> FEICNode:
         '''
-        Walks through the list of nodes contained within this block.
-        Walk-through is depth-first implemented.
+        Walks over this leaf.
+
         Returns:
             A reference to the content of this leaf.
         '''

src/FrontEnd/IntermediateCode/fe_icnode.py

@@ -21,10 +21,6 @@
 SOFTWARE.
 """
 
-#=============================================================================
-#no imports
-
-
 #=============================================================================
 class FEICNode:
     """
@@ -44,7 +40,7 @@ def __init__(self, content=None) -> None:
         self.content = content
 
     #-------------------------------------------------------------------------
-    def set_parent(self, parent: FEICNode):
+    def set_parent(self, parent):
         '''
         Sets the parent of this node.
         '''

src/FrontEnd/IntermediateCode/fe_ictree.py

@@ -43,12 +43,15 @@ def __init__(self) -> None:
     #-------------------------------------------------------------------------
     def __iadd__(self, ic_node: (FEICBlock,FEICNode)):
         '''
-        Appends a new node into this block.
+        In-place appends a new block or node to this intermediate code tree.
+        
+        Returns a reference to this IC tree.
         '''
         ic_node.set_parent( self._current )
         self._current += ic_node
         if isinstance( ic_node, FEICBlock ):
             self._current = ic_node
+        return self
 
     #-------------------------------------------------------------------------
     def up_level(self) -> None:
@@ -60,7 +63,7 @@ def up_level(self) -> None:
     #-------------------------------------------------------------------------
     def walk(self) -> None:
         '''
-        Walks through this Intermediate Code tree.
+        Walks through this Intermediate Code tree, starting at its root.
         Walk-through is depth-first implemented.
         '''
         self._root.walk()